Troubleshooting on Grafana Labs

Send a panel to Grafana Labs support

Fri, 03 Apr 2026 19:43:06 +0000

Send a panel to Grafana Labs support

When you encounter problems with any of your visualizations, you can send the panel JSON model to Grafana Labs Technical Support and request help with troubleshooting your issue.

The panel that you send includes all query response data and all visualizations settings. Upon receiving your panel, Grafana Labs Technical Support imports your data into a local version of Grafana and begins researching your problem.

Open the dashboard that contains the panel you want to send to Grafana Labs.
Hover over any part of the panel to display the actions menu on the top right corner.
Click the menu and select More > Get help.

Grafana opens a standalone support dashboard that contains the data you are sending to Grafana Labs Technical Support.

If you enable iframes, the support dashboard includes the visualization that looks similar to the following image.
To send the panel data to Grafana Labs via Github:

a. Click Copy to clipboard.

b. In the Grafana/Grafana repository, create an issue, and paste the contents of the support dashboard.
To send the panel data to Grafana Labs via a support ticket:

a. Click Dashboard.

Grafana downloads the support dashboard to a TXT file.

b. Attach the TXT file to a support ticket that you send to Grafana Labs Technical Support.

Send a support bundle to Grafana Labs support

Fri, 03 Apr 2026 19:43:06 +0000

Send a support bundle to Grafana Labs support

When you encounter problems with your Grafana instance, you can send us a support bundle that contains information about your Grafana instance, including:

Grafana version
Installed plugins
Grafana configuration
Deployed database information and migrations

Note: The Support Bundle is available on Grafana instances running 9.5 and above.

Available support bundle components

A support bundle can include any of the following components:

Usage statistics: Usage statistic for the Grafana instance
User information: A list of users of the Grafana instance
Database and Migration information: Database information and migration log
Plugin information: Plugin information for the Grafana instance
Basic information: Basic information about the Grafana instance (version, memory usage, and so on)
Settings: Settings for the Grafana instance
SAML: Healthcheck connection and metadata for SAML (only displayed if SAML is enabled)
LDAP: Healthcheck connection and metadata for LDAP (only displayed if LDAP is enabled)
OAuth2: Healthcheck connection and metadata for each OAuth2 Provider supporter (only displayed if OAuth provider is enabled)

Before you begin

To follow these instructions, you need the following permissions:

In Grafana Cloud, you need the organization administrator role.
In Grafana on-premises, you need the Grafana server administrator role.

Note that you can set server_admin_only configuration option to false to allow organization administrators to access support bundles in Grafana on-premises.

Steps

To generate a support bundle and send the support bundle to Grafana Labs via a support ticket:

Click the Help icon.
Click Support Bundles.
Click New Support Bundle.
Select the components that you want to include in the support bundle.
Click Create.
After the support bundle is ready, click Download.

Grafana downloads the support bundle to an archive (tar.gz) file.
Attach the archive (tar.gz) file to a support ticket that you send to Grafana Labs Technical Support.

Support bundle configuration

You can configure the following settings for support bundles in the Grafana configuration file:

[support_bundles]
# Enable support bundle creation (default: true)
enabled = true
# Only server admins can generate and view support bundles. When set to false, organization admins can generate and view support bundles (default: true)
server_admin_only = true
# If set, bundles will be encrypted with the provided public keys separated by whitespace
public_keys = ""

Encrypting a support bundle

Support bundles can be encrypted with age before they are sent to recipients. This is useful when you want to send a support bundle to Grafana through a channel that is not private.

Generate a key pair

Ensure age is installed on your system.

$ age-keygen -o key.txt
Public key: age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p

Support bundle encryption

Ensure age is installed on your system.

Add the public key to the public_keys setting in the support_bundle section of the Grafana configuration file.

[support_bundles]
public_keys = "age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p"

Multiple public keys can be defined by separating them with whitespace. All included public keys will be able to decrypt the support bundle.

Example:

[support_bundles]
public_keys = "age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p age1yu8vzu554pv3klw46yhdv4raz36k5w3vy30lpxn46923lqngudyqvxacer"

When you restart Grafana, new support bundles will be encrypted with the provided public keys. The support bundle file extension is tar.gz.age.

Decrypt a support bundle

Ensure age is installed on your system.

Execute the following command to decrypt the support bundle:

age --decrypt -i keyfile -o output.tar.gz downloaded.tar.gz.age

Example:

age --decrypt -i key.txt -o data.tar.gz af6684b4-d613-4b31-9fc3-7cb579199bea.tar.gz.age

Generate a HAR capture to send to Grafana Labs support

Fri, 03 Apr 2026 19:43:06 +0000

Troubleshoot with HAR captures

Support may request information about the network requests your browser generated in the form of a HAR file.

Important: HAR files can contain sensitive information, including cookies, session data, personal information, and sometimes credentials or tokens entered during troubleshooting. Before sharing a HAR file, make sure you review or sanitize it. You can then attach the redacted HAR file to your Grafana Support ticket.

To generate a HAR capture, follow the steps for your browser:

Chrome

In your Chrome browser, go to the page where the issue is occurring.
Click the menu icon and go to More Tools > Developer Tools.
In the drawer that opens, click the Network tab.
In the upper left hand corner of the drawer, make sure the round Record button is red. If it’s grey, click the button to begin recording.
Select the Preserve log option box if it isn’t already selected.
Click the grey crossed circle button to clear any existing requests from the panel.
Reproduce the issue while recording the network requests.
Click the download button to download the HAR file.
Upload the HAR file to your Grafana Support ticket for investigation.

Firefox

In your Firefox browser, go to the page where the issue is occurring.
Click the menu icon and go to More Tools > Web Developer Tools.
In the drawer that opens, click the Network tab.
In the upper left corner of the drawer, click the trash can icon to clear any existing requests from the recording.
Reproduce the issue while recording the network requests.
To save the HAR file, click the gear icon in the upper right hand corner of the panel and select Save All As HAR.
Upload the HAR file to your Grafana Support ticket for investigation.

Safari

In your Safari browser, go to the page where the issue is occurring.
Open the Develop menu option and select Show Web Inspector.
Note
The Show features for web developers option needs to be enabled for the Develop option to appear. For more information, refer to Use the developer tools in the Develop menu in Safari on Mac.
In the panel that appears, click the Network tab.
In the upper right corner of the panel, click the trash can icon to clear any existing requests from the recording.
Reproduce the issue while recording the network requests.
Click the Export button to save the HAR file:
Upload the HAR file to your Grafana Support ticket for investigation.

Edge

In your Edge browser, go to the page where the issue is occurring.
Click the … button and go to More Tools > Developer Tools.
In the panel that appears, click on the Network tab.
In the upper left hand corner of the panel, make sure the round Record button is red. If it’s grey, click the button to begin recording
Verify that the Preserve log option box is checked.
Click the grey crossed circle button to clear any existing requests from the panel.
Reproduce the issue while the network requests are recorded.
Click the download button to save the HAR file:
Upload the HAR file to your Grafana Support ticket for investigation.