Common problems with Grafana
When you add the integration
| What you see | What to do |
|---|---|
grafana.example.com refused the credentials (401). Check the token, and that it has not expired. Fix the field above, or save anyway if the source is only unreachable for now. | The token is wrong, expired or deleted. Create a new one: see Create a Grafana service account token. |
No server answers to the name grafana.example.com. Check its spelling against the address you open in your browser. If it is right, Astrolabe cannot see this server: tell your company's Astrolabe administrator. Fix the field above, or save anyway if the source is only unreachable for now. | Check Grafana address: the address you open in your browser, with https://. If it is right, your Grafana is not reachable from Astrolabe. |
In Administration
| What you see | What to do |
|---|---|
In Company connections › Grafana, State says grafana.example.com refused the credentials (401). Check the token, and that it has not expired. | Click the Edit Token icon, click Replace, paste a new token, click Test connection, then Save. |
In Problems: grafana.example.com refuses the credentials (401). The token may be wrong or expired. | Click Fix it to open the integration, replace the token, then click Check again. |
When the license does not cover Grafana
| What you see | What to do |
|---|---|
| In Administration › Plugins, the Grafana card says Requires the Premium license, and the switch is grey | Your license does not cover Grafana. Add a license that does, then switch the plugin on. |
| In Administration › Plugins, the Grafana card says Not licensed, and Problems shows Switched on, but the license does not cover it. | Click Fix it: the license screen opens. Add a license that covers Grafana. |
On the card, Your license does not cover Grafana. Grafana is part of a higher license: its data stays closed until the license covers it. An administrator reads which one in Administration › Licensing. and a link Open the license | Click Open the license: Administration › Licensing opens. Add a license that covers Grafana. |
On the card, the same text with Only an Astrolabe administrator can fix this: tell them what this message says. and no link | You are not an administrator. Send this message to yours. |
In Add a card, the title Grafana requires the Premium license, then Its cards stay closed until the license covers it. An administrator reads which license it needs in Administration › Licensing. and a link Open the license | Same cause. Click Open the license, then add a license that covers Grafana. |
On the Grafana card of Company connections › Webhooks, 1 events reached nobody: the license does not cover this source, so its events are dropped. See Administration › Licensing. | Grafana called Astrolabe, and Astrolabe dropped the alert. Add a license that covers Grafana. |
On the Monitoring tab, Your license does not cover Grafana. or The license could not be checked. | The tab says the same as the card: add a license that covers Grafana, or try again in a minute. Not verified on an instance yet: the tab is not shown once the license no longer covers Grafana. |
On the Monitoring tab of a component
| What you see | What to do |
|---|---|
| No Monitoring tab | Add the grafana/dashboard or grafana/alert-label-selector annotation to the component, and turn on the Grafana plugin in Administration › Plugins. |
Grafana refused the token. The token may have expired or been revoked: replace it in Administration › Company connections › Grafana (or in My account › My accounts if it is your own). and a link Open the Grafana integration | Click the link and replace the token. |
No alert rule carries the labels service=shop-api. | No alert rule of Grafana has this label. Check grafana/alert-label-selector against the labels of your rules in Grafana. |
The dashboard shop-api-overview or one of its panels does not exist, or is out of the token reach: check the grafana/dashboard and grafana/panels annotations. | Check the UID in grafana/dashboard and the ids in grafana/panels, and that the service account can see the dashboard. |
On the card
| What you see | What to do |
|---|---|
Grafana refused the token. The token may have expired or been revoked: replace it in Administration › Company connections › Grafana (or in My account › My accounts if it is your own). | Click Open the Grafana integration and replace the token. |
| No alert in trouble | Nothing to fix: no rule fires, fails or lacks data. |
When the tab says a module is missing
| What you see | What to do |
|---|---|
Astrolabe does not offer this Grafana feature on this instance. and A module is missing from this Astrolabe installation. Tell your Astrolabe administrator. | The integration may be connected and the plugin on, but this installation of Astrolabe lacks the module that serves Grafana. Tell your Astrolabe administrator. Nothing to change on the component. |
Not verified on an instance yet: this message needs an installation that lacks the module.
Still stuck?
Write to support@forgeit.fr with the name of the component and its Grafana dashboard.