8000 chore(otel): Add basic usage instructions to readme (#6094) · yongdamsh/sentry-javascript@cfa196b · GitHub
[go: up one dir, main page]

Skip to content

Commit cfa196b

Browse files
authored
chore(otel): Add basic usage instructions to readme (getsentry#6094)
1 parent 621e0b3 commit cfa196b

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

packages/opentelemetry-node/README.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,44 @@
1010
[![npm dm](https://img.shields.io/npm/dm/@sentry/opentelemetry-node.svg)](https://www.npmjs.com/package/@sentry/opentelemetry-node)
1111
[![npm dt](https://img.shields.io/npm/dt/@sentry/opentelemetry-node.svg)](https://www.npmjs.com/package/@sentry/opentelemetry-node)
1212

13+
## Installation
14+
15+
```bash
16+
npm install @sentry/node @sentry/opentelemetry-node
17+
18+
# Or yarn
19+
yarn add @sentry/node @sentry/opentelemetry-node
20+
```
21+
22+
Note that `@sentry/opentelemetry-node` depends on the following peer dependencies:
23+
24+
* `@opentelemetry/api` version 1 or greater
25+
* `@opentelemetry/sdk-trace-base` version 1 or greater, or a package that implements that, like `@opentelemetry/sdk-node`.
26+
27+
## Usage
28+
29+
You need to register the SentrySpanProcessor with your OpenTelemetry installation:
30+
31+
```js
32+
import * as Sentry from '@sentry/node';
33+
import { SentrySpanProcessor } from '@sentry/opentelemetry-node';
34+
35+
// Make sure to call this BEFORE setting up OpenTelemetry
36+
Sentry.init({
37+
dsn: '__DSN__',
38+
// ...
39+
});
40+
41+
const sdk = new opentelemetry.NodeSDK({
42+
// Existing config
43+
traceExporter: new OTLPTraceExporter(),
44+
instrumentations: [ getNodeAutoInstrumentations() ],
45+
46+
// Sentry config
47+
spanProcessor: new SentrySpanProcessor()
48+
})
49+
```
50+
1351
## Links
1452

1553
- [Official SDK Docs](https://docs.sentry.io/quickstart/)

0 commit comments

Comments
 (0)
0