앱에서 이미 OpenTelemetry를 사용하고 있다면 프레임워크별 커넥터가 따로 필요하지 않습니다. OTLP 익스포터를 Yardstick으로 연결하면 모든 LLM & 에이전트 스팬에 비용이 함께 표시됩니다. Yardstick은 일반적인 GenAI 컨벤션(OpenLLMetry, OpenInference, OpenTelemetry GenAI semantic conventions)을 이해하므로 LangChain, LlamaIndex, OpenAI Agents SDK, CrewAI, Vercel AI SDK 같은 프레임워크가 별도 설정 없이 바로 동작합니다.
다음 환경 변수를 설정하세요(정확한 엔드포인트를 복사하고 Connect 페이지의 OpenTelemetry 카드에서 키를 생성하세요):
OTEL_EXPORTER_OTLP_ENDPOINT=<your Yardstick OTLP endpoint>
OTEL_EXPORTER_OTLP_HEADERS=x-yardstick-key=ysk_...
OTEL_EXPORTER_OTLP_PROTOCOL=http/json
스팬은 스팬에 담긴 에이전트 이름(예: gen_ai.agent.name 또는 service.name)을 기준으로 해당 에이전트에 귀속됩니다. 이름이 없는 스팬은 별도로 유실되지 않도록 catch-all 에이전트로 들어갑니다. 현재 엔드포인트는 JSON 형식의 HTTP를 통한 OTLP만 지원하므로 OTEL_EXPORTER_OTLP_PROTOCOL=http/json으로 고정해 주세요. Protobuf 지원은 곧 추가될 예정입니다.