Ir para o conteúdo

apogee-ai-observability

OpenTelemetry tracing tailored for LLM calls — token counts, model, latency, cost.

Esta página está sendo ampliada

As tabelas abaixo são geradas do código-fonte do pacote, portanto estão corretas. Guias narrativos e exemplos comentados estão sendo escritos módulo a módulo.

API pública

Tudo abaixo é exportado pela raiz do pacote, então from apogee_ai_observability import X funciona para cada nome.

Camada Símbolos
Application · Use cases EmitSpanUseCase, EndTraceUseCase, GetTraceUseCase, ListTracesUseCase, RecordCostUseCase, ReplayTraceUseCase, StartTraceUseCase
Domain CostLedgerEntry, LLMOpName, LLMUsage, LatencyBucket, MetricSample, Span, SpanStatus, Trace, TraceContext, semantic
Domain · Enums EmitterKind, SpanKind
Domain · Exceptions EmitterFailureException, ObservabilityError, PricingNotAvailableException, TraceNotFoundException
Domain · Protocols (ports) ICostCalculator, IPricingProvider, ITelemetryEmitter, ITraceStore
Infrastructure CompositeEmitter, ConsoleEmitter, CostTracker, DatadogLLMEmitter, HeliconeEmitter, InMemoryEmitter, InMemoryTraceStore, JsonTraceStore, LangSmithEmitter, LangfuseEmitter, NoopEmitter, OTelEmitter, PRICING_TABLE, PhoenixEmitter, SpanNode, StructuredJsonEmitter, TableCostCalculator, TablePricingProvider, TraceContextScope, TraceReplayer, get_active, reset_active, set_active

Instalação

Bash
pip install apogee-ai-observability

A instalação base não tem dependência externa obrigatória. Cada extra habilita um adapter.

Extra Traz
langfuse langfuse>=2.40
langsmith langsmith>=0.1.100
phoenix arize-phoenix>=4.0, arize-phoenix-otel>=0.6
helicone httpx>=0.27
otel opentelemetry-api>=1.25, opentelemetry-sdk>=1.25, opentelemetry-exporter-otlp>=1.25
datadog ddtrace>=2.10
all langfuse>=2.40, langsmith>=0.1.100, arize-phoenix>=4.0, arize-phoenix-otel>=0.6, httpx>=0.27, opentelemetry-api>=1.25, opentelemetry-sdk>=1.25, opentelemetry-exporter-otlp>=1.25

CLI

Instalado como console script e registrado como plugin do apogee, então os mesmos subcomandos funcionam sob o binário global.

Bash
apogee-observability --help

Leia a seguir