Grafana OSS OnCall连接Grafana Cloud失败：Invalid Token报错求助

一、排查Token有效性 #

• 确认使用的是Grafana Cloud OnCall专属API Token，而非Grafana Cloud通用组织Token，二者权限不互通。生成Token时需勾选oncall:admin或oncall:write权限。
• 复制Token时避免带入空格、换行等多余字符，建议直接从Cloud控制台复制后粘贴到本地配置框。

二、修正环境变量配置 #

默认docker-compose.yaml可能未正确加载自定义环境变量，需调整配置：

1. 打开docker-compose.yaml，定位到grafana-oncall服务块，将Token变量添加到environment节点（注意核心变量是GRAFANA_CLOUD_ONCALL_TOKEN，API_URL默认值无需修改，除非你使用私有部署的Cloud OnCall）：

services:
  grafana-oncall:
    image: grafana/oncall:latest
    environment:
      - GRAFANA_CLOUD_ONCALL_TOKEN=你的Cloud OnCall API Token
      - GRAFANA_CLOUD_ONCALL_API_URL=https://oncall.grafana.net
    # 保留原有其他配置

2. 重启服务使配置生效：

docker-compose down && docker-compose up -d

3. 进入本地OnCall设置页，确认Cloud配置项已显示，若仍未出现，检查yaml文件的缩进格式是否正确。

三、匹配版本兼容性 #

本地OnCall镜像版本需与Grafana Cloud OnCall版本尽量一致，避免API兼容问题。可在docker-compose中指定对应版本标签，例如：

image: grafana/oncall:v1.3.0

（版本号需替换为Grafana Cloud OnCall控制台显示的当前版本）

四、手动验证API连通性 #

用curl测试本地服务器到Cloud OnCall的网络与Token有效性：

curl -H "Authorization: Bearer 你的Cloud OnCall API Token" https://oncall.grafana.net/api/v1/teams/

• 返回正常JSON数据：网络与Token无问题，问题出在本地OnCall配置。
• 返回401：Token无效或权限不足。
• 返回超时/连接失败：检查服务器防火墙、代理是否允许访问oncall.grafana.net。

五、查看调试日志 #

默认日志级别较低，无法输出调试信息，调整日志级别后重启服务：

services:
  grafana-oncall:
    environment:
      - LOG_LEVEL=DEBUG
    # 其他配置不变

查看详细日志：

docker-compose logs -f grafana-oncall

从日志中可获取API请求的Token传递、响应状态等细节，辅助定位问题。

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