@opentelemetry/instrumentation-fetch 0.222.0 → 0.300.0-development.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/README.md +9 -10
  2. package/dist/_virtual/_rolldown/runtime.cjs +23 -0
  3. package/dist/fetch.cjs +317 -0
  4. package/dist/fetch.cjs.map +1 -0
  5. package/dist/fetch.d.cts +120 -0
  6. package/dist/fetch.d.cts.map +1 -0
  7. package/dist/fetch.d.mts +120 -0
  8. package/dist/fetch.d.mts.map +1 -0
  9. package/dist/fetch.mjs +314 -0
  10. package/dist/fetch.mjs.map +1 -0
  11. package/dist/index.cjs +3 -0
  12. package/dist/index.d.cts +2 -0
  13. package/dist/index.d.mts +2 -0
  14. package/dist/index.mjs +2 -0
  15. package/dist/semconv.cjs +13 -0
  16. package/dist/semconv.cjs.map +1 -0
  17. package/dist/semconv.mjs +13 -0
  18. package/dist/semconv.mjs.map +1 -0
  19. package/dist/types.d.cts +12 -0
  20. package/dist/types.d.cts.map +1 -0
  21. package/dist/types.d.mts +12 -0
  22. package/dist/types.d.mts.map +1 -0
  23. package/dist/utils.cjs +157 -0
  24. package/dist/utils.cjs.map +1 -0
  25. package/dist/utils.mjs +154 -0
  26. package/dist/utils.mjs.map +1 -0
  27. package/dist/version.cjs +6 -0
  28. package/dist/version.cjs.map +1 -0
  29. package/dist/version.mjs +6 -0
  30. package/dist/version.mjs.map +1 -0
  31. package/package.json +34 -31
  32. package/build/esm/fetch.d.ts +0 -118
  33. package/build/esm/fetch.js +0 -412
  34. package/build/esm/fetch.js.map +0 -1
  35. package/build/esm/index.d.ts +0 -3
  36. package/build/esm/index.js +0 -6
  37. package/build/esm/index.js.map +0 -1
  38. package/build/esm/semconv.d.ts +0 -9
  39. package/build/esm/semconv.js +0 -18
  40. package/build/esm/semconv.js.map +0 -1
  41. package/build/esm/types.d.ts +0 -27
  42. package/build/esm/types.js +0 -6
  43. package/build/esm/types.js.map +0 -1
  44. package/build/esm/utils.d.ts +0 -43
  45. package/build/esm/utils.js +0 -205
  46. package/build/esm/utils.js.map +0 -1
  47. package/build/esm/version.d.ts +0 -2
  48. package/build/esm/version.js +0 -7
  49. package/build/esm/version.js.map +0 -1
  50. package/build/esnext/fetch.d.ts +0 -118
  51. package/build/esnext/fetch.js +0 -412
  52. package/build/esnext/fetch.js.map +0 -1
  53. package/build/esnext/index.d.ts +0 -3
  54. package/build/esnext/index.js +0 -6
  55. package/build/esnext/index.js.map +0 -1
  56. package/build/esnext/semconv.d.ts +0 -9
  57. package/build/esnext/semconv.js +0 -18
  58. package/build/esnext/semconv.js.map +0 -1
  59. package/build/esnext/types.d.ts +0 -27
  60. package/build/esnext/types.js +0 -6
  61. package/build/esnext/types.js.map +0 -1
  62. package/build/esnext/utils.d.ts +0 -43
  63. package/build/esnext/utils.js +0 -205
  64. package/build/esnext/utils.js.map +0 -1
  65. package/build/esnext/version.d.ts +0 -2
  66. package/build/esnext/version.js +0 -7
  67. package/build/esnext/version.js.map +0 -1
  68. package/build/src/fetch.d.ts +0 -118
  69. package/build/src/fetch.js +0 -416
  70. package/build/src/fetch.js.map +0 -1
  71. package/build/src/index.d.ts +0 -3
  72. package/build/src/index.js +0 -10
  73. package/build/src/index.js.map +0 -1
  74. package/build/src/semconv.d.ts +0 -9
  75. package/build/src/semconv.js +0 -21
  76. package/build/src/semconv.js.map +0 -1
  77. package/build/src/types.d.ts +0 -27
  78. package/build/src/types.js +0 -7
  79. package/build/src/types.js.map +0 -1
  80. package/build/src/utils.d.ts +0 -43
  81. package/build/src/utils.js +0 -212
  82. package/build/src/utils.js.map +0 -1
  83. package/build/src/version.d.ts +0 -2
  84. package/build/src/version.js +0 -10
  85. package/build/src/version.js.map +0 -1
package/README.md CHANGED
@@ -17,22 +17,22 @@ npm install --save @opentelemetry/instrumentation-fetch
17
17
  ## Usage
18
18
 
19
19
  ```js
20
+ import { context, trace } from '@opentelemetry/api';
20
21
  import {
21
22
  ConsoleSpanExporter,
22
23
  SimpleSpanProcessor,
23
- WebTracerProvider,
24
- } from '@opentelemetry/sdk-trace-web';
24
+ TracerProvider,
25
+ } from '@opentelemetry/sdk-trace';
25
26
  import { FetchInstrumentation } from '@opentelemetry/instrumentation-fetch';
26
27
  import { ZoneContextManager } from '@opentelemetry/context-zone';
27
28
  import { registerInstrumentations } from '@opentelemetry/instrumentation';
28
29
 
29
- const provider = new WebTracerProvider({
30
+ const provider = new TracerProvider({
30
31
  spanProcessors: [new SimpleSpanProcessor(new ConsoleSpanExporter())]
31
32
  });
32
33
 
33
- provider.register({
34
- contextManager: new ZoneContextManager(),
35
- });
34
+ context.setGlobalContextManager(new ZoneContextManager().enable());
35
+ trace.setGlobalTracerProvider(provider);
36
36
 
37
37
  registerInstrumentations({
38
38
  instrumentations: [new FetchInstrumentation()],
@@ -40,12 +40,11 @@ registerInstrumentations({
40
40
 
41
41
  // or plugin can be also initialised separately and then set the tracer provider or meter provider
42
42
  const fetchInstrumentation = new FetchInstrumentation();
43
- const provider = new WebTracerProvider({
43
+ const provider = new TracerProvider({
44
44
  spanProcessors: [new SimpleSpanProcessor(new ConsoleSpanExporter())]
45
45
  });
46
- provider.register({
47
- contextManager: new ZoneContextManager(),
48
- });
46
+ context.setGlobalContextManager(new ZoneContextManager().enable());
47
+ trace.setGlobalTracerProvider(provider);
49
48
  fetchInstrumentation.setTracerProvider(provider);
50
49
 
51
50
  // and some test
@@ -0,0 +1,23 @@
1
+ //#region \0rolldown/runtime.js
2
+ var __create = Object.create;
3
+ var __defProp = Object.defineProperty;
4
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
+ var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
7
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
8
+ var __copyProps = (to, from, except, desc) => {
9
+ if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
10
+ key = keys[i];
11
+ if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
12
+ get: ((k) => from[k]).bind(null, key),
13
+ enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
14
+ });
15
+ }
16
+ return to;
17
+ };
18
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
19
+ value: mod,
20
+ enumerable: true
21
+ }) : target, mod));
22
+ //#endregion
23
+ exports.__toESM = __toESM;
package/dist/fetch.cjs ADDED
@@ -0,0 +1,317 @@
1
+ const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
2
+ const require_semconv = require("./semconv.cjs");
3
+ const require_utils = require("./utils.cjs");
4
+ const require_version = require("./version.cjs");
5
+ let _opentelemetry_api = require("@opentelemetry/api");
6
+ let _opentelemetry_instrumentation = require("@opentelemetry/instrumentation");
7
+ let _opentelemetry_core = require("@opentelemetry/core");
8
+ _opentelemetry_core = require_runtime.__toESM(_opentelemetry_core);
9
+ let _opentelemetry_web_common = require("@opentelemetry/web-common");
10
+ _opentelemetry_web_common = require_runtime.__toESM(_opentelemetry_web_common);
11
+ let _opentelemetry_semantic_conventions = require("@opentelemetry/semantic-conventions");
12
+ //#region src/fetch.ts
13
+ const OBSERVER_WAIT_TIME_MS = 300;
14
+ const hasBrowserPerformanceAPI = typeof PerformanceObserver !== "undefined";
15
+ /**
16
+ * This class represents a fetch plugin for auto instrumentation
17
+ */
18
+ var FetchInstrumentation = class extends _opentelemetry_instrumentation.InstrumentationBase {
19
+ component = "fetch";
20
+ version = require_version.VERSION;
21
+ moduleName = this.component;
22
+ _usedResources = /* @__PURE__ */ new WeakSet();
23
+ _tasksCount = 0;
24
+ constructor(config = {}) {
25
+ super("@opentelemetry/instrumentation-fetch", require_version.VERSION, config);
26
+ }
27
+ init() {}
28
+ /**
29
+ * Add cors pre flight child span
30
+ * @param span
31
+ * @param corsPreFlightRequest
32
+ */
33
+ _addChildSpan(span, corsPreFlightRequest) {
34
+ const childSpan = this.tracer.startSpan("CORS Preflight", { startTime: corsPreFlightRequest[_opentelemetry_web_common.PerformanceTimingNames.FETCH_START] }, _opentelemetry_api.trace.setSpan(_opentelemetry_api.context.active(), span));
35
+ _opentelemetry_web_common.addSpanNetworkEvents(childSpan, corsPreFlightRequest, this.getConfig().ignoreNetworkEvents, void 0, true);
36
+ childSpan.end(corsPreFlightRequest[_opentelemetry_web_common.PerformanceTimingNames.RESPONSE_END]);
37
+ }
38
+ /**
39
+ * Adds more attributes to span just before ending it
40
+ * @param span
41
+ * @param response
42
+ */
43
+ _addFinalSpanAttributes(span, response) {
44
+ const parsedUrl = _opentelemetry_web_common.parseUrl(response.url);
45
+ span.setAttribute(_opentelemetry_semantic_conventions.ATTR_HTTP_RESPONSE_STATUS_CODE, response.status);
46
+ span.setAttribute(_opentelemetry_semantic_conventions.ATTR_SERVER_ADDRESS, parsedUrl.hostname);
47
+ const serverPort = require_utils.serverPortFromUrl(parsedUrl);
48
+ if (serverPort) span.setAttribute(_opentelemetry_semantic_conventions.ATTR_SERVER_PORT, serverPort);
49
+ }
50
+ /**
51
+ * Add headers
52
+ * @param options
53
+ * @param spanUrl
54
+ */
55
+ _addHeaders(options, spanUrl) {
56
+ if (!_opentelemetry_web_common.shouldPropagateTraceHeaders(spanUrl, this.getConfig().propagateTraceHeaderCorsUrls)) {
57
+ const headers = {};
58
+ _opentelemetry_api.propagation.inject(_opentelemetry_api.context.active(), headers);
59
+ if (Object.keys(headers).length > 0) this._diag.debug("headers inject skipped due to CORS policy");
60
+ return;
61
+ }
62
+ if (options instanceof Request) _opentelemetry_api.propagation.inject(_opentelemetry_api.context.active(), options.headers, { set: (h, k, v) => h.set(k, typeof v === "string" ? v : String(v)) });
63
+ else {
64
+ const headers = new Headers(options.headers);
65
+ _opentelemetry_api.propagation.inject(_opentelemetry_api.context.active(), headers, { set: (h, k, v) => h.set(k, typeof v === "string" ? v : String(v)) });
66
+ options.headers = headers;
67
+ }
68
+ }
69
+ /**
70
+ * Clears the resource timings and all resources assigned with spans
71
+ * when {@link FetchPluginConfig.clearTimingResources} is
72
+ * set to true (default false)
73
+ * @private
74
+ */
75
+ _clearResources() {
76
+ if (this._tasksCount === 0 && this.getConfig().clearTimingResources) {
77
+ performance.clearResourceTimings();
78
+ this._usedResources = /* @__PURE__ */ new WeakSet();
79
+ }
80
+ }
81
+ /**
82
+ * Creates a new span
83
+ * @param url
84
+ * @param options
85
+ */
86
+ _createSpan(url, options = {}) {
87
+ if (_opentelemetry_core.isUrlIgnored(url, this.getConfig().ignoreUrls)) {
88
+ this._diag.debug("ignoring span as url matches ignored url");
89
+ return;
90
+ }
91
+ const attributes = {};
92
+ const origMethod = options.method;
93
+ const normMethod = require_utils.normalizeHttpRequestMethod(options.method || "GET");
94
+ const name = normMethod;
95
+ attributes[_opentelemetry_semantic_conventions.ATTR_HTTP_REQUEST_METHOD] = normMethod;
96
+ if (normMethod !== origMethod) attributes[_opentelemetry_semantic_conventions.ATTR_HTTP_REQUEST_METHOD_ORIGINAL] = origMethod;
97
+ attributes[_opentelemetry_semantic_conventions.ATTR_URL_FULL] = url;
98
+ return this.tracer.startSpan(name, {
99
+ kind: _opentelemetry_api.SpanKind.CLIENT,
100
+ attributes
101
+ });
102
+ }
103
+ /**
104
+ * Finds appropriate resource and add network events to the span
105
+ * @param span
106
+ * @param resourcesObserver
107
+ * @param endTime
108
+ */
109
+ _findResourceAndAddNetworkEvents(span, resourcesObserver, endTime) {
110
+ let resources = resourcesObserver.entries;
111
+ if (!resources.length) {
112
+ if (!performance.getEntriesByType) return;
113
+ resources = performance.getEntriesByType("resource");
114
+ }
115
+ const resource = _opentelemetry_web_common.getResource(resourcesObserver.spanUrl, resourcesObserver.startTime, endTime, resources, this._usedResources, "fetch");
116
+ if (resource.mainRequest) {
117
+ const mainRequest = resource.mainRequest;
118
+ this._markResourceAsUsed(mainRequest);
119
+ const corsPreFlightRequest = resource.corsPreFlightRequest;
120
+ if (corsPreFlightRequest) {
121
+ this._addChildSpan(span, corsPreFlightRequest);
122
+ this._markResourceAsUsed(corsPreFlightRequest);
123
+ }
124
+ _opentelemetry_web_common.addSpanNetworkEvents(span, mainRequest, this.getConfig().ignoreNetworkEvents, void 0, true);
125
+ }
126
+ }
127
+ /**
128
+ * Marks certain [resource]{@link PerformanceResourceTiming} when information
129
+ * from this is used to add events to span.
130
+ * This is done to avoid reusing the same resource again for next span
131
+ * @param resource
132
+ */
133
+ _markResourceAsUsed(resource) {
134
+ this._usedResources.add(resource);
135
+ }
136
+ /**
137
+ * Finish span, add attributes, network events etc.
138
+ * @param span
139
+ * @param spanData
140
+ * @param response
141
+ */
142
+ _endSpan(span, spanData, response) {
143
+ const endTime = _opentelemetry_core.millisToHrTime(Date.now());
144
+ const performanceEndTime = _opentelemetry_core.hrTime();
145
+ this._addFinalSpanAttributes(span, response);
146
+ if (response.status >= 400) {
147
+ span.setStatus({ code: _opentelemetry_api.SpanStatusCode.ERROR });
148
+ span.setAttribute(_opentelemetry_semantic_conventions.ATTR_ERROR_TYPE, String(response.status));
149
+ }
150
+ setTimeout(() => {
151
+ spanData.observer?.disconnect();
152
+ this._findResourceAndAddNetworkEvents(span, spanData, performanceEndTime);
153
+ this._tasksCount--;
154
+ this._clearResources();
155
+ span.end(endTime);
156
+ }, OBSERVER_WAIT_TIME_MS);
157
+ }
158
+ /**
159
+ * Patches the constructor of fetch
160
+ */
161
+ _patchConstructor() {
162
+ return (original) => {
163
+ const plugin = this;
164
+ return function patchConstructor(...args) {
165
+ if (!plugin._isEnabled) return original.apply(this, args);
166
+ const self = this;
167
+ const url = _opentelemetry_web_common.parseUrl(args[0] instanceof Request ? args[0].url : String(args[0])).href;
168
+ let options;
169
+ if (args[0] instanceof Request) options = args[1] != null ? new Request(args[0], args[1]) : args[0];
170
+ else options = args[1] || {};
171
+ const createdSpan = plugin._createSpan(url, options);
172
+ if (!createdSpan) return original.apply(this, args);
173
+ const spanData = plugin._prepareSpanData(url);
174
+ if (plugin.getConfig().measureRequestSize) require_utils.getFetchBodyLength(...args).then((bodyLength) => {
175
+ if (!bodyLength) return;
176
+ createdSpan.setAttribute(require_semconv.ATTR_HTTP_REQUEST_BODY_SIZE, bodyLength);
177
+ }).catch((error) => {
178
+ plugin._diag.warn("getFetchBodyLength", error);
179
+ });
180
+ function endSpanOnError(span, error) {
181
+ plugin._applyAttributesAfterFetch(span, options, error);
182
+ plugin._endSpan(span, spanData, {
183
+ status: error.status || 0,
184
+ statusText: error.message,
185
+ url
186
+ });
187
+ }
188
+ function endSpanOnSuccess(span, response) {
189
+ plugin._applyAttributesAfterFetch(span, options, response);
190
+ if (response.status >= 200 && response.status < 400) plugin._endSpan(span, spanData, response);
191
+ else plugin._endSpan(span, spanData, {
192
+ status: response.status,
193
+ statusText: response.statusText,
194
+ url
195
+ });
196
+ }
197
+ function onSuccess(span, response) {
198
+ try {
199
+ const body = response.clone().body;
200
+ if (body) {
201
+ const reader = body.getReader();
202
+ const read = () => {
203
+ reader.read().then(({ done }) => {
204
+ if (done) endSpanOnSuccess(span, response);
205
+ else read();
206
+ }, (error) => {
207
+ endSpanOnError(span, error);
208
+ });
209
+ };
210
+ read();
211
+ } else endSpanOnSuccess(span, response);
212
+ } catch (error) {
213
+ plugin._diag.error("Failed to read fetch response body", error);
214
+ plugin._endSpan(span, spanData, {
215
+ status: 0,
216
+ url
217
+ });
218
+ }
219
+ return response;
220
+ }
221
+ function onError(span, error) {
222
+ try {
223
+ endSpanOnError(span, error);
224
+ } catch (e) {
225
+ plugin._diag.error("Failed to end span on fetch error", e);
226
+ plugin._endSpan(span, spanData, {
227
+ status: error.status || 0,
228
+ url
229
+ });
230
+ }
231
+ throw error;
232
+ }
233
+ return _opentelemetry_api.context.with(_opentelemetry_api.trace.setSpan(_opentelemetry_api.context.active(), createdSpan), () => {
234
+ plugin._callRequestHook(createdSpan, options);
235
+ plugin._addHeaders(options, url);
236
+ plugin._tasksCount++;
237
+ return original.apply(self, options instanceof Request ? [options] : [url, options]).then(onSuccess.bind(self, createdSpan), onError.bind(self, createdSpan));
238
+ });
239
+ };
240
+ };
241
+ }
242
+ _applyAttributesAfterFetch(span, request, result) {
243
+ const applyCustomAttributesOnSpan = this.getConfig().applyCustomAttributesOnSpan;
244
+ if (applyCustomAttributesOnSpan) (0, _opentelemetry_instrumentation.safeExecuteInTheMiddle)(() => applyCustomAttributesOnSpan(span, request, result), (error) => {
245
+ if (!error) return;
246
+ this._diag.error("applyCustomAttributesOnSpan", error);
247
+ }, true);
248
+ }
249
+ _callRequestHook(span, request) {
250
+ const requestHook = this.getConfig().requestHook;
251
+ if (requestHook) (0, _opentelemetry_instrumentation.safeExecuteInTheMiddle)(() => requestHook(span, request), (error) => {
252
+ if (!error) return;
253
+ this._diag.error("requestHook", error);
254
+ }, true);
255
+ }
256
+ /**
257
+ * Prepares a span data - needed later for matching appropriate network
258
+ * resources
259
+ * @param spanUrl
260
+ */
261
+ _prepareSpanData(spanUrl) {
262
+ const startTime = _opentelemetry_core.hrTime();
263
+ const entries = [];
264
+ if (typeof PerformanceObserver !== "function") return {
265
+ entries,
266
+ startTime,
267
+ spanUrl
268
+ };
269
+ const observer = new PerformanceObserver((list) => {
270
+ list.getEntries().forEach((entry) => {
271
+ if (entry.initiatorType === "fetch" && entry.name === spanUrl) entries.push(entry);
272
+ });
273
+ });
274
+ observer.observe({ entryTypes: ["resource"] });
275
+ return {
276
+ entries,
277
+ observer,
278
+ startTime,
279
+ spanUrl
280
+ };
281
+ }
282
+ /**
283
+ * implements enable function
284
+ */
285
+ enable() {
286
+ if (!hasBrowserPerformanceAPI) {
287
+ this._diag.warn("this instrumentation is intended for web usage only, it does not instrument server-side fetch()");
288
+ return;
289
+ }
290
+ if (this._isEnabled) return;
291
+ if (this._isFetchPatched) {
292
+ this._diag.debug("fetch constructor already patched");
293
+ this._isEnabled = true;
294
+ return;
295
+ }
296
+ try {
297
+ this._wrap(globalThis, "fetch", this._patchConstructor());
298
+ this._isFetchPatched = true;
299
+ this._isEnabled = true;
300
+ } catch (err) {
301
+ this._diag.warn("Failed to patch globalThis.fetch; instrumentation will not be enabled. Another script may have locked globalThis.fetch via Object.defineProperty.", err);
302
+ }
303
+ }
304
+ /**
305
+ * deactivates fetch instrumentation
306
+ */
307
+ disable() {
308
+ if (!hasBrowserPerformanceAPI) return;
309
+ if (!this._isEnabled) return;
310
+ this._isEnabled = false;
311
+ this._usedResources = /* @__PURE__ */ new WeakSet();
312
+ }
313
+ };
314
+ //#endregion
315
+ exports.FetchInstrumentation = FetchInstrumentation;
316
+
317
+ //# sourceMappingURL=fetch.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fetch.cjs","names":["InstrumentationBase","VERSION","web","trace","context","ATTR_HTTP_RESPONSE_STATUS_CODE","ATTR_SERVER_ADDRESS","serverPortFromUrl","ATTR_SERVER_PORT","core","normalizeHttpRequestMethod","ATTR_HTTP_REQUEST_METHOD","ATTR_HTTP_REQUEST_METHOD_ORIGINAL","ATTR_URL_FULL","SpanKind","SpanStatusCode","ATTR_ERROR_TYPE","ATTR_HTTP_REQUEST_BODY_SIZE"],"sources":["../src/fetch.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport {\n context,\n propagation,\n SpanKind,\n SpanStatusCode,\n trace,\n} from '@opentelemetry/api';\nimport type { Attributes, HrTime, Span } from '@opentelemetry/api';\nimport type { InstrumentationConfig } from '@opentelemetry/instrumentation';\nimport {\n InstrumentationBase,\n safeExecuteInTheMiddle,\n} from '@opentelemetry/instrumentation';\nimport * as core from '@opentelemetry/core';\nimport * as web from '@opentelemetry/web-common';\nimport { ATTR_HTTP_REQUEST_BODY_SIZE } from './semconv';\nimport {\n ATTR_ERROR_TYPE,\n ATTR_HTTP_REQUEST_METHOD,\n ATTR_HTTP_REQUEST_METHOD_ORIGINAL,\n ATTR_HTTP_RESPONSE_STATUS_CODE,\n ATTR_SERVER_ADDRESS,\n ATTR_SERVER_PORT,\n ATTR_URL_FULL,\n} from '@opentelemetry/semantic-conventions';\nimport type { FetchError, FetchResponse, SpanData } from './types';\nimport {\n getFetchBodyLength,\n normalizeHttpRequestMethod,\n serverPortFromUrl,\n} from './utils';\nimport { VERSION } from './version';\n\n// how long to wait for observer to collect information about resources\n// this is needed as event \"load\" is called before observer\n// hard to say how long it should really wait, seems like 300ms is\n// safe enough\nconst OBSERVER_WAIT_TIME_MS = 300;\n\nconst hasBrowserPerformanceAPI = typeof PerformanceObserver !== 'undefined';\n\nexport interface FetchCustomAttributeFunction {\n (\n span: Span,\n request: Request | RequestInit,\n result: Response | FetchError\n ): void;\n}\n\nexport interface FetchRequestHookFunction {\n (span: Span, request: Request | RequestInit): void;\n}\n\n/**\n * FetchPlugin Config\n */\nexport interface FetchInstrumentationConfig extends InstrumentationConfig {\n // the number of timing resources is limited, after the limit\n // (chrome 250, safari 150) the information is not collected anymore\n // the only way to prevent that is to regularly clean the resources\n // whenever it is possible, this is needed only when PerformanceObserver\n // is not available\n clearTimingResources?: boolean;\n // urls which should include trace headers when origin doesn't match\n propagateTraceHeaderCorsUrls?: web.PropagateTraceHeaderCorsUrls;\n /**\n * URLs that partially match any regex in ignoreUrls will not be traced.\n * In addition, URLs that are _exact matches_ of strings in ignoreUrls will\n * also not be traced.\n */\n ignoreUrls?: Array<string | RegExp>;\n /** Function for adding custom attributes on the span */\n applyCustomAttributesOnSpan?: FetchCustomAttributeFunction;\n /** Function for adding custom attributes or headers before the request is handled */\n requestHook?: FetchRequestHookFunction;\n // Ignore adding network events as span events\n ignoreNetworkEvents?: boolean;\n /** Measure outgoing request size */\n measureRequestSize?: boolean;\n}\n\n/**\n * This class represents a fetch plugin for auto instrumentation\n */\nexport class FetchInstrumentation extends InstrumentationBase<FetchInstrumentationConfig> {\n readonly component: string = 'fetch';\n readonly version: string = VERSION;\n moduleName = this.component;\n private _usedResources = new WeakSet<PerformanceResourceTiming>();\n private _tasksCount = 0;\n\n // Note: Intentionally *not* using `_enabled` as the field name to avoid\n // any possible confusion with the `_enabled` field used on the *Node.js*\n // InstrumentationBase class.\n // Also not initializing the fields to `false` because the base class\n // constructor already call `enable` modifying their values and it will\n // set the instrumentaitons in a bas state (enabled, patched but with flags set to false)\n declare private _isEnabled: boolean;\n declare private _isFetchPatched: boolean;\n\n constructor(config: FetchInstrumentationConfig = {}) {\n super('@opentelemetry/instrumentation-fetch', VERSION, config);\n }\n\n init(): void {}\n\n /**\n * Add cors pre flight child span\n * @param span\n * @param corsPreFlightRequest\n */\n private _addChildSpan(\n span: Span,\n corsPreFlightRequest: PerformanceResourceTiming\n ): void {\n const childSpan = this.tracer.startSpan(\n 'CORS Preflight',\n {\n startTime: corsPreFlightRequest[web.PerformanceTimingNames.FETCH_START],\n },\n trace.setSpan(context.active(), span)\n );\n web.addSpanNetworkEvents(\n childSpan,\n corsPreFlightRequest,\n this.getConfig().ignoreNetworkEvents,\n undefined,\n true\n );\n childSpan.end(\n corsPreFlightRequest[web.PerformanceTimingNames.RESPONSE_END]\n );\n }\n\n /**\n * Adds more attributes to span just before ending it\n * @param span\n * @param response\n */\n private _addFinalSpanAttributes(span: Span, response: FetchResponse): void {\n const parsedUrl = web.parseUrl(response.url);\n span.setAttribute(ATTR_HTTP_RESPONSE_STATUS_CODE, response.status);\n // TODO: Set server.{address,port} at span creation for sampling decisions\n // (a \"SHOULD\" requirement in semconv).\n span.setAttribute(ATTR_SERVER_ADDRESS, parsedUrl.hostname);\n const serverPort = serverPortFromUrl(parsedUrl);\n if (serverPort) {\n span.setAttribute(ATTR_SERVER_PORT, serverPort);\n }\n }\n\n /**\n * Add headers\n * @param options\n * @param spanUrl\n */\n private _addHeaders(options: Request | RequestInit, spanUrl: string): void {\n if (\n !web.shouldPropagateTraceHeaders(\n spanUrl,\n this.getConfig().propagateTraceHeaderCorsUrls\n )\n ) {\n const headers: Partial<Record<string, unknown>> = {};\n propagation.inject(context.active(), headers);\n if (Object.keys(headers).length > 0) {\n this._diag.debug('headers inject skipped due to CORS policy');\n }\n return;\n }\n\n if (options instanceof Request) {\n // This mutates `Request.headers` in-place, because it is read-only\n // (per https://developer.mozilla.org/en-US/docs/Web/API/Request/headers),\n // so we cannot (easily) replace it.\n propagation.inject(context.active(), options.headers, {\n set: (h, k, v) => h.set(k, typeof v === 'string' ? v : String(v)),\n });\n } else {\n // Otherwise, create a new Headers to avoid mutating the caller's\n // possibly re-used headers.\n const headers = new Headers(options.headers);\n propagation.inject(context.active(), headers, {\n set: (h, k, v) => h.set(k, typeof v === 'string' ? v : String(v)),\n });\n options.headers = headers;\n }\n }\n\n /**\n * Clears the resource timings and all resources assigned with spans\n * when {@link FetchPluginConfig.clearTimingResources} is\n * set to true (default false)\n * @private\n */\n private _clearResources() {\n if (this._tasksCount === 0 && this.getConfig().clearTimingResources) {\n performance.clearResourceTimings();\n this._usedResources = new WeakSet<PerformanceResourceTiming>();\n }\n }\n\n /**\n * Creates a new span\n * @param url\n * @param options\n */\n private _createSpan(\n url: string,\n options: Partial<Request | RequestInit> = {}\n ): Span | undefined {\n if (core.isUrlIgnored(url, this.getConfig().ignoreUrls)) {\n this._diag.debug('ignoring span as url matches ignored url');\n return;\n }\n\n const attributes = {} as Attributes;\n const origMethod = options.method;\n const normMethod = normalizeHttpRequestMethod(options.method || 'GET');\n const name = normMethod;\n\n attributes[ATTR_HTTP_REQUEST_METHOD] = normMethod;\n if (normMethod !== origMethod) {\n attributes[ATTR_HTTP_REQUEST_METHOD_ORIGINAL] = origMethod;\n }\n attributes[ATTR_URL_FULL] = url;\n\n return this.tracer.startSpan(name, {\n kind: SpanKind.CLIENT,\n attributes,\n });\n }\n\n /**\n * Finds appropriate resource and add network events to the span\n * @param span\n * @param resourcesObserver\n * @param endTime\n */\n private _findResourceAndAddNetworkEvents(\n span: Span,\n resourcesObserver: SpanData,\n endTime: HrTime\n ): void {\n let resources: PerformanceResourceTiming[] = resourcesObserver.entries;\n if (!resources.length) {\n if (!performance.getEntriesByType) {\n return;\n }\n // fallback - either Observer is not available or it took longer\n // then OBSERVER_WAIT_TIME_MS and observer didn't collect enough\n // information\n resources = performance.getEntriesByType(\n 'resource'\n ) as PerformanceResourceTiming[];\n }\n const resource = web.getResource(\n resourcesObserver.spanUrl,\n resourcesObserver.startTime,\n endTime,\n resources,\n this._usedResources,\n 'fetch'\n );\n\n if (resource.mainRequest) {\n const mainRequest = resource.mainRequest;\n this._markResourceAsUsed(mainRequest);\n\n const corsPreFlightRequest = resource.corsPreFlightRequest;\n if (corsPreFlightRequest) {\n this._addChildSpan(span, corsPreFlightRequest);\n this._markResourceAsUsed(corsPreFlightRequest);\n }\n web.addSpanNetworkEvents(\n span,\n mainRequest,\n this.getConfig().ignoreNetworkEvents,\n undefined,\n true\n );\n }\n }\n\n /**\n * Marks certain [resource]{@link PerformanceResourceTiming} when information\n * from this is used to add events to span.\n * This is done to avoid reusing the same resource again for next span\n * @param resource\n */\n private _markResourceAsUsed(resource: PerformanceResourceTiming): void {\n this._usedResources.add(resource);\n }\n\n /**\n * Finish span, add attributes, network events etc.\n * @param span\n * @param spanData\n * @param response\n */\n private _endSpan(span: Span, spanData: SpanData, response: FetchResponse) {\n const endTime = core.millisToHrTime(Date.now());\n const performanceEndTime = core.hrTime();\n this._addFinalSpanAttributes(span, response);\n\n // https://github.com/open-telemetry/semantic-conventions/blob/main/docs/http/http-spans.md#status\n if (response.status >= 400) {\n span.setStatus({ code: SpanStatusCode.ERROR });\n span.setAttribute(ATTR_ERROR_TYPE, String(response.status));\n }\n\n setTimeout(() => {\n spanData.observer?.disconnect();\n this._findResourceAndAddNetworkEvents(span, spanData, performanceEndTime);\n this._tasksCount--;\n this._clearResources();\n span.end(endTime);\n }, OBSERVER_WAIT_TIME_MS);\n }\n\n /**\n * Patches the constructor of fetch\n */\n private _patchConstructor(): (original: typeof fetch) => typeof fetch {\n return original => {\n const plugin = this;\n\n return function patchConstructor(\n this: typeof globalThis,\n ...args: Parameters<typeof fetch>\n ): Promise<Response> {\n if (!plugin._isEnabled) {\n return original.apply(this, args);\n }\n const self = this;\n const url = web.parseUrl(\n args[0] instanceof Request ? args[0].url : String(args[0])\n ).href;\n\n // Per the Fetch spec, when fetch() is called with a Request object\n // and a separate init object, the init properties override the\n // Request's properties. Merge them into a new Request so that\n // downstream consumers (hooks, header injection, the actual fetch\n // call) see the correct final values.\n // See: https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#parameters\n let options: Request | RequestInit;\n if (args[0] instanceof Request) {\n options = args[1] != null ? new Request(args[0], args[1]) : args[0];\n } else {\n options = args[1] || {};\n }\n const createdSpan = plugin._createSpan(url, options);\n if (!createdSpan) {\n return original.apply(this, args);\n }\n const spanData = plugin._prepareSpanData(url);\n\n if (plugin.getConfig().measureRequestSize) {\n getFetchBodyLength(...args)\n .then(bodyLength => {\n if (!bodyLength) return;\n createdSpan.setAttribute(ATTR_HTTP_REQUEST_BODY_SIZE, bodyLength);\n })\n .catch(error => {\n plugin._diag.warn('getFetchBodyLength', error);\n });\n }\n\n function endSpanOnError(span: Span, error: FetchError) {\n plugin._applyAttributesAfterFetch(span, options, error);\n plugin._endSpan(span, spanData, {\n status: error.status || 0,\n statusText: error.message,\n url,\n });\n }\n\n function endSpanOnSuccess(span: Span, response: Response) {\n plugin._applyAttributesAfterFetch(span, options, response);\n if (response.status >= 200 && response.status < 400) {\n plugin._endSpan(span, spanData, response);\n } else {\n plugin._endSpan(span, spanData, {\n status: response.status,\n statusText: response.statusText,\n url,\n });\n }\n }\n\n function onSuccess(span: Span, response: Response): Response {\n try {\n // Clone the response and eagerly consume the clone to detect\n // when the body transfer completes. The original response is\n // returned to the caller untouched so that it passes internal\n // brand-checks required by APIs such as\n // WebAssembly.compileStreaming.\n // TODO: Switch to a consumer-driven model and drop `resClone`.\n // Keeping eager consumption here to preserve current behavior and avoid breaking existing tests.\n // Context: discussion in PR #5894 → https://github.com/open-telemetry/opentelemetry-js/pull/5894\n const resClone = response.clone();\n const body = resClone.body;\n if (body) {\n const reader = body.getReader();\n\n const read = (): void => {\n reader.read().then(\n ({ done }) => {\n if (done) {\n endSpanOnSuccess(span, response);\n } else {\n read();\n }\n },\n error => {\n endSpanOnError(span, error);\n }\n );\n };\n read();\n } else {\n // some older browsers don't have .body implemented\n endSpanOnSuccess(span, response);\n }\n } catch (error) {\n // Setup failed (e.g. clone() or getReader() threw).\n // End the span and clean up so _tasksCount doesn't leak.\n plugin._diag.error('Failed to read fetch response body', error);\n plugin._endSpan(span, spanData, {\n status: 0,\n url,\n });\n }\n return response;\n }\n\n function onError(span: Span, error: FetchError): never {\n try {\n endSpanOnError(span, error);\n } catch (e: unknown) {\n // endSpanOnError failed — fall back to ending the span\n // directly so _tasksCount doesn't leak.\n plugin._diag.error('Failed to end span on fetch error', e);\n plugin._endSpan(span, spanData, {\n status: error.status || 0,\n url,\n });\n }\n\n throw error;\n }\n\n return context.with(\n trace.setSpan(context.active(), createdSpan),\n () => {\n // Call request hook before injection so hooks cannot tamper with propagation headers.\n // Also, this means the hook will see `options.headers` in the same type as passed in,\n // rather than as a `Headers` instance set by `_addHeaders()`.\n plugin._callRequestHook(createdSpan, options);\n plugin._addHeaders(options, url);\n plugin._tasksCount++;\n\n return original\n .apply(\n self,\n options instanceof Request ? [options] : [url, options]\n )\n .then(\n onSuccess.bind(self, createdSpan),\n onError.bind(self, createdSpan)\n );\n }\n );\n };\n };\n }\n\n private _applyAttributesAfterFetch(\n span: Span,\n request: Request | RequestInit,\n result: Response | FetchError\n ) {\n const applyCustomAttributesOnSpan =\n this.getConfig().applyCustomAttributesOnSpan;\n if (applyCustomAttributesOnSpan) {\n safeExecuteInTheMiddle(\n () => applyCustomAttributesOnSpan(span, request, result),\n error => {\n if (!error) {\n return;\n }\n\n this._diag.error('applyCustomAttributesOnSpan', error);\n },\n true\n );\n }\n }\n\n private _callRequestHook(span: Span, request: Request | RequestInit) {\n const requestHook = this.getConfig().requestHook;\n if (requestHook) {\n safeExecuteInTheMiddle(\n () => requestHook(span, request),\n error => {\n if (!error) {\n return;\n }\n\n this._diag.error('requestHook', error);\n },\n true\n );\n }\n }\n\n /**\n * Prepares a span data - needed later for matching appropriate network\n * resources\n * @param spanUrl\n */\n private _prepareSpanData(spanUrl: string): SpanData {\n const startTime = core.hrTime();\n const entries: PerformanceResourceTiming[] = [];\n if (typeof PerformanceObserver !== 'function') {\n return { entries, startTime, spanUrl };\n }\n\n const observer = new PerformanceObserver(list => {\n const perfObsEntries = list.getEntries() as PerformanceResourceTiming[];\n perfObsEntries.forEach(entry => {\n if (entry.initiatorType === 'fetch' && entry.name === spanUrl) {\n entries.push(entry);\n }\n });\n });\n observer.observe({\n entryTypes: ['resource'],\n });\n return { entries, observer, startTime, spanUrl };\n }\n\n /**\n * implements enable function\n */\n override enable(): void {\n if (!hasBrowserPerformanceAPI) {\n this._diag.warn(\n 'this instrumentation is intended for web usage only, it does not instrument server-side fetch()'\n );\n return;\n }\n\n if (this._isEnabled) {\n return;\n }\n\n if (this._isFetchPatched) {\n this._diag.debug('fetch constructor already patched');\n this._isEnabled = true;\n return;\n }\n\n try {\n // `_wrap` throws if a third-party script has locked globalThis.fetch via\n // Object.defineProperty(window, 'fetch', { writable: false, ... }).\n this._wrap(globalThis, 'fetch', this._patchConstructor());\n this._isFetchPatched = true;\n this._isEnabled = true;\n } catch (err) {\n this._diag.warn(\n 'Failed to patch globalThis.fetch; instrumentation will not be enabled. ' +\n 'Another script may have locked globalThis.fetch via Object.defineProperty.',\n err\n );\n }\n }\n\n /**\n * deactivates fetch instrumentation\n */\n override disable(): void {\n if (!hasBrowserPerformanceAPI) {\n return;\n }\n if (!this._isEnabled) {\n return;\n }\n this._isEnabled = false;\n this._usedResources = new WeakSet<PerformanceResourceTiming>();\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,120 @@
1
+ import { FetchError } from "./types.cjs";
2
+ import { Span } from "@opentelemetry/api";
3
+ import { InstrumentationBase, InstrumentationConfig } from "@opentelemetry/instrumentation";
4
+ import * as web from "@opentelemetry/web-common";
5
+ //#region src/fetch.d.ts
6
+ interface FetchCustomAttributeFunction {
7
+ (span: Span, request: Request | RequestInit, result: Response | FetchError): void;
8
+ }
9
+ interface FetchRequestHookFunction {
10
+ (span: Span, request: Request | RequestInit): void;
11
+ }
12
+ /**
13
+ * FetchPlugin Config
14
+ */
15
+ interface FetchInstrumentationConfig extends InstrumentationConfig {
16
+ clearTimingResources?: boolean;
17
+ propagateTraceHeaderCorsUrls?: web.PropagateTraceHeaderCorsUrls;
18
+ /**
19
+ * URLs that partially match any regex in ignoreUrls will not be traced.
20
+ * In addition, URLs that are _exact matches_ of strings in ignoreUrls will
21
+ * also not be traced.
22
+ */
23
+ ignoreUrls?: Array<string | RegExp>;
24
+ /** Function for adding custom attributes on the span */
25
+ applyCustomAttributesOnSpan?: FetchCustomAttributeFunction;
26
+ /** Function for adding custom attributes or headers before the request is handled */
27
+ requestHook?: FetchRequestHookFunction;
28
+ ignoreNetworkEvents?: boolean;
29
+ /** Measure outgoing request size */
30
+ measureRequestSize?: boolean;
31
+ }
32
+ /**
33
+ * This class represents a fetch plugin for auto instrumentation
34
+ */
35
+ declare class FetchInstrumentation extends InstrumentationBase<FetchInstrumentationConfig> {
36
+ readonly component: string;
37
+ readonly version: string;
38
+ moduleName: string;
39
+ private _usedResources;
40
+ private _tasksCount;
41
+ private _isEnabled;
42
+ private _isFetchPatched;
43
+ constructor(config?: FetchInstrumentationConfig);
44
+ init(): void;
45
+ /**
46
+ * Add cors pre flight child span
47
+ * @param span
48
+ * @param corsPreFlightRequest
49
+ */
50
+ private _addChildSpan;
51
+ /**
52
+ * Adds more attributes to span just before ending it
53
+ * @param span
54
+ * @param response
55
+ */
56
+ private _addFinalSpanAttributes;
57
+ /**
58
+ * Add headers
59
+ * @param options
60
+ * @param spanUrl
61
+ */
62
+ private _addHeaders;
63
+ /**
64
+ * Clears the resource timings and all resources assigned with spans
65
+ * when {@link FetchPluginConfig.clearTimingResources} is
66
+ * set to true (default false)
67
+ * @private
68
+ */
69
+ private _clearResources;
70
+ /**
71
+ * Creates a new span
72
+ * @param url
73
+ * @param options
74
+ */
75
+ private _createSpan;
76
+ /**
77
+ * Finds appropriate resource and add network events to the span
78
+ * @param span
79
+ * @param resourcesObserver
80
+ * @param endTime
81
+ */
82
+ private _findResourceAndAddNetworkEvents;
83
+ /**
84
+ * Marks certain [resource]{@link PerformanceResourceTiming} when information
85
+ * from this is used to add events to span.
86
+ * This is done to avoid reusing the same resource again for next span
87
+ * @param resource
88
+ */
89
+ private _markResourceAsUsed;
90
+ /**
91
+ * Finish span, add attributes, network events etc.
92
+ * @param span
93
+ * @param spanData
94
+ * @param response
95
+ */
96
+ private _endSpan;
97
+ /**
98
+ * Patches the constructor of fetch
99
+ */
100
+ private _patchConstructor;
101
+ private _applyAttributesAfterFetch;
102
+ private _callRequestHook;
103
+ /**
104
+ * Prepares a span data - needed later for matching appropriate network
105
+ * resources
106
+ * @param spanUrl
107
+ */
108
+ private _prepareSpanData;
109
+ /**
110
+ * implements enable function
111
+ */
112
+ enable(): void;
113
+ /**
114
+ * deactivates fetch instrumentation
115
+ */
116
+ disable(): void;
117
+ }
118
+ //#endregion
119
+ export { FetchCustomAttributeFunction, FetchInstrumentation, FetchInstrumentationConfig, FetchRequestHookFunction };
120
+ //# sourceMappingURL=fetch.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fetch.d.cts","names":[],"sources":["../src/fetch.d.ts"],"mappings":";;;;;UAKiB;GACZ,MAAM,MAAM,SAAS,UAAU,aAAa,QAAQ,WAAW;;UAEnD;GACZ,MAAM,MAAM,SAAS,UAAU;;;;;UAKnB,mCAAmC;EAChD;EACA,+BAA+B,IAAI;;;;;;EAMnC,aAAa,eAAe;;EAE5B,8BAA8B;;EAE9B,cAAc;EACd;;EAEA;;;;;cAKiB,6BAA6B,oBAAoB;WACzD;WACA;EACT;UACQ;UACA;UACA;UACA;EACR,YAAY,SAAS;EACrB;;;;;;UAMQ;;;;;;UAMA;;;;;;UAMA;;;;;;;UAOA;;;;;;UAMA;;;;;;;UAOA;;;;;;;UAOA;;;;;;;UAOA;;;;UAIA;UACA;UACA;;;;;;UAMA;;;;EAIR;;;;EAIA"}