Honeycomb data source
The Honeycomb data source for Grafana lets you query and visualize Honeycomb metrics and open related Honeycomb queries for further exploration, including linking into the Honeycomb UI for traces and deeper analysis.
Note
The Honeycomb data source is an Enterprise plugin. It’s available with a Grafana Cloud Pro or Advanced plan and Grafana Enterprise. For installation instructions, refer to Install and upgrade the Honeycomb data source plugin.
Supported features
Requirements
The Honeycomb data source has the following requirements:
- Grafana version 11.6.7 or later.
- A Grafana Cloud Pro or Advanced plan or an activated self-managed Grafana Enterprise license.
- An active Honeycomb Enterprise team.
- To query SLO report data (budget remaining and compliance), a Honeycomb Enterprise plan.
Known limitations
The Honeycomb data source has the following limitations:
- Changes to the Honeycomb API may occasionally affect data source behavior.
- You can’t use the Grafana Ad hoc filters feature with this data source.
- Due to API limitations, the variable editor can only return the first 1000 unique values for a selected column.
- By default, the data source queries the last 7 days of data due to Honeycomb API limitations. You can adjust this with the Time Window (days) advanced setting.
- The use of
__all__as the dataset slug to list all columns isn’t supported for classic environments, per Honeycomb documentation.
Get started
The following documents help you get started:
- Install and upgrade the Honeycomb data source plugin
- Configure the Honeycomb data source
- Honeycomb query editor
- Template variables
- Annotations
- Alerting
- Troubleshooting
Additional features
After configuring the data source, you can:
- Use Explore to query data without building a dashboard.
- Use the Query with Assistant button in the query editor for AI-powered help building and refining Honeycomb queries. Refer to Grafana Assistant.
- Add Transformations to manipulate query results.
- Set up Alerting rules using any Honeycomb query type.
- Add annotations that overlay event markers on panels.
Pre-built dashboards
The Honeycomb data source includes a pre-built Honeycomb (demo) dashboard to help you get started.
To find and import the available dashboards:
- Go to Connections > Data sources.
- Select the Honeycomb data source.
- Select the Dashboards tab to see available pre-built dashboards.
- Click Import next to the dashboard you want to add.
After importing, your dashboards appear in the Dashboards menu.
For more information, refer to Import a dashboard.
Plugin updates
Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Administration > Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.
Note
On Grafana Cloud, the Honeycomb plugin is managed by Grafana and updates automatically. On self-managed Grafana, you must update Enterprise plugins manually. Refer to Version and upgrade guidance.
