Help and troubleshooting

Contact us

In the app, open Help & feedback in the sidebar to send a question, a bug report or an idea: it includes the page you were on. Or email hello@flowhawk.dev. We answer on business days.

Is Flowhawk itself down? Check status.flowhawk.dev.

No data shows up

  • Check the endpoint: https://ingest.flowhawk.dev, not the app address.
  • Check the key: an Ingest key as Authorization: Bearer <key>. A revoked or mistyped key is refused.
  • Check service.name: unnamed services show as unknown_service.
  • Setup lists the services that reported in the last minutes and what's missing.

Telemetry is refused (HTTP 429)

  • The balance ran out and the grace period is over, or the spend cap was reached: top up or raise the cap in Settings > Usage. Ingest resumes within a minute.
  • The daily or per-second limit for your balance was reached: the response's Retry-After says when to try again; a top-up raises the daily limit.

Spans don't land in a flow

Open the flow in Settings > Business map and check that each step names the service and the route as your framework writes it (POST /orders/:id). Setup lists the routes with traffic that are not in any step yet, and drafts steps for them.

Stack traces show minified code

Upload source maps with an Upload key from CI, with the same release as the SDK's version. Settings > Source maps lists what arrived.