fb1368d1ef
* Added import and troubleshoot dashboards pages * Moved import dashboards to build dashboards folder * Updated import dashboards content * Updated manage dashboards page * Updated troublshooting dashboards page * Finalized text for Import dashboards and moved orphaned content to Sharing page * Made general copy edits to Troubleshooting dashboards * Moved More examples heading and content from Troubleshooting to Import * General copy edits to Troubleshooting * Fixed broken links and made small copy edits * Fixed broken link * Removed note and replaced with plain text description of Dashboards page Added to do for clarifying display of Shared with me section * Deleted orphaned export content; to be rolled in later * Copy edits * Updated Shared with me section * Copy edits * Apply suggestions from code review Co-authored-by: Jack Baldry <jack.baldry@grafana.com> --------- Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
3.0 KiB
| aliases | canonical | keywords | labels | menuTitle | title | description | weight | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
https://grafana.com/docs/grafana/latest/dashboards/troubleshoot-dashboards/ |
|
|
Troubleshoot dashboards | Troubleshoot dashboards | Learn how to troubleshoot common dashboard issues | 300 |
Troubleshoot dashboards
Use the following strategies to help you troubleshoot common dashboard problems.
Dashboard is slow
- Are you trying to render dozens (or hundreds or thousands) of time series on a graph? This can cause the browser to lag. Try using functions like
highestMax(in Graphite) to reduce the number of returned series. - Sometimes series names can be very large. This causes larger response sizes. Try using
aliasto reduce the size of the returned series names. - Are you querying many time series or a long time range? Both of these conditions can cause Grafana or your data source to pull in a lot of data, which may slow the dashboard down. Try reducing one or both of these.
- There could be high load on your network infrastructure. If the slowness isn't consistent, this may be the problem.
Dashboard refresh rate issues
By default, Grafana queries your data source every 30 seconds. However, setting a low refresh rate on your dashboards puts unnecessary stress on the backend. In many cases, querying this frequently isn't necessary because the data source isn't sending data often enough for there to be changes every 30 seconds.
We recommend the following:
- Only enable auto-refreshing on dashboards, panels, or variables if necessary. Users can refresh their browser manually.
- If you require auto-refreshing, then set the refresh rate to a longer time period that makes sense, such as once a minute, every 10 minutes, or every hour.
- Check the time range of your dashboard. If your dashboard has a longer time range, such as a week, then you really don't need automated refreshing and you should disable it.
Handling or rendering null data is wrong or confusing
Some applications publish data intermittently; for example, they only post a metric when an event occurs. By default, Grafana graphs connect lines between the data points, but this can be deceptive.
The graph in the following image has:
- Points and 3-point radius enabled to highlight where data points are actually present.
- Connect null values set to Always.
{{< figure src="/static/img/docs/troubleshooting/grafana_null_connected.png" max-width="1200px" alt="Graph with null values connected" >}}
The graph in this next image shows bars instead of lines and has the No value option under Standard options set to 0.
{{< figure src="/static/img/docs/troubleshooting/grafana_null_zero.png" max-width="1200px" alt="Graph with null values not connected" >}}
As you can see, there's a significant difference in the visualizations.