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 contact point，並在你的通知政策樹中加入一條全部符合的路由。這條路由符合每則警示並繼續往你現有的路由走，所以你目前的投遞不受影響，而你之後建立的警示規則會自動通知Polylane。觸發中的警示會落到你的工作區、被分流，並可啟動調查。

Polylane也會讀取每個儀表板，把每個面板查詢持續作為異常檢查執行，並為你儀表板遺漏的訊號探索關鍵查詢。

代理能做什麼

• 搜尋儀表板並讀取它們的面板定義與查詢
• 列出資料來源並執行健康檢查
• 透過Grafana的查詢代理執行PromQL、LogQL、TraceQL與其他資料來源原生的查詢
• 檢視警示規則、它們的即時狀態與健康度，以及此刻正在觸發的警示
• 讀取圖表註記，並為部署與事件時段建立新的註記

中斷連接

在Polylane中斷Grafana Cloud的連接；它會移除自己佈建的contact point與通知政策路由。然後在Grafana中刪除該服務帳戶權杖。如果該路由在Terraform中，請同時拿掉它。

每小時一次的調和會讓polylane contact point與它的全部符合政策路由保持存在。grafana_notification_policy資源管理整棵政策樹，所以省略該路由的Terraform apply會移除它，而調和會再把它加回來。把該路由作為你樹中的第一條政策，並設定continue = true讓你自己的路由仍能收到一切，contact point本身則留給Polylane：

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

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

警示規則不需要逐一設定：該路由符合每則警示。中斷整合的連接會移除contact point與該路由，所以請同時從Terraform設定中拿掉該路由。