Help and troubleshooting

Contact us

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

If Flowhawk itself seems down, check status.flowhawk.dev.

No data shows up

  • Send to https://ingest.flowhawk.dev, not to the app address.
  • Use an Ingest key, sent as Authorization: Bearer <key>. A revoked or mistyped key is refused.
  • Set service.name. A service without one shows up 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 header says when to try again, and 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.