# Honeycomb

> Explore Honeycomb observability data - datasets, queries, markers, triggers, boards, and SLOs - via the Honeycomb API.

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.

1. Sign in at [ui.honeycomb.io](https://ui.honeycomb.io).
2. Open your account or environment settings and find the **API keys** section ([manage API keys docs](https://docs.honeycomb.io/configure/environments/manage-api-keys/)).
3. 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_create` is asynchronous; keep polling `honeycomb_query_result_get` with the result id until `complete` is 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

- [Honeycomb](https://www.honeycomb.io)
- [Honeycomb API reference](https://docs.honeycomb.io/api/)
- [Manage API keys](https://docs.honeycomb.io/configure/environments/manage-api-keys/)