Honeycomb
Lets an agent explore your Honeycomb observability data: list datasets and their columns, run queries over events and read the results, manage deploy markers, and inspect triggers, boards (dashboards), and SLOs.
Running a query is a three-step flow: create a query spec, start a query result from that query id, then poll the result until it is complete.
What it can do
| Method | What it does |
|---|---|
honeycomb_datasets_list | List all datasets in the environment. |
honeycomb_columns_list | List columns in a dataset (use __all__ for the environment). |
honeycomb_query_create | Create a saved query spec (calculations, time range, breakdowns, filters). |
honeycomb_query_result_create | Execute a query by id and start a query result. |
honeycomb_query_result_get | Poll a query result and read its data once complete. |
honeycomb_markers_list | List markers (e.g. deploy annotations) for a dataset. |
honeycomb_marker_create | Create a marker for a dataset. |
honeycomb_triggers_list | List triggers in a dataset. |
honeycomb_trigger_get | Get one trigger by id. |
honeycomb_boards_list | List boards (dashboards). |
honeycomb_board_get | Get one board by id. |
honeycomb_slos_list | List SLOs in a dataset. |
honeycomb_slo_get | Get one SLO by id. |
honeycomb_request | Generic passthrough to any Honeycomb endpoint for full API coverage. |
How to get your key
Honeycomb authenticates with an API key passed in the X-Honeycomb-Team header.
- Sign in at ui.honeycomb.io.
- Open your account or environment settings and find the API keys section (manage API keys docs).
- Create or copy a key and paste it into FlyMyAI. The key is scoped to one environment, so use the environment whose data you want to read.
Fields to fill
| FlyMyAI field | Where it comes from |
|---|---|
HONEYCOMB_API_KEY | Honeycomb -> Account / Environment -> API keys |
Troubleshooting
401 Unauthorized- the key is wrong or rotated. Create a new key in the Honeycomb environment settings.- Dataset or columns not found - the key is scoped to one environment; use the key for the environment that owns the dataset, and pass the exact dataset slug.
- Query result not ready -
honeycomb_query_result_createis asynchronous; keep pollinghoneycomb_query_result_getwith the result id untilcompleteis true. 403 Forbidden- the key lacks the required permission (e.g. creating markers needs a key with write access). Use a key with the right scope.
Links
We love our partners - FlyMy.AI builds with the best. Thanks, Honeycomb!