Manual Instrumentation (development/debugging)

from bedrock_agentcore import BedrockAgentCoreApp
from opentelemetry.instrumentation.bedrock_agentcore import (
    BedrockAgentCoreInstrumentor,
)

# Manual instrumentation, easy to debug in your IDE
BedrockAgentCoreInstrumentor().instrument()

app = BedrockAgentCoreApp()

@app.entrypoint
def handler(event):
    return {"status": "success", "event": event}

Zero-code Instrumentation

In zero-code instrumentation mode, ensure you install opentelemetry-distribution and run your app with the OpenTelemetry Bedrock AgentCore instrumentor enabled:

.. code-block:: bash

opentelemetry-instrument python your_bedrock_agentcore_app.py

from bedrock_agentcore import BedrockAgentCoreApp

app = BedrockAgentCoreApp()

@app.entrypoint
def handler(event):
    return {"status": "success", "event": event}

AgentCore + Bedrock

from opentelemetry.instrumentation.bedrock_agentcore import (
    BedrockAgentCoreInstrumentor,
)
from opentelemetry.instrumentation.bedrock import BedrockInstrumentor

BedrockAgentCoreInstrumentor().instrument()
BedrockInstrumentor().instrument()

Adds Bedrock API call spans with AWS-specific attributes and metrics.

AgentCore + Bedrock + Strands

from opentelemetry.instrumentation.bedrock_agentcore import (
    BedrockAgentCoreInstrumentor,
)
from opentelemetry.instrumentation.bedrock import BedrockInstrumentor
from opentelemetry.instrumentation.strands import StrandsInstrumentor

BedrockAgentCoreInstrumentor().instrument()
BedrockInstrumentor().instrument()
StrandsInstrumentor().instrument()

Adds agent orchestration, runtime operations, and Bedrock model call telemetry.

Environment Variables

# Capture request/response content (disabled by default)
export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true

# Content capture mode
export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT_MODE=SPAN_AND_EVENT

# Select GenAI emitters
export OTEL_INSTRUMENTATION_GENAI_EMITTERS=span_metric_event

Instrumentation Options

from opentelemetry.instrumentation.bedrock_agentcore import (
    BedrockAgentCoreInstrumentor,
)

# Basic instrumentation
BedrockAgentCoreInstrumentor().instrument()

# With custom providers
BedrockAgentCoreInstrumentor().instrument(
    tracer_provider=my_tracer_provider,
    meter_provider=my_meter_provider,
    logger_provider=my_logger_provider,
)

# Uninstrumentation
BedrockAgentCoreInstrumentor().uninstrument()