This package has been deprecated

Author message:

Package renamed to @opentelemetry/context-async-hooks, see https://github.com/open-telemetry/opentelemetry-js

@opentelemetry/scope-async-hooks
TypeScript icon, indicating that this package has built-in type declarations

0.4.0 • Public • Published

OpenTelemetry AsyncHooks-based Scope Manager

Gitter chat NPM Published Version dependencies devDependencies Apache License

This package provides async-hooks based scope manager which is used internally by OpenTelemetry plugins to propagate specific scope between function calls and async operations. It only targets NodeJS since async-hooks is only available there.

What is a ScopeManager ?

The definition and why they exist is available on the readme of the scope-base package.

Implementation in NodeJS

NodeJS has a specific API to track async scope: async-hooks, it allows to track creation of new async operation and their respective parent. This package only handle storing a specific object for a given async hooks context.

Limitations

Even if the API is native to NodeJS, it doesn't cover all possible cases of scope propagation but there is a big effort from the NodeJS team to fix those. That's why we generally advise to be on the latest LTS to benefit from performance and bug fixes.

There are known modules that break scope propagation (some of them are listed there), so it's possible that the scope manager doesn't work with them.

Prior arts

Context propagation is a big subject when talking about tracing in NodeJS, if you want more information about that here are some resources:

Useful links

License

Apache 2.0 - See LICENSE for more information.

Package Sidebar

Install

npm i @opentelemetry/scope-async-hooks

Weekly Downloads

32

Version

0.4.0

License

Apache-2.0

Unpacked Size

29.8 kB

Total Files

9

Last publish

Collaborators

  • pichlermarc
  • bogdandrutu
  • dyladan