远程设备Grafana连接ClickHouse Cloud失败：超时或插件健康检查失败

处理Connection Timed Out（连接超时） #

• 测试网络连通性：在运行Grafana的远程设备上，执行telnet ln5xtq1kbr.asia-southeast1.gcp.clickhouse.cloud 9440或nc -zv ln5xtq1kbr.asia-southeast1.gcp.clickhouse.cloud 9440，检查9440端口（ClickHouse Cloud默认TCP端口）是否能连通。如果不通，按以下方向排查：
  • 远程设备本地防火墙/安全组是否放行出站的9440端口
  • 设备所在网络的网关、路由器是否限制了9440端口的出站流量
  • 登录ClickHouse Cloud控制台，确认IP访问列表已添加远程设备的公网IP（未添加的话，ClickHouse Cloud会直接拒绝连接）
• 确认端口正确性：ClickHouse Cloud的TCP连接端口为9440，不要误填为HTTP协议的8123端口。

处理Plugin Health Check Failed（插件健康检查失败） #

• 升级ClickHouse插件：在Grafana的插件管理页面，检查ClickHouse数据源插件版本，升级到最新版以保证与ClickHouse Cloud的兼容性。
• 核对连接参数：
  • 用户名填ClickHouse Cloud提供的默认用户（如default），密码为创建服务时设置的数据库密码，而非控制台登录密码
  • 必须勾选SSL选项：ClickHouse Cloud强制要求SSL加密连接，TCP模式下未开启SSL会导致连接被拒绝
  • 连接地址仅填域名ln5xtq1kbr.asia-southeast1.gcp.clickhouse.cloud，不要添加http://或https://前缀
• 用客户端直接验证：在远程设备上执行ClickHouse客户端命令测试连接：clickhouse client --host ln5xtq1kbr.asia-southeast1.gcp.clickhouse.cloud --port 9440 --user default --password <你的数据库密码> --secure。如果客户端能成功连接，说明问题出在Grafana的配置细节；如果客户端也连不上，回到网络连通性的排查步骤。

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