Files
Usman AhmadandChristopher Moyer bc88796e6e Created Troubleshooting guide for MySQL data source plugin (#114737)
* created troubleshooting guide for mysql data source plugin

Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com>

* Apply suggestions from code review

thanks for the code review

Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com>

* rename file from _index.md to index.md

Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com>

* Update docs/sources/datasources/mysql/troubleshoot/index.md

---------

Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com>
Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com>
2025-12-11 16:42:09 +01:00

3.8 KiB

description, keywords, labels, menuTitle, title, weight, refs
description keywords labels menuTitle title weight refs
Learn how to troubleshoot common problems with the Grafana MySQL data source plugin
grafana
mysql
query
products
cloud
enterprise
oss
Troubleshoot Troubleshoot common problems with the Grafana MySQL data source plugin 40
variables variable-syntax-advanced-variable-format-options annotate-visualizations explore query-transform-data panel-inspector query-editor alert-rules template-annotations-and-labels configure-standard-options
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/variables/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/variable-syntax/#advanced-variable-format-options
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/variables/variable-syntax/#advanced-variable-format-options
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/explore/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/explore/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/query-transform-data/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/query-transform-data/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/panel-inspector/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/panel-inspector/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/query-transform-data/#query-editors
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/query-transform-data/#query-editors
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/alert-rules/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/alerting-rules/templates/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/templates/
pattern
/docs/grafana/
destination
/docs/grafana/<GRAFANA_VERSION>/panels-visualizations/configure-standard-options/

Troubleshoot common problems with the Grafana MySQL data source plugin

This page lists common issues you might experience when setting up the Grafana MySQL data source plugin.

My data source connection fails when using the Grafana MySQL data source plugin

  • Check if the MySQL server is up and running.
  • Make sure that your firewall is open for MySQL server (default port is 3306).
  • Ensure that you have the correct permissions to access the MySQL server and also have permission to access the database.
  • If the error persists, create a new user for the Grafana MySQL data source plugin with correct permissions and try to connect with it.

What should I do if I see "An unexpected error happened" or "Could not connect to MySQL" after trying all of the above?

  • Check the Grafana logs for more details about the error.
  • For Grafana Cloud customers, contact support.