Grafana Cloud

连接Grafana Cloud，让智能体可以读取你的仪表盘、查询你的数据源并检视Grafana告警。

设置

1. 在Grafana Cloud门户中找到你的栈URL，形如**https://yourstack.grafana.net**。
2. 在你的Grafana栈中，打开Administration → Users and access → Service accounts。
3. 创建一个具有Editor角色的服务账户。Editor让智能体可以读取仪表盘、查询数据源和创建注释，并让Polylane可以订阅你的Grafana告警。
4. 为该服务账户添加一个令牌，并把两个值粘贴到Polylane中。Polylane针对你的栈验证它们并连接。

你的令牌在存储前加密，智能体永远看不到它。

Grafana Cloud免费层的栈在不活跃后会休眠。如果验证报告栈不可达，在浏览器中打开它一次然后重试。

告警与持续监控

连接时，Polylane在你的栈中配置一个Webhook联系点，并在你的通知策略树中添加一条兜底路由。该路由匹配每条告警并继续传递到你现有的路由，所以你当前的投递不受影响，而你之后创建的告警规则会自动通知Polylane。触发的告警落到你的工作区，得到分诊，并可以启动调查。

Polylane还会读取每个仪表盘，把每个面板的查询作为异常检查持续运行，并为你的仪表盘遗漏的信号发现关键查询。

智能体能做什么

• 搜索仪表盘并读取它们的面板定义和查询
• 列出数据源并运行健康检查
• 通过Grafana的查询代理运行PromQL、LogQL、TraceQL和其他数据源原生查询
• 检视告警规则、它们的实时状态和健康情况，以及当前正在触发的告警
• 读取图表注释，并为部署和故障窗口创建新注释

断开连接

在Polylane中断开Grafana Cloud；它会移除自己配置的联系点和通知策略路由。然后在Grafana中删除该服务账户令牌。如果该路由在Terraform中，请同时删掉它。

每小时一次的对账会保持polylane联系点及其兜底策略路由存在。grafana_notification_policy资源管理整个策略树，所以省略该路由的一次Terraform apply会移除它，而对账又会把它加回来。把该路由作为你树中的第一条策略，带上continue = true让你自己的路由仍然收到一切，并把联系点本身留给Polylane：

resource "grafana_notification_policy" "tree" {
  # ...

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

告警规则不需要逐条设置：该路由匹配每条告警。断开该集成会移除联系点和路由，所以请同时把该路由从Terraform配置中删掉。