Strands Agents SDK

pip install arize-otel \
  openinference-instrumentation-strands-agents \
  strands-agents boto3

export ARIZE_SPACE_ID="<your-space-id>"
export ARIZE_API_KEY="<your-api-key>"
export ARIZE_PROJECT_NAME="strands-agents-tracing-example"

# AWS credentials — long-lived or SSO/STS temporary.
export AWS_ACCESS_KEY_ID="<your-aws-access-key-id>"
export AWS_SECRET_ACCESS_KEY="<your-aws-secret-access-key>"
export AWS_REGION="us-east-1"

# Only required for SSO / STS / federated logins.
export AWS_SESSION_TOKEN=""  # optional

# instrumentation.py
import os

from opentelemetry import trace
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider

from strands.telemetry import StrandsTelemetry
from openinference.instrumentation.strands_agents import (
    StrandsAgentsToOpenInferenceProcessor,
)

# Build a TracerProvider with the Arize project name in its Resource —
# that's how a trace gets routed to a project on the Arize side.
resource = Resource.create({
    "openinference.project.name": os.environ["ARIZE_PROJECT_NAME"],
    "service.name": "strands-agents-tracing-example",
})
provider = TracerProvider(resource=resource)
provider.add_span_processor(StrandsAgentsToOpenInferenceProcessor())

# IMPORTANT: register the provider globally. Strands' `Agent` calls
# `opentelemetry.trace.get_tracer(...)`, which uses the global provider.
# StrandsTelemetry(tracer_provider=...) stores it but does NOT register
# it as global — you have to do that yourself.
trace.set_tracer_provider(provider)

# Hand the provider to StrandsTelemetry and wire the OTLP exporter to
# Arize. setup_otlp_exporter uses HTTP/Protobuf, so the endpoint is
# the HTTP /v1/traces path.
telemetry = StrandsTelemetry(tracer_provider=provider)
telemetry.setup_otlp_exporter(
    endpoint="https://otlp.arize.com/v1/traces",
    headers={
        "authorization":   os.environ["ARIZE_API_KEY"],
        "arize-space-id":  os.environ["ARIZE_SPACE_ID"],
        "arize-interface": "python",
    },
)
print("Arize AX tracing initialized for Strands Agents.")

# example.py

# Importing instrumentation first ensures the global TracerProvider is
# set before any Strands Agent is constructed.
from instrumentation import provider

from strands import Agent
from strands.models.bedrock import BedrockModel

# BedrockModel reads AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY /
# AWS_REGION (and AWS_SESSION_TOKEN if present) from the environment.
# Cross-region inference profile (`us.` prefix) is required for newer
# Claude models on Bedrock.
agent = Agent(
    name="OceanAssistant",
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-6"),
    system_prompt="Answer concisely in two sentences.",
)

result = agent("Why is the ocean salty?")
print(str(result))

# Force flush + shutdown — without these, the BatchSpanProcessor inside
# StrandsTelemetry can drop late spans when the process exits.
provider.force_flush(timeout_millis=10000)
provider.shutdown()