OpenTelemetry를 통한 관찰성

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

OTEL_ENV = {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    # 베타 상태인 추적에 필요합니다. 메트릭 및 로그 이벤트는 이것이 필요하지 않습니다.
    "CLAUDE_CODE_ENHANCED_TELEMETRY_BETA": "1",
    # 신호별로 내보내기 도구를 선택합니다. SDK의 경우 otlp를 사용하세요. 아래 참고를 참조하세요.
    "OTEL_TRACES_EXPORTER": "otlp",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    # 표준 OTLP 전송 구성입니다.
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4318",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer your-token",
}


async def main():
    options = ClaudeAgentOptions(env=OTEL_ENV)
    async for message in query(
        prompt="List the files in this directory", options=options
    ):
        print(message)


asyncio.run(main())

OTEL_ENV = {
    # ... 이전 예제의 내보내기 도구 구성 ...
    "OTEL_METRIC_EXPORT_INTERVAL": "1000",
    "OTEL_LOGS_EXPORT_INTERVAL": "1000",
    "OTEL_TRACES_EXPORT_INTERVAL": "1000",
}

options = ClaudeAgentOptions(
    env={
        # ... 내보내기 도구 구성 ...
        "OTEL_SERVICE_NAME": "support-triage-agent",
        "OTEL_RESOURCE_ATTRIBUTES": "service.version=1.4.0,deployment.environment=production",
    },
)

from urllib.parse import quote

options = ClaudeAgentOptions(
    env={
        # ... 내보내기 도구 구성 ...
        "OTEL_RESOURCE_ATTRIBUTES": f"enduser.id={quote(request.user_id)},tenant.id={quote(request.tenant_id)}",
    },
)