@opentelemetry/context-base

OpenTelemetry Base Context Manager

This package provides the ContextManager interface (which is used by concrete implementations) and a no-op implementation (which is used internally when no context propagation is defined). It's intended for use both on the server and in the browser.

What is a Context Manager

To understand why they exists, we'll need to understand how Javascript works: when you make native function call (networks, setInterval etc) you generally call C++ code that will later callback your own code.

A common issue when tracing a request in javascript is to link the function that have made the native call to the callback that the native code called when the response is there. Imagine you want to track for which user you made the request, you need some sort of "context/context aware storage".

ContextManager's aim to offer exactly that, it's API offer to store an object in the current context (with()) and if needed, bind() to a specific function call to find it back when the callback fire, which can later get retrieved using active().

This package only include the interface and a Noop implementation, for more information please see the async-hooks based ContextManager for NodeJS.

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us on gitter

License

Apache 2.0 - See LICENSE for more information.

Changelog

0.14.0

:boom: Breaking Change

• opentelemetry-api, opentelemetry-metrics
  • #1709 refactor: batch observer to be independent from metric types (@legendecas)
• opentelemetry-api, opentelemetry-instrumentation-http, opentelemetry-instrumentation-xml-http-request, opentelemetry-plugin-fetch, opentelemetry-plugin-grpc-js, opentelemetry-plugin-grpc, opentelemetry-plugin-http, opentelemetry-shim-opentracing
  • #1734 chore: requires user to pass context to propagation APIs (@Flarna)
• opentelemetry-api, opentelemetry-core, opentelemetry-grpc-utils, opentelemetry-node, opentelemetry-plugin-fetch, opentelemetry-plugin-grpc-js, opentelemetry-plugin-grpc, opentelemetry-plugin-http
  • #1715 chore: moving plugin from api to core (@obecny)

:rocket: (Enhancement)

• opentelemetry-semantic-conventions
  • #1684 feat(semantic-conventions): messaging specifications (@nirsky)
• opentelemetry-tracing
  • #1685 chore: remove ordered attribute dropping (@dyladan)
• opentelemetry-api, opentelemetry-core, opentelemetry-sdk-node, opentelemetry-shim-opentracing, opentelemetry-tracing
  • #1687 chore: rename CorrelationContext to Baggage (@dyladan)
• opentelemetry-exporter-prometheus
  • #1697 fix(exporter-prometheus): add appendTimestamp option to ExporterConfig (@antoniomrfranco)
• opentelemetry-exporter-collector-proto, opentelemetry-exporter-collector
  • #1661 Use http keep-alive in collector exporter (@lonewolf3739)
• opentelemetry-plugin-http, opentelemetry-semantic-conventions
  • #1625 feat(opentelemetry-js): add content size attributes to HTTP spans (@nijotz)
• opentelemetry-exporter-collector
  • #1708 feat(exporter-collector): implement concurrencyLimit option (@dobesv)
• opentelemetry-api, opentelemetry-core, opentelemetry-grpc-utils, opentelemetry-node, opentelemetry-plugin-fetch, opentelemetry-plugin-grpc-js, opentelemetry-plugin-grpc, opentelemetry-plugin-http
  • #1715 chore: moving plugin from api to core (@obecny)

:bug: (Bug Fix)

• opentelemetry-exporter-jaeger
  • #1758 fix(@opentelemetry/exporter-jaeger): fixed issue #1757 (@debagger)
• opentelemetry-exporter-collector-grpc, opentelemetry-exporter-collector-proto, opentelemetry-exporter-collector
  • #1751 Fixing Span status when exporting span (@obecny)
• opentelemetry-instrumentation-http, opentelemetry-plugin-http
  • #1747 feat: fixing failing test (@obecny)
• opentelemetry-instrumentation-xml-http-request
  • #1720 fix(xhr): check for resource timing support (@bradfrosty)

Committers: 13

• Antônio Franco (@antoniomrfranco)
• Bartlomiej Obecny (@obecny)
• Brad Frost (@bradfrosty)
• Daniel Dyla (@dyladan)
• Dobes Vandermeer (@dobesv)
• Gerhard Stöbich (@Flarna)
• Mikhail Sokolov (@debagger)
• Nik Zap (@nijotz)
• Nir Hadassi (@nirsky)
• Shovnik Bhattacharya (@shovnik)
• Srikanth Chekuri (@lonewolf3739)
• Valentin Marchaud (@vmarchaud)
• legendecas (@legendecas)