Saltar a contenido

apogee-ai-observability

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

This page is being expanded

The tables below are generated from the package source, so they are accurate. Narrative guides and worked examples are being written module by module.

Public API

Everything below is exported from the package root, so from apogee_ai_observability import X works for each name.

Layer Symbols
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

Install

Bash
pip install apogee-ai-observability

The base install has no required third-party dependency. Each extra unlocks one adapter.

Extra Pulls in
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

Installed as a console script, and registered as an apogee plugin so the same subcommands work under the global binary.

Bash
apogee-observability --help