Function setupTracer

OpenTelemetry telemetry support for Strands Agents SDK.

This module provides setupTracer() to configure a NodeTracerProvider with OTLP or console exporters. The Agent class handles tracing internally once telemetry is configured.

Example: Basic setup with OTLP exporter

import { telemetry, Agent } from '@strands-agents/sdk'

// Configure telemetry with OTLP exporter
telemetry.setupTracer({ exporters: { otlp: true } })

// Agent automatically traces invocations
const agent = new Agent()

Example: Using your own OpenTelemetry provider

import { Agent } from '@strands-agents/sdk'
import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node'

// Set up your own provider
const provider = new NodeTracerProvider()
provider.register()

// Agent automatically uses your provider via the global OTel API
const agent = new Agent()

setupTracer(config?: TracerConfig): NodeTracerProvider

Set up the tracer provider with the given configuration.

Parameters

config: TracerConfig = {}
Tracer configuration options

Returns NodeTracerProvider

The configured NodeTracerProvider

Example

import { telemetry } from '@strands-agents/sdk'

// Simple setup with defaults
const provider = telemetry.setupTracer({
  exporters: { otlp: true }
})

// Custom provider
telemetry.setupTracer({
  provider: new NodeTracerProvider({ resource: myResource }),
  exporters: { otlp: true, console: true }
})