Node.js [Logs]

1. Environment

OTEL_SERVICE_NAME=my-service
OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production
OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.tracelit.app
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer <WORKSPACE_INGEST_KEY>

2. Install

npm install @opentelemetry/sdk-node @opentelemetry/api \
  @opentelemetry/auto-instrumentations-node \
  @opentelemetry/exporter-trace-otlp-proto \
  @opentelemetry/exporter-logs-otlp-proto \
  @opentelemetry/sdk-logs

3. Bootstrap file

Create tracelit-otel.cjs and start with:

NODE_OPTIONS="--require ./tracelit-otel.cjs" <your-start-command>

The bootstrap must register both a trace exporter and a log exporter (OTLPLogExporter + BatchLogRecordProcessor). Traces-only setups will never pass the onboarding log check.

4. Log libraries

pino
winston
console

Most common for Express/Fastify.

Install

npm install pino @opentelemetry/instrumentation-pino

Wire

Add to your NodeSDK instrumentations:

const { PinoInstrumentation } = require('@opentelemetry/instrumentation-pino');

instrumentations: [
  getNodeAutoInstrumentations(),
  new PinoInstrumentation(),
],

Produce signals

logger.info({ count: 3 }, 'order listed');
logger.error({ err }, 'payment failed');

Classic structured logger.

Install

npm install winston @opentelemetry/instrumentation-winston

Wire

const { WinstonInstrumentation } = require('@opentelemetry/instrumentation-winston');

instrumentations: [
  getNodeAutoInstrumentations(),
  new WinstonInstrumentation(),
],

Produce signals

logger.info('order listed', { count: 3 });
logger.error('payment failed', { err });

Prefer pino or winston for real services. Console is fine for proving the OTLP pipe.

Smoke test

Emit via the OpenTelemetry Logs API after NodeSDK starts with a log exporter, or temporarily enable console instrumentation. Then:

console.info('order listed');
console.error('payment failed');

If console instrumentation is not enabled, these lines stay local and will not appear in Tracelit.

5. Verify

Emit INFO and ERROR from a route, then confirm both in Tracelit.

Frontend

Backend

1. Environment

2. Install

3. Bootstrap file

4. Log libraries

Install

Wire

Produce signals

Install

Wire

Produce signals

Smoke test

5. Verify

​1. Environment

​2. Install

​3. Bootstrap file

​4. Log libraries

​Install

​Wire

​Produce signals

​Install

​Wire

​Produce signals

​Smoke test

​5. Verify

1. Environment

2. Install

3. Bootstrap file

4. Log libraries

Install

Wire

Produce signals

Install

Wire

Produce signals

Smoke test

5. Verify