FAQ

What is Owlmetry?

Owlmetry is a self-hosted observability platform for mobile and backend apps. It provides structured event logging, performance metrics with p50/p95 tracking, multi-step conversion funnels, automatic error clustering via the issue tracker, and event attachments for logs and screenshots. It is designed to be driven by AI coding agents through its MCP endpoint, CLI, and REST API, though it includes a full web dashboard for human use.

Is Owlmetry free?

Yes. The hosted version at owlmetry.com has a free tier (1 app, 10,000 events/month) and a Pro tier that is free during the alpha period. Self-hosting is free forever with no limits on apps, events, or features.

What database does Owlmetry require?

Owlmetry uses a single PostgreSQL 16 database with no additional infrastructure. Events are stored in monthly-partitioned tables for performance. There is no Redis, Kafka, or other dependency — just Postgres.

Which platforms are supported?

Owlmetry has SDKs for three platforms:

• Swift SDK — iOS, iPadOS, and macOS (distributed as a Swift Package)
• Android SDK — Kotlin apps, with optional Jetpack Compose UI (published to Maven Central as com.owlmetry:owlmetry-android)
• Node.js SDK — Express, Fastify, serverless functions, and any Node.js backend

The Swift and Node.js SDKs have zero runtime dependencies; the Android core module depends only on kotlinx-coroutines. All three handle batching, compression, and retry automatically. Events from all platforms appear in the same dashboard.

Can I self-host Owlmetry?

Yes. Owlmetry is designed to run on a single VPS. You get the same platform as the hosted version, but everything runs on your hardware and your database. There is no telemetry or phone-home behavior. See the self-hosting guide for setup instructions.

How is Owlmetry different from PostHog, Mixpanel, or Amplitude?

Owlmetry is purpose-built for the agent-first development workflow. Where other tools are designed around manual dashboard interaction, Owlmetry's CLI and REST API let AI coding agents handle setup, instrumentation, querying, and debugging autonomously. It is also fully self-hostable on a single Postgres database with no external dependencies, making it simpler to operate than alternatives that require multi-service architectures.

What does "agent-first" mean?

Agent-first means Owlmetry is designed so that AI coding agents (Claude Code, Codex, Cursor, etc.) can handle the entire observability workflow — from installing SDKs and configuring API keys to querying events and diagnosing production issues. Dedicated skill files for the CLI, Swift SDK, Android SDK, and Node SDK are distributed as a Claude Code plugin marketplace so agents know the correct command syntax and SDK APIs. You still get a full web dashboard, but the API is the primary interface.

Is Owlmetry open source?

Yes. The entire codebase is open source and spread across a few repos under the owlmetry GitHub org:

• owlmetry/owlmetry — server, web dashboard, CLI, and deploy scripts
• owlmetry/owlmetry-swift — Swift SDK for iOS, iPadOS, and macOS
• owlmetry/owlmetry-android — Android SDK (Kotlin / Jetpack Compose)
• owlmetry/owlmetry-node — Node.js Server SDK
• owlmetry/owlmetry-skills — Claude Code plugin marketplace with agent skills

You can inspect, modify, and self-host it freely.

How do I get started?

The fastest path is to install the CLI and let your coding agent handle the rest:

npm install -g @owlmetry/cli

Then install the Owlmetry skills plugin inside Claude Code so your agent knows how to drive the CLI and SDKs:

/plugin marketplace add owlmetry/owlmetry-skills
/plugin install owlmetry@owlmetry-skills

See the getting started guide for both agent-driven and manual setup paths.