# @azure/core-tracing

> Provides low-level interfaces and helper methods for tracing in Azure SDK

Latest version **1.4.0** (published 2026-07-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install @azure/core-tracing
pnpm add @azure/core-tracing
yarn add @azure/core-tracing
bun add @azure/core-tracing
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2026-07-13 |
| First published | 2019-08-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.0.0 |
| Dependencies | 1 |
| Unpacked size | 198.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2296 |
| Author | Microsoft Corporation |
| Maintainers | azure-sdk, microsoft1es, microsoft-oss-releases |
| Keywords | azure, tracing, cloud |

## Links

- npm: https://www.npmjs.com/package/@azure/core-tracing
- Repository: https://github.com/Azure/azure-sdk-for-js
- Homepage: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/core/core-tracing/README.md
- Issues: https://github.com/Azure/azure-sdk-for-js/issues
- npm.io page: https://npm.io/package/@azure/core-tracing

## Dependencies (1)

- [tslib](https://npm.io/package/tslib.md) ^2.6.2

## Recent versions

- 1.4.0 (latest) — 2026-07-13
- 1.3.2-alpha.20260311.2 (dev) — 2026-03-11
- 1.3.2-alpha.20260310.2 — 2026-03-10
- 1.3.2-alpha.20260309.3 — 2026-03-09
- 1.3.2-alpha.20260306.4 — 2026-03-06
- 1.3.2-alpha.20260305.6 — 2026-03-05
- 1.3.2-alpha.20260302.3 — 2026-03-02
- 1.3.2-alpha.20260227.2 — 2026-02-27
- 1.3.2-alpha.20260226.1 — 2026-02-26
- 1.3.2-alpha.20260225.1 — 2026-02-25
- 1.3.2-alpha.20260224.3 — 2026-02-24
- 1.3.2-alpha.20260223.3 — 2026-02-23
- 1.3.2-alpha.20260220.1 — 2026-02-20
- 1.3.2-alpha.20260219.1 — 2026-02-19
- 1.3.2-alpha.20260218.1 — 2026-02-18
- … 519 more at https://npm.io/package/@azure/core-tracing/versions

## README

# Azure Core tracing library for JavaScript

This is the core tracing library that provides low-level interfaces and helper methods for tracing in Azure SDK JavaScript libraries which work in the browser and Node.js.

## Getting started

### Installation

This package is primarily used in Azure client libraries and not meant to be used directly by consumers of Azure SDKs.

## Key Concepts

- `TracingClient` is the primary interface providing tracing functionality to client libraries. Client libraries should only be aware of and interact with a `TracingClient` instance.
  - A `TracingClient` implementation can be created using the `createTracingClient` factory function.
- `Instrumenter` provides an abstraction over an instrumentation and acts as the interop point for using third party libraries like OpenTelemetry. By default, a no-op `Instrumenter` is used. Customers who wish to enable `OpenTelemetry` based tracing will do so by installing and registering the [@azure/opentelemetry-instrumentation-azure-sdk] package.
- `TracingContext` is an **immutable** data container, used to pass operation-specific information around (such as span parenting information).
- `TracingSpan` is an abstraction of a `Span` which can be used to record events, attributes, and exceptions.

## Examples

Examples can be found in the `samples` folder.

## Next steps

You can build and run the tests locally by executing `npm run test`. Explore the `test` folder to see advanced usage and behavior of the public classes.

## Troubleshooting

If you run into issues while using this library, please feel free to [file an issue](https://github.com/Azure/azure-sdk-for-js/issues/new).

## Contributing

If you'd like to contribute to this library, please read the [contributing guide](https://github.com/Azure/azure-sdk-for-js/blob/main/CONTRIBUTING.md) to learn more about how to build and test the code.

[@azure/opentelemetry-instrumentation-azure-sdk]: https://www.npmjs.com/package/@azure/opentelemetry-instrumentation-azure-sdk

---
_Source: https://npm.io/package/@azure/core-tracing · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._