Telemetry
Motive
This package goal is to make the experience of configuring and working with OpenTelemetry easier.
example
Below are short examples for tracing and metrics. More examples are available at the examples folder, and the various opentelemetry repos.
Tracing
The following code shows a simple example of how to work with tracing. please notice that you need to manually install any auto-instrumentation library that you require.
import { Tracing } from '@bondsports/telemetry';
import { trace } from '@opentelemetry/api';
const tracing = new Tracing();
tracing.start();
const tracer = trace.getTracer('tracing-name')
const span = tracer.startSpan('some-action');
span.setAttribute('some-attribute');
// DO STUFF
span.end();
tracing.stop().then(() => console.log('done'));
Another way for initialize tracing with custom resource:
import { Tracing } from '@bondsports/telemetry';
import { Resource } from '@opentelemetry/resources';
const resource = new Resource({ 'service.version': number, 'service.name': 'my-service-name' });
const tracing = new Tracing([], resource);
...
Metrics
The following code shows a simple example of how to work with metrics.
import { Metrics } from '@bondsports/telemetry';
const metrics = new Metrics('sample-meter');
const meter = metrics.start();
const counter = meter.createCounter('sample_counter');
counter.add(1);
metrics.stop().then(() => console.log('done'));
Configuration
Common configuration
name | allowed value | default value | description |
---|---|---|---|
TELEMETRY_SERVICE_NAME | string | from package.json | The service name |
TELEMETRY_SERVICE_VERSION | string | from package.json | The service version |
TELEMETRY_HOST_NAME | string | os.hostname() |
The host name |
Tracing configuration
name | allowed value | default value | description |
---|---|---|---|
TELEMETRY_TRACING_ENABLED | 'true', 'false' | 'false' | Should Tracing be enabled |
TELEMETRY_TRACING_URL* | string | http://localhost:55681/v1/trace | The URL to the OpenTelemetry Collector |
TELEMETRY_TRACING_RATIO | float | 1 | The amount of traces to sample |
* required (only when tracing is enabled).
Metric configuration
name | allowed value | default value | description |
---|---|---|---|
TELEMETRY_METRICS_ENABLED | 'true', 'false' | 'false' | Should Metrics be enabled |
TELEMETRY_METRICS_URL* | string | http://localhost:55681/v1/metrics | The URL to the OpenTelemetry Collector |
TELEMETRY_METRICS_INTERVAL | number | 15000 | The interval in miliseconds between sending data to the collector |
* required (only when tracing is enabled).