如何解决Grafana配置云MySQL数据源出现db query error连接失败问题

正确配置步骤 #

• 提前准备云MySQL的有效信息：实例连接地址、服务端口（默认3306）、拥有目标库SELECT权限的账号密码、目标数据库名称。如果Grafana服务和云MySQL不在同一私有网络，必须使用云MySQL的公网连接地址。
• 配置云侧访问规则：在云厂商MySQL控制台的白名单/安全组规则中，放行Grafana服务器的公网出口IP的3306端口入站访问权限。
• 填写Grafana数据源配置项：
  • Host栏按连接地址:端口格式填写，示例：rm-xxxx.mysql.rds.tencentcs.com:3306
  • Database栏填写要对接的具体数据库名称
  • User、Password栏填写提前准备的云MySQL授权账号密码
  • 若云MySQL要求强制SSL连接，需在TLS/SSL配置区开启对应开关，并上传云厂商提供的SSL证书文件

连接报错排查方案 #

针对你遇到的db query error: failed to connect to server - please inspect Grafana server log for details报错，按以下顺序排查：

• 首先验证网络连通性：登录Grafana所在服务器，执行命令telnet 云MySQL连接地址 3306，如果连接失败优先排查云侧白名单、安全组、云MySQL公网访问开关是否开启的问题。
• 验证账号有效性：使用相同的连接地址、端口、账号密码、数据库名，通过本地MySQL客户端、mysql命令行工具尝试连接，确认可以正常登录并执行查询语句，排除账号密码错误、权限不足、数据库名填写错误的问题。
• 查看Grafana日志定位细节：如果上述两项检查都正常，查看Grafana服务日志（默认路径/var/log/grafana/grafana.log），搜索mysql相关的错误条目，可以得到更具体的报错原因，常见的包括SSL连接要求未满足、账号IP访问限制、云MySQL实例状态异常等。
• 补充建议：不要使用云MySQL的root账号对接Grafana，建议单独创建权限最小化的专用账号，仅开放目标库的SELECT权限，且仅允许Grafana的IP访问，避免安全风险。

内容的提问来源于stack exchange，提问作者New User