End-to-End Observability in Node.js: OpenTelemetry, Distributed Tracing, and Grafana Dashboards

Why Traditional Server Logs Are Insufficient

In distributed systems where a single user action touches an API gateway, auth service, database, and third-party payment provider, isolated log files cannot pinpoint which service caused a 3-second delay. OpenTelemetry propagates a unique traceparent header across all network hops, stitching the entire journey into a single unified timeline visual.

Setting Up Automatic Instrumentation

import { NodeSDK } from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';

const sdk = new NodeSDK({
  traceExporter: new OTLPTraceExporter({ url: 'http://otel-collector:4318/v1/traces' }),
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();