Documentation Plugins Honeycomb

Honeycomb data source for Grafana

The Honeycomb data source for Grafana allows you to query and visualize Honeycomb metrics and link to Honeycomb traces from within Grafana.

Before you begin

To use this data source, you need the following:

• An active Honeycomb Enterprise team
• A Grafana Cloud Free, Advanced, or Trial account, or an activated Grafana Enterprise license
• To query SLO report data, a Honeycomb Enterprise plan

Known limitations

The Honeycomb data source has the following limitations:

• The Honeycomb API this data source is developed against is not yet generally available. It may cause unexpected behavior in the data source.
• This data source does not yet support ad-hoc queries.
• Due to API limitations, the variable editor can only return the first 1000 unique values for a selected column.
• Due to API limitations, the data source can only query the last 7 days’ worth of data.
• The use of __all__ as the dataset slug to list all columns is not supported for classic environments, per Honeycomb documentation.

Install the data source plugin

To install the data source, refer to Installation.

Verify that the plugin is installed

To verify the plugin is installed:

1. In Grafana from the left-hand menu, navigate to Configuration > Data sources.
2. From the top-right corner, click the Add data source button.
3. Search for Honeycomb in the search field, and hover over the Honeycomb search result.
4. Click the Select button for Honeycomb.
   • If you can click the Select button, then it is installed.
   • If the button is missing or disabled, then the plugin is not installed. Check to see if your Grafana Enterprise license is valid, and reinstall the plugin. If you still need help, contact Grafana Labs.

Get started

Once you have installed the plugin, refer to the following documentation to get started:

• Configure the Honeycomb data source - Set up your API key, connection settings, and provisioning options.
• Query editor - Learn how to build Metrics, SLO, and Raw queries.
• Template variables - Create dynamic dashboards with variables.
• Troubleshooting - Resolve common issues and errors.

Import a dashboard

The Honeycomb data source includes pre-built dashboards to help you get started.

To find and import the available dashboards:

1. Go to Connections > Data sources.
2. Select the Honeycomb data source.
3. Select the Dashboards tab to see the available pre-built dashboards.
4. 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.

Learn more

• Configure and use Templates and variables
• Add Transformations
• Explore the Honeycomb API documentation