Traceo SDK for Node.js

Library for integration with the Traceo Platform.

The Traceo platform offers the ability to collect and visualize data from OpenTelemetry. OpenTelemetry, also known as OTel for short, is a vendor-neutral open-source Observability framework for instrumenting, generating, collecting, and exporting telemetry data such as traces, metrics, logs. Docs.

How Traceo use OTel instruments?

By using custom metrics and spans exporters (logs in near future). After receiving data from Otel instruments, the data is successively sent to the Traceo platform, where it is aggregated and visualized.

Installation

To install this SDK add this package to your package.json like below:

yarn add @traceo-sdk/opentelemetry-node

or

npm install @traceo-sdk/opentelemetry-node

Hint: This package require also @traceo-sdk/node package to full integaration.

Usage

First what you need is to initialize TraceoClient in your application.

1import { TraceoClient } from "@traceo-sdk/node";
2
3new TraceoClient(<project_id>, {
4    host: <traceo_host>
5});

Metrics

To use the exporter for metrics you need to import TraceoMetricExporter from @traceo-sdk/opentelemetry-node like below.

1import { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
2import { Resource } from "@opentelemetry/resources";
3import { TraceoMetricExporter } from "@traceo-sdk/opentelemetry-node";
4
5//other code...
6
7this.meterProvider = new MeterProvider({
8    resource: new Resource({
9        'service.name': 'traceo-otel'
10    })
11});
12
13this.meterProvider.addMetricReader(new PeriodicExportingMetricReader({
14    exporter: new TraceoMetricExporter(),
15    exportIntervalMillis: 10000
16}));

Spans

To use the exporter for spans you need to import TraceoTracingExporter from @traceo-sdk/opentelemetry-node like below.

1import { SimpleSpanProcessor } from "@opentelemetry/tracing";
2import { NodeTracerProvider } from "@opentelemetry/node";
3import { TraceoTracingExporter } from "@traceo-sdk/opentelemetry-node";
4
5//other code...
6
7this.tracerProvider = new NodeTracerProvider();
8this.tracerProvider.addSpanProcessor(new SimpleSpanProcessor(new TraceoTracingExporter()));
9this.tracerProvider.register();

Support

Feel free to create Issues, Pull Request and Discussion. If you want to contact with the developer working on this package click here.