Feature map
A concise map of every product surface and the end-to-end runtime flow behind obsrv.
Core product features
Organizations
LiveTenant boundary for teams, members, projects, API keys, traces, and billing state.
Projects
LiveWorkspace inside an organization; every API key and trace is scoped to one project.
Email and Google auth
LiveUsers can sign in with password auth or Google OAuth when provider secrets are configured.
API keys
LiveProject-scoped ingest keys used by SDKs and raw HTTP clients; keys are shown once.
Python SDK
LivePublished as theta-obsrv with context-manager tracing, steps, metadata, media, metrics, and integrations.
Node SDK
LivePublished as @theta-lab/obsrv with TypeScript types, async context parenting, batching, and integrations.
Trace ingest
LiveSDK and HTTP pipeline that accepts complete agent runs and persists normalized trace records.
Trace timeline
LiveRun detail view showing input, output, ordered steps, messages, tool calls, metadata, latency, tokens, and cost.
Step capture
LiveNested operation model for LLM calls, tools, retrieval, routing, custom spans, and errors.
Messages
LiveChat-style user, assistant, system, and tool messages with structured content parts.
Tool calls
LiveRecords tool name, arguments, result, latency, timestamps, and errors inside the trace timeline.
Metadata filters
LiveArbitrary JSON metadata attached to traces and steps for release, customer, workflow, or experiment slicing.
Attachments
LiveImage, audio, video, file, and sensor artifacts uploaded to object storage and linked back to traces.
Threads
LiveGroups related runs by conversation or workflow identifier so repeated user journeys can be reviewed together.
Metrics
LiveObserved or automated quality signals recorded against traces for pass/fail, score, and label tracking.
Monitors
LiveThreshold rules over trace signals such as latency, error rate, cost, or metric outcomes.
Clusters
LiveGroups similar failure patterns across traces so recurring issues are easier to identify.
Chat with traces
LiveNatural-language trace search that uses an LLM-backed tool flow to retrieve and summarize matching traces.
AI comments
Live when provider key existsAdds model-generated diagnosis or context to trace detail and cluster workflows when AI provider secrets are configured.
OpenAI integration
LiveWrapper for OpenAI calls so model requests and responses become structured trace steps automatically.
Anthropic integration
LiveWrapper for Anthropic calls, including tool-use details, token usage, status, and response metadata.
OpenClaw integration
LiveAdapter for OpenResponses-compatible gateway calls with normalized event ingestion.
REST API
LiveRaw HTTPS API for traces, events, imports, media, metrics, search, and clusters.
Self-hosting
EnterpriseCustom deployment path for enterprise customers that need private VPC or dedicated infrastructure.
How the system works end to end
Trace write path
Application code uses an SDK or HTTP client with THETA_API_KEY. The API validates the key, resolves the project, normalizes the payload, stores raw trace data, indexes summaries, and exposes it in the dashboard.
Investigation path
A user opens the dashboard, filters traces by project/status/metadata, drills into a trace timeline, reviews steps and tool calls, then jumps to related threads, metrics, monitors, or clusters.
AI analysis path
When provider secrets are configured, trace search, clustering, and comments can call the configured model to summarize failures, group patterns, and suggest likely causes.
Production operations path
Dashboard runs at app.obsrv.tech, public API is api.obsrv.tech, and internal deployment details stay in operator runbooks rather than public SDK examples.
Public package and API names
- Python package:
theta-obsrv, imported astheta_observability. - Node package:
@theta-lab/obsrv. - SDK API key env var:
THETA_API_KEY. - Optional project filter env var:
THETA_PROJECT. - Public API base URL:
https://api.obsrv.tech. - Dashboard URL:
https://app.obsrv.tech.