/docs/features

Feature map

A concise map of every product surface and the end-to-end runtime flow behind obsrv.

Core product features

Organizations

Live

Tenant boundary for teams, members, projects, API keys, traces, and billing state.

Projects

Live

Workspace inside an organization; every API key and trace is scoped to one project.

Email and Google auth

Live

Users can sign in with password auth or Google OAuth when provider secrets are configured.

API keys

Live

Project-scoped ingest keys used by SDKs and raw HTTP clients; keys are shown once.

Python SDK

Live

Published as theta-obsrv with context-manager tracing, steps, metadata, media, metrics, and integrations.

Node SDK

Live

Published as @theta-lab/obsrv with TypeScript types, async context parenting, batching, and integrations.

Trace ingest

Live

SDK and HTTP pipeline that accepts complete agent runs and persists normalized trace records.

Trace timeline

Live

Run detail view showing input, output, ordered steps, messages, tool calls, metadata, latency, tokens, and cost.

Step capture

Live

Nested operation model for LLM calls, tools, retrieval, routing, custom spans, and errors.

Messages

Live

Chat-style user, assistant, system, and tool messages with structured content parts.

Tool calls

Live

Records tool name, arguments, result, latency, timestamps, and errors inside the trace timeline.

Metadata filters

Live

Arbitrary JSON metadata attached to traces and steps for release, customer, workflow, or experiment slicing.

Attachments

Live

Image, audio, video, file, and sensor artifacts uploaded to object storage and linked back to traces.

Threads

Live

Groups related runs by conversation or workflow identifier so repeated user journeys can be reviewed together.

Metrics

Live

Observed or automated quality signals recorded against traces for pass/fail, score, and label tracking.

Monitors

Live

Threshold rules over trace signals such as latency, error rate, cost, or metric outcomes.

Clusters

Live

Groups similar failure patterns across traces so recurring issues are easier to identify.

Chat with traces

Live

Natural-language trace search that uses an LLM-backed tool flow to retrieve and summarize matching traces.

AI comments

Live when provider key exists

Adds model-generated diagnosis or context to trace detail and cluster workflows when AI provider secrets are configured.

OpenAI integration

Live

Wrapper for OpenAI calls so model requests and responses become structured trace steps automatically.

Anthropic integration

Live

Wrapper for Anthropic calls, including tool-use details, token usage, status, and response metadata.

OpenClaw integration

Live

Adapter for OpenResponses-compatible gateway calls with normalized event ingestion.

REST API

Live

Raw HTTPS API for traces, events, imports, media, metrics, search, and clusters.

Self-hosting

Enterprise

Custom 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 as theta_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.