本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

連接 Grafana

Grafana 整合可讓 AWS DevOps 代理程式在事件調查期間查詢 Grafana 執行個體中的指標、儀表板和提醒資料。此整合遵循兩個步驟：Grafana 的帳戶層級註冊，然後將其連接到個別客服人員空間。

為了提高安全性，Grafana 整合僅啟用唯讀工具。寫入工具已停用且無法啟用。這表示代理程式可以從 Grafana 執行個體查詢和讀取資料，但無法建立、修改或刪除任何 Grafana 資源，例如儀表板、提醒或註釋。如需詳細資訊，請參閱 Security in AWS DevOps Agent。

Grafana 要求

連接 Grafana 之前，請確定您有：

註冊 Grafana （帳戶層級）

Grafana 已在 AWS 帳戶層級註冊，並在該帳戶中的所有客服人員空間之間共用。

步驟 1：設定 Grafana

步驟 2：檢閱並提交 Grafana 註冊

將 Grafana 新增至代理程式空間

在帳戶層級註冊 Grafana 之後，您可以將其連線至個別客服人員空間：

設定 Grafana 警示 Webhook

您可以將 Grafana 設定為在透過 Grafana 聯絡點傳送 Webhook 來提醒火災時自動觸發 AWS DevOps 代理程式調查。如需 Webhook 身分驗證方法和憑證管理的詳細資訊，請參閱 透過 Webhook 叫用 DevOps 代理程式。

步驟 1：建立自訂通知範本

在您的 Grafana 執行個體中，導覽至警示 > 聯絡點 > 通知範本，並使用下列內容建立新的範本：

{{ define "devops-agent-payload" }}
{
  "eventType": "incident",
  "incidentId": "{{ (index .Alerts 0).Labels.alertname }}-{{ (index .Alerts 0).Fingerprint }}",
  "action": "{{ if eq .Status "resolved" }}resolved{{ else }}created{{ end }}",
  "priority": "{{ if eq .Status "resolved" }}MEDIUM{{ else }}HIGH{{ end }}",
  "title": "{{ (index .Alerts 0).Labels.alertname }}",
  "description": "{{ (index .Alerts 0).Annotations.summary }}",
  "service": "{{ if (index .Alerts 0).Labels.job }}{{ (index .Alerts 0).Labels.job }}{{ else }}grafana{{ end }}",
  "timestamp": "{{ (index .Alerts 0).StartsAt }}",
  "data": {
    "metadata": {
      {{ range $k, $v := (index .Alerts 0).Labels }}
      "{{ $k }}": "{{ $v }}",
      {{ end }}
      "_source": "grafana"
    }
  }
}
{{ end }}

此範本會將 Grafana 警示格式化為 AWS DevOps 代理程式預期的 Webhook 承載結構。它會將提醒標籤、註釋和狀態映射到適當的欄位中，並包含所有提醒標籤作為中繼資料。

步驟 2：建立 Webhook 聯絡點

步驟 3：將聯絡點指派給通知政策

當相符的提醒觸發時，Grafana 會將格式化的承載傳送至 AWS DevOps 代理程式，自動開始調查。

限制

Amazon Managed Grafana 考量事項

如果您使用的是 Amazon Managed Grafana (AMG)，請注意下列限制：

管理 Grafana 連線