# opentelemetry-propagation-utils

> open telemetry propagation utils

Latest version **0.27.0** (published 2024-05-21) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install opentelemetry-propagation-utils
pnpm add opentelemetry-propagation-utils
yarn add opentelemetry-propagation-utils
bun add opentelemetry-propagation-utils
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.27.0 |
| Published | 2024-05-21 |
| First published | 2020-11-18 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 29.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 168 |
| Author | Aspecto |
| Maintainers | aspecto-release-bot |
| Keywords | propagation, opentelemetry |

## Links

- npm: https://www.npmjs.com/package/opentelemetry-propagation-utils
- Repository: https://github.com/aspecto-io/opentelemetry-ext-js
- Issues: https://github.com/aspecto-io/opentelemetry-ext-js/issues
- npm.io page: https://npm.io/package/opentelemetry-propagation-utils

## Recent versions

- 0.27.0 (latest) — 2024-05-21
- 0.0.0-2024-05-16--12-47 (alpha) — 2024-05-16
- 0.6.1-aws-import-one-serivce.0 (canary) — 2021-04-28
- 0.2.0-dev.0 (dev) — 2021-01-27
- 0.26.0 — 2023-10-17
- 0.0.0-2023-10-17--13-06 — 2023-10-17
- 0.0.0-2023-07-26--14-48 — 2023-07-26
- 0.0.0-2022-07-11--08-09 — 2022-07-11
- 0.25.0 — 2022-06-02
- 0.24.1 — 2022-04-13
- 0.0.0-2022-04-13--14-32 — 2022-04-13
- 0.0.0-2021-12-26--12-31 — 2021-12-26
- 0.0.0-2021-12-26--12-22 — 2021-12-26
- 0.0.0-2021-12-22--14-33 — 2021-12-22
- 0.0.0-2021-12-21--15-57 — 2021-12-21
- … 44 more at https://npm.io/package/opentelemetry-propagation-utils/versions

## README

# opentelemetry-propagation-utils
[![NPM version](https://img.shields.io/npm/v/opentelemetry-propagation-utils.svg)](https://www.npmjs.com/package/opentelemetry-propagation-utils)

A collection of propagation utils for opentelemetry.

## Install
```sh
yarn add opentelemetry-propagation-utils
```

## Usage
### PubSub

To make sure each message handled by pubsub creates a new `process` span, and propagates to any internal operation, do as follow:

```ts
import { pubsubPropagation } from 'opentelemetry-propagation-utils';
import { Span, propagation, trace, Context } from '@opentelemetry/api';

const patch = (message: Message[], rootSpan: Span) => {
    const tracer = trace.getTracer('my-tracer');
    pubsubPropagation.patchArrayForProcessSpans(messages, tracer);

    pubsubPropagation.patchMessagesArrayToStartProcessSpans<Message>({
        messages,
        tracer,
        parentSpan: rootSpan,
        messageToSpanDetails: (message) => ({
            attributes: { ... },
            name: 'some-name',
            parentContext: propagation.extract(....) as Context
        }),
    });
}
```

---
_Source: https://npm.io/package/opentelemetry-propagation-utils · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._