2016-10-21 04:01:34 -05:00
|
|
|
+++
|
|
|
|
|
title = "Troubleshooting"
|
|
|
|
|
description = "Guide to troubleshooting Grafana problems"
|
|
|
|
|
keywords = ["grafana", "troubleshooting", "documentation", "guide"]
|
|
|
|
|
type = "docs"
|
|
|
|
|
[menu.docs]
|
|
|
|
|
parent = "admin"
|
|
|
|
|
weight = 8
|
|
|
|
|
+++
|
|
|
|
|
|
2015-03-10 02:55:42 -05:00
|
|
|
|
|
|
|
|
# Troubleshooting
|
|
|
|
|
|
2017-09-07 09:55:36 -05:00
|
|
|
## Visualization & Query issues
|
|
|
|
|
|
|
|
|
|
{{< imgbox max-width="40%" img="/img/docs/v45/query_inspector.png" caption="Query Inspector" >}}
|
2017-04-28 04:16:05 -05:00
|
|
|
|
|
|
|
|
The most common problems are related to the query & response from you data source. Even if it looks
|
|
|
|
|
like a bug or visualization issue in Grafana it is 99% of time a problem with the data source query or
|
|
|
|
|
the data source response.
|
|
|
|
|
|
2017-09-07 09:55:36 -05:00
|
|
|
To check this you should use Query Inspector (new in Grafana v4.5). The query Inspector shows query requests and responses.
|
2017-09-07 09:32:55 -05:00
|
|
|
|
2017-09-07 09:55:36 -05:00
|
|
|
For more on the query insector read [this guide here](https://community.grafana.com/t/using-grafanas-query-inspector-to-troubleshoot-issues/2630). For
|
|
|
|
|
older versions of Grafana read the [how troubleshoot metric query issue](https://community.grafana.com/t/how-to-troubleshoot-metric-query-issues/50/2) article.
|
2017-04-28 04:16:05 -05:00
|
|
|
|
|
|
|
|
## Logging
|
|
|
|
|
|
|
|
|
|
If you encounter an error or problem it is a good idea to check the grafana server log. Usually
|
|
|
|
|
located at `/var/log/grafana/grafana.log` on unix systems or in `<grafana_install_dir>/data/log` on
|
|
|
|
|
other platforms & manual installs.
|
|
|
|
|
|
|
|
|
|
You can enable more logging by changing log level in you grafana configuration file.
|
|
|
|
|
|
|
|
|
|
## FAQ
|
|
|
|
|
|
|
|
|
|
Checkout the [FAQ](https://community.grafana.com/c/howto/faq) section on our community page for frequently
|
|
|
|
|
asked questions.
|
2015-03-10 02:55:42 -05:00
|
|
|
|
