0.202.0 • Published 5 months ago

@opentelemetry/instrumentation-xml-http-request v0.202.0

Weekly downloads
2
License
Apache-2.0
Repository
github
Last release
5 months ago

OpenTelemetry XMLHttpRequest Instrumentation for web

NPM Published Version Apache License

Note: This is an experimental package. New releases may include breaking changes.

This module provides auto instrumentation for web using XMLHttpRequest.

Installation

npm install --save @opentelemetry/instrumentation-xml-http-request

Usage

import {
  ConsoleSpanExporter,
  SimpleSpanProcessor,
  WebTracerProvider,
} from '@opentelemetry/sdk-trace-web';
import { XMLHttpRequestInstrumentation } from '@opentelemetry/instrumentation-xml-http-request';
import { ZoneContextManager } from '@opentelemetry/context-zone';
import { registerInstrumentations } from '@opentelemetry/instrumentation';

const providerWithZone = new WebTracerProvider({
  spanProcessors: [new SimpleSpanProcessor(new ConsoleSpanExporter())]
});

providerWithZone.register({
  contextManager: new ZoneContextManager(),
});

registerInstrumentations({
  instrumentations: [
    new XMLHttpRequestInstrumentation({
      propagateTraceHeaderCorsUrls: ['http://localhost:8090']
    }),
  ],
});


const webTracerWithZone = providerWithZone.getTracer('default');

/////////////////////////////////////////

// or plugin can be also initialised separately and then set the tracer provider or meter provider
const xmlHttpRequestInstrumentation = new XMLHttpRequestInstrumentation({
  propagateTraceHeaderCorsUrls: ['http://localhost:8090']
});
const providerWithZone = new WebTracerProvider();
providerWithZone.register({
  contextManager: new ZoneContextManager(),
});
xmlHttpRequestInstrumentation.setTracerProvider(providerWithZone);
/////////////////////////////////////////


// and some test
const req = new XMLHttpRequest();
req.open('GET', 'http://localhost:8090/xml-http-request.js', true);
req.send();

XHR Instrumentation options

XHR instrumentation plugin has few options available to choose from. You can set the following:

OptionsTypeDescription
applyCustomAttributesOnSpanXHRCustomAttributeFunctionFunction for adding custom attributes
ignoreNetworkEventsbooleanDisable network events being added as span events (network events are added by default)
measureRequestSizebooleanMeasure outgoing request length (outgoing request length is not measured by default)
semconvStabilityOptInstringA comma-separated string of tokens as described for OTEL_SEMCONV_STABILITY_OPT_IN in the HTTP semantic convention stability migration guide. See the "Semantic Conventions" section below.

Semantic Conventions

Up to and including v0.200.0, instrumentation-xml-http-request generates telemetry using Semantic Conventions v1.7.0.

HTTP semantic conventions (semconv) were stabilized in semconv v1.23.0, and a migration process was defined. instrumentation-xml-http-request versions 0.201.0 and later include support for migrating to stable HTTP semantic conventions, as described below. The intent is to provide an approximate 6 month time window for users of this instrumentation to migrate to the new HTTP semconv, after which a new minor version will change to use the new semconv by default and drop support for the old semconv. See the HTTP semconv migration plan for OpenTelemetry JS instrumentations.

To select which semconv version(s) is emitted from this instrumentation, use the semconvStabilityOptIn configuration option. This option works as described for OTEL_SEMCONV_STABILITY_OPT_IN:

  • http: emit the new (stable) v1.23.0 semantics
  • http/dup: emit both the old v1.7.0 and the new (stable) v1.23.0 semantics
  • By default, if semconvStabilityOptIn includes neither of the above tokens, the old v1.7.0 semconv is used.

Span status: When the stable semconv is selected, the span status is set to ERROR when the response status code is >=400 or when the response fails with an 'error' or 'timeout' XHR event. When just the old semconv is select, the span status is not set.

Span attributes:

v1.7.0 semconvv1.23.0 semconvNotes
http.methodhttp.request.methodHTTP request method. With v1.23.0 semconv http.request.method_original may also be included.
http.urlurl.fullFull HTTP request URL
http.hostserver.address and server.portThe hostname and port of the request URL
http.status_codehttp.response.status_codeHTTP response status code
http.request_content_length_uncompressedhttp.request.body.sizeThis is only added if measureRequestSize is true.
http.response_content_length_uncompressed(not included)Stable HTTP semconv would use http.response.body.size, but this is an Opt-In attribute, so would require adding a configuration option to this instrumentation to enable.
http.response_content_length(not included)Stable HTTP semconv would use http.response.header.<key>, but this is an Opt-In attribute, so would require adding a configuration option to this instrumentation to enable.
(no equivalent)error.typeThe response status (as a string), if the response status was >=400, or one of these possible request errors: 'timeout' and 'error'.
http.user_agent(not included)Stable HTTP semconv would use user_agent.original, but this is an Opt-In attribute, so would require adding a configuration option to this instrumentation to enable.
http.scheme(not included)Stable HTTP semconv would use url.scheme, but this is an Opt-In attribute, so would require adding a configuration option to this instrumentation to enable.
http.status_text(not included)This is no longer a documented semantic conventions attribute.

Example Screenshots

Screenshot of the running example Screenshot of the running example Screenshot of the running example

See examples/tracer-web for a short example.

Useful links

License

Apache 2.0 - See LICENSE for more information.

0.201.1

5 months ago

0.201.0

5 months ago

0.55.0

11 months ago

0.202.0

5 months ago

0.56.0

11 months ago

0.200.0

7 months ago

0.54.1

12 months ago

0.54.2

12 months ago

0.200.0-rc.1

7 months ago

0.57.2

8 months ago

0.57.0

10 months ago

0.57.1

9 months ago

0.200.0-dev.0

8 months ago

0.200.0-dev.1

8 months ago

0.54.0

12 months ago

0.53.0

1 year ago

0.52.1

1 year ago

0.52.0

1 year ago

0.51.1

1 year ago

0.51.0

1 year ago

0.50.0

2 years ago

0.49.1

2 years ago

0.49.0

2 years ago

0.48.0

2 years ago

0.47.0

2 years ago

0.46.0

2 years ago

0.43.0

2 years ago

0.44.0

2 years ago

0.45.1

2 years ago

0.45.0

2 years ago

0.41.1

2 years ago

0.41.2

2 years ago

0.41.0

2 years ago

0.42.0

2 years ago

0.40.0

2 years ago

0.39.1

2 years ago

0.39.0

2 years ago

0.36.1

3 years ago

0.36.0

3 years ago

0.37.0

3 years ago

0.38.0

3 years ago

0.35.1

3 years ago

0.35.0

3 years ago

0.34.0

3 years ago

0.32.0

3 years ago

0.33.0

3 years ago

0.30.0

3 years ago

0.31.0

3 years ago

0.29.0

3 years ago

0.29.2

3 years ago

0.29.1

3 years ago

0.28.0

3 years ago

0.27.0

4 years ago

0.26.0

4 years ago

0.25.1-alpha.22

4 years ago

0.25.1-alpha.23

4 years ago

0.25.1-alpha.16

4 years ago

0.25.1-alpha.12

4 years ago

0.25.1-alpha.13

4 years ago

0.25.1-alpha.7

4 years ago

0.25.1-alpha.2

4 years ago

0.25.1-alpha.4

4 years ago

0.25.0

4 years ago

0.24.1-alpha.20

4 years ago

0.25.1-alpha.21

4 years ago

0.24.1-alpha.19

4 years ago

0.24.1-alpha.18

4 years ago

0.24.1-alpha.14

4 years ago

0.24.1-alpha.7

4 years ago

0.24.1-alpha.6

4 years ago

0.24.1-alpha.9

4 years ago

0.24.1-alpha.8

4 years ago

0.24.1-alpha.5

4 years ago

0.24.1-alpha.4

4 years ago

0.24.1-alpha.1

4 years ago

0.24.1-alpha.31

4 years ago

0.23.1-alpha.28

4 years ago

0.24.0

4 years ago

0.23.1-alpha.24

4 years ago

0.23.1-alpha.23

4 years ago

0.23.1-alpha.16

4 years ago

0.23.1-alpha.12

4 years ago

0.23.1-alpha.13

4 years ago

0.23.1-alpha.15

4 years ago

0.23.1-alpha.3

4 years ago

0.23.1-alpha.17

4 years ago

0.23.1-alpha.18

4 years ago

0.22.1-alpha.16

4 years ago

0.22.1-alpha.15

4 years ago

0.22.1-alpha.9

4 years ago

0.23.0

4 years ago

0.22.1-alpha.14

4 years ago

0.22.1-alpha.13

4 years ago

0.22.1-alpha.2

4 years ago

0.22.1-alpha.3

4 years ago

0.22.1-alpha.5

4 years ago

0.22.0

4 years ago

0.21.1-alpha.3

4 years ago

0.20.0

4 years ago

0.21.1-alpha.2

4 years ago

0.21.1-alpha.1

4 years ago

0.21.1-alpha.7

4 years ago

0.21.0

4 years ago

0.19.1-alpha.43

4 years ago

0.19.1-alpha.44

4 years ago

0.20.1-alpha.5

4 years ago

0.20.1-alpha.4

4 years ago

0.20.1-alpha.3

4 years ago

0.20.1-alpha.49

4 years ago

0.19.1-alpha.27

4 years ago

0.19.1-alpha.26

4 years ago

0.19.1-alpha.29

4 years ago

0.19.1-alpha.28

4 years ago

0.19.1-alpha.21

4 years ago

0.19.1-alpha.23

4 years ago

0.19.1-alpha.25

4 years ago

0.19.0

4 years ago

0.19.1-alpha.19

4 years ago

0.19.1-alpha.12

4 years ago

0.19.1-alpha.11

4 years ago

0.19.1-alpha.14

4 years ago

0.19.1-alpha.13

4 years ago

0.19.1-alpha.41

4 years ago

0.19.1-alpha.40

4 years ago

0.19.1-alpha.42

4 years ago

0.19.1-alpha.37

4 years ago

0.19.1-alpha.39

4 years ago

0.19.1-alpha.9

4 years ago

0.19.1-alpha.31

4 years ago

0.19.1-alpha.7

4 years ago

0.19.1-alpha.33

4 years ago

0.18.3-alpha.35

5 years ago

0.19.1-alpha.36

4 years ago

0.18.3-alpha.31

5 years ago

0.18.3-alpha.33

5 years ago

0.18.3-alpha.30

5 years ago

0.18.3-alpha.28

5 years ago

0.18.3-alpha.29

5 years ago

0.18.3-alpha.27

5 years ago

0.18.3-alpha.20

5 years ago

0.18.3-alpha.23

5 years ago

0.18.3-alpha.25

5 years ago

0.18.3-alpha.17

5 years ago

0.18.3-alpha.18

5 years ago

0.18.3-alpha.16

5 years ago

0.18.3-alpha.13

5 years ago

0.18.3-alpha.14

5 years ago

0.18.3-alpha.9

5 years ago

0.18.3-alpha.10

5 years ago

0.18.3-alpha.11

5 years ago

0.18.3-alpha.7

5 years ago

0.18.3-alpha.5

5 years ago

0.18.3-alpha.4

5 years ago

0.18.3-alpha.3

5 years ago

0.18.2

5 years ago

0.18.2-alpha.1

5 years ago

0.18.3-alpha.2

5 years ago

0.18.3-alpha.1

5 years ago

0.18.2-alpha.81

5 years ago

0.18.1

5 years ago

0.18.1-alpha.26

5 years ago

0.18.1-alpha.20

5 years ago

0.18.1-alpha.24

5 years ago

0.18.1-alpha.23

5 years ago

0.18.1-alpha.21

5 years ago

0.18.1-alpha.16

5 years ago

0.18.1-alpha.18

5 years ago

0.18.1-alpha.13

5 years ago

0.18.1-alpha.11

5 years ago

0.17.1-alpha.10

5 years ago

0.17.1-alpha.11

5 years ago

0.18.1-alpha.3

5 years ago

0.18.1-alpha.12

5 years ago

0.18.0

5 years ago

0.17.1-alpha.8

5 years ago

0.17.1-alpha.5

5 years ago

0.17.1-alpha.2

5 years ago

0.17.1-alpha.21

5 years ago

0.16.1-alpha.20

5 years ago

0.17.0

5 years ago

0.16.1-alpha.18

5 years ago

0.16.1-alpha.14

5 years ago

0.16.1-alpha.15

5 years ago

0.16.1-alpha.12

5 years ago

0.16.1-alpha.10

5 years ago

0.16.1-alpha.11

5 years ago

0.16.1-alpha.6

5 years ago

0.16.0

5 years ago

0.15.0

5 years ago

0.14.0

5 years ago

0.13.0

5 years ago