OwlMetry Documentation

OwlMetry is a self-hosted observability platform built for the agentic development era. It captures events, metrics, and funnels from your apps and backend services, stores everything in a single PostgreSQL instance, and exposes it all through a REST API, CLI, and optional web dashboard.

Your agent can set up the entire integration, query events, diagnose issues, and act on what it finds -- without a human opening a dashboard.

Key Features

• Event ingestion with batch processing, deduplication, and gzip compression
• Structured metrics with lifecycle tracking (start/complete/fail) and aggregation queries
• Funnel analytics to measure conversion and drop-off across multi-step flows
• A/B experiments with client-side variant assignment and server-side analysis
• Agent-native API where every operation is available through owl_agent_ keys
• Single PostgreSQL backend with monthly-partitioned event tables -- no Kafka, no ClickHouse, no Redis

Documentation Sections

• Getting Started -- Set up your first project and start sending events in minutes. Covers both the hosted instance at owlmetry.com and self-hosted deployments.
• Concepts -- Core building blocks: events, metrics, funnels, experiments, projects and apps, authentication, and data mode.
• Swift SDK -- Native SDK for iOS, iPadOS, and macOS. Zero external dependencies. Covers events, screen tracking, metrics, funnels, identity, and experiments.
• Node.js SDK -- Server-side SDK for backends and serverless functions. Zero runtime dependencies. Covers events, metrics, funnels, identity, and serverless support.
• CLI -- Command-line interface for agents and humans. Query events, manage resources, and inspect audit logs. Supports --format json and --format table.
• API Reference -- Complete REST API covering authentication, ingestion, querying, project/app management, metrics, funnels, teams, and identity.
• Self-Hosting -- Deploy on your own infrastructure. Covers system requirements, PostgreSQL, nginx, SSL, pm2, and maintenance.