# Flowhawk

> Flowhawk is a hosted observability service, built on ClickStack (ClickHouse), that monitors a software team's business flows, like sign-up and checkout, rather than only servers. When a flow breaks, it shows how many customers were affected, which deploy or change most likely caused it, and the traces, logs and errors behind it. An AI agent investigates incidents and proposes fixes, such as a rollback, that only run after a person approves them.

Key facts:

- Input is standard OpenTelemetry (OTLP over HTTP or gRPC) with an ingest key, or a Sentry SDK pointed at a Flowhawk DSN. Existing instrumentation keeps working.
- Signals: traces, logs, metrics, errors (grouped into issues), browser and mobile sessions with replay, LLM calls from the customer's own app, uptime checks, database queries. Every signal is tagged with its business flow and step, and pages link to each other by flow.
- Incidents, alerts, on-call paging (push, email, text, phone) and status pages are included.
- Coding agents (Claude Code, Cursor, Codex) connect to Flowhawk over MCP at https://api.flowhawk.dev/mcp, with the same roles as the app.
- Flows, alerts, dashboards and collection settings are YAML files with their history; every change is a reviewed diff that can be undone. Each workspace's config is kept in a git repository on Flowhawk's side; connecting the customer's own GitHub repository is not available yet.
- Pricing: a prepaid balance in US dollars, no plans and no per-seat fees. Free trial: $10 of usage for 14 days after a card check that charges nothing. First top-up $30. About $0.20 per GB of telemetry sent (kept 30 days), $1.25 per agent investigation, $0.25 per agent question. 30-day refund of unspent money on the first top-up.
- Data is stored in Germany (Hetzner, Falkenstein). Agent requests go to Anthropic's API, which may process them outside the EU.
- Runs hosted by Flowhawk, on the customer's own ClickHouse, or in the customer's AWS, Google Cloud or Azure account (early access). There is no self-hosted edition of the whole platform.
- SDK packages (Node.js, Python, Go, Java, .NET, Ruby, PHP, browser, mobile) are not yet published to public package registries. Until they are, send data with any OpenTelemetry SDK or collector, or a Sentry SDK.
- Contact: hello@flowhawk.dev. Sign up at https://app.flowhawk.dev/signup?trial=1.

The full text of every page is at https://flowhawk.dev/llms-full.txt.

## Docs

- [Docs overview](https://flowhawk.dev/docs/): what is covered and where to start
- [Getting started](https://flowhawk.dev/docs/getting-started): sign up, create an ingest key, send a first trace, map flows
- [Sending data](https://flowhawk.dev/docs/sending-data): OTLP endpoints, Flowhawk SDKs, browser SDK, Sentry SDKs, setup by a coding agent over MCP
- [Language guides](https://flowhawk.dev/docs/languages): standard OpenTelemetry setup for Node.js, Python, Java, Go, .NET, Ruby and PHP, and an OpenTelemetry Collector exporter
- [Business flows](https://flowhawk.dev/docs/flows): the business map (flows, steps, match rules by service and route, span name or queue), how spans are matched, what a flow gives you
- [Coding agents and MCP](https://flowhawk.dev/docs/coding-agents): connecting Claude Code, Cursor and other MCP clients, OAuth and MCP keys, setup by the agent, the tools and their roles
- [Alerts, incidents and on-call](https://flowhawk.dev/docs/alerts-and-incidents): how alerts fire, incident pages, paging and status pages
- [Config as code](https://flowhawk.dev/docs/config-as-code): the YAML files behind flows, alerts, dashboards and settings, and how a change is proposed, previewed, applied and undone
- [Billing](https://flowhawk.dev/docs/billing): the prepaid balance, prices, spend cap, auto-reload and invoices
- [Your data and privacy](https://flowhawk.dev/docs/data-and-privacy): where data is stored, retention, redaction, export and deletion
- [Help and troubleshooting](https://flowhawk.dev/docs/help): common problems sending data, and how to reach the team

## Product

- [Home page](https://flowhawk.dev/): what Flowhawk does, screenshots, pricing with a worked example and a comparison with other tools, deployment options, FAQ
- [Flowhawk vs Sentry](https://flowhawk.dev/vs-sentry): where each is stronger, prices, moving over with Sentry's SDKs
- [Flowhawk vs Datadog](https://flowhawk.dev/vs-datadog): where each is stronger, per-host pricing against one prepaid balance
- [Flowhawk vs Better Stack](https://flowhawk.dev/vs-better-stack): where each is stronger, on-call without a per-person fee
- [Security](https://flowhawk.dev/security): how data is protected, workspace isolation, what is not done yet, how to report a vulnerability

## Legal

- [Terms of service](https://flowhawk.dev/terms)
- [Privacy policy](https://flowhawk.dev/privacy)
- [Data processing agreement and subprocessors](https://flowhawk.dev/dpa)

## Optional

- [Status](https://status.flowhawk.dev): service status