Grafana API无法获取告警通知及完整仪表盘数据问题

问题现象 #

尝试通过API导出告警通知、数据源与仪表盘资源时，调用/api/alert-notifications接口仅返回空数组[]，调用/api/dashboards接口仅返回仪表盘文件夹名称，仅/api/datasources/接口可正常返回全部数据源信息。

预期结果 #

期望接口可返回所有告警通知及其配置参数、完整的仪表盘详情信息。

复现步骤 #

通过Helm全新部署Grafana后，创建任意仪表盘、数据源或告警通知规则即可复现该问题。

已尝试排查操作 #

• 测试API密钥认证、用户名密码认证方式，问题未解决
• 切换不同组织、配置不同操作权限，问题未解决

环境信息 #

Grafana version: open source 8.5.3
Data source type & version: prometheus 2.34.0/ loki 2.4.2
OS Grafana is installed on: helm installation
User OS & Browser: manjaro kde, curl/postman
Grafana plugins: json

根因说明与解决方案 #

该问题由Grafana 8.x版本的接口逻辑变更、默认配置切换导致，和权限配置无关：

• 告警接口返回空的原因：/api/alert-notifications是旧版Legacy告警模块的专属接口，Grafana 8.5版本默认启用*统一告警（Unified Alerting）*模块，新建的告警联系人、通知规则都存储在统一告警模块下，旧接口不会读取这部分数据，因此返回空数组。需要获取全量告警通知配置时，替换调用统一告警对应的接口/api/v1/provisioning/contact-points即可。
• 仪表盘接口仅返回文件夹信息的原因：/api/dashboards接口本身的设计就是仅返回仪表盘元数据（包含名称、UID、所属文件夹信息），不携带完整的面板、查询规则配置。要导出完整仪表盘详情，需要先调用该接口拿到所有仪表盘的UID，再逐个调用/api/dashboards/uid/<实际仪表盘UID>拉取全量配置。
• 额外排查点：调用API拉取非默认组织（Org ID=1）下的资源时，必须在请求头中携带X-Grafana-Org-Id: <对应组织ID>，即使API密钥配置了全组织权限，未携带该头时默认只会查询主组织下的资源，会导致资源漏返回。

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