使用地形建立和管理警示資源

為您的 CI 管道建立新的服務帳戶。

指派角色「存取警示規則佈建 API」。

創建一個新的服務帳戶令牌。

命名並保存令牌以在地形中使用。

將此代碼塊複製到本地計算機上的 .tf 文件中。使用您的 Slack 網絡掛鉤網址（或其他聯繫人）替換 < slack-webhook-url >

此範例會建立一個連絡人，將警示通知傳送給 Slack。

resource "grafana_contact_point" "my_slack_contact_point" {
    name = "Send to My Slack Channel"

    slack {
        url = <slack-webhook-url>
        text = <<EOT
{{ len .Alerts.Firing }} alerts are firing!

Alert summaries:
{{ range .Alerts.Firing }}
{{ template "Alert Instance Template" . }}
{{ end }}
EOT
    }
}

在文字欄位中輸入通知的文字。

該text字段支持 GO 風格的模板。這可讓您直接在 Terraform 中管理 Grafana 警示通知範本。

執行 terraform apply 命令。

前往 Grafana 使用者介面並檢查聯絡點的詳細資料。

您無法從 UI 編輯透過 Terraform 佈建的資源。這樣可以確保您的警報堆棧始終與代碼保持同步。

按一下「測試」以確認接觸點是否正常運作。

將此代碼塊複製到本地計算機上的 .tf 文件中。

在此範例中，警示會依據分組alertname，這表示來自警示的任何通知都會分組到相同的 Slack 訊息中。

如果您想要以不同的方式路由傳送特定通知，您可以新增子原則。子原則可讓您根據標籤比對，將路由套用至不同的警示。在此範例中，我們將靜音計時套用至標籤為 a=b 的所有警示。

resource "grafana_notification_policy" "my_policy" {
    group_by = ["alertname"]
    contact_point = grafana_contact_point.my_slack_contact_point.name

    group_wait = "45s"
    group_interval = "6m"
    repeat_interval = "3h"

    policy {
        matcher {
            label = "a"
            match = "="
            value = "b"
        }
        group_by = ["..."]
        contact_point = grafana_contact_point.a_different_contact_point.name
        mute_timings = [grafana_mute_timing.my_mute_timing.name]

        policy {
            matcher {
                label = "sublabel"
                match = "="
                value = "subvalue"
            }
            contact_point = grafana_contact_point.a_third_contact_point.name
            group_by = ["..."]
        }
    }
}

在 mute_時間欄位中，將靜音時間連結至您的通知原則。

執行 terraform apply 命令。

前往 Grafana 使用者介面並檢查通知政策的詳細資料。

按一下「測試」以確認通知點是否正常運作。

將此代碼塊複製到本地計算機上的 .tf 文件中。

在此範例中，警示通知會在週末靜音。

resource "grafana_mute_timing" "my_mute_timing" {
    name = "My Mute Timing"

    intervals {
        times {
          start = "04:56"
          end = "14:17"
        }
        weekdays = ["saturday", "sunday", "tuesday:thursday"]
        months = ["january:march", "12"]
        years = ["2025:2027"]
    }
}

執行 terraform apply 命令。

前往 Grafana 使用者介面並檢查靜音時間的詳細資訊。

使用mute_timings欄位參考通知政策中新建立的靜音時間。這會將您的靜音時間套用至部分或全部通知。

按一下「測試」以確認靜音計時是否正常運作。

建立要查詢的資料來源，並建立要儲存規則的資料夾。

在此範例中，會使用設定要測試的 TestData 資料來源資料來源。

可以針對 Grafana 中的任何後端資料來源定義警示。

resource "grafana_data_source" "testdata_datasource" {
    name = "TestData"
    type = "testdata"
}

resource "grafana_folder" "rule_folder" {
    title = "My Rule Folder"
}

定義警示規則。

如需警示規則的詳細資訊，請參閱如何建立 Grafana 管理的警示。

建立包含一或多個規則的規則群組。

在此範例中，會使用grafana_rule_group資源群組。

resource "grafana_rule_group" "my_rule_group" {
    name = "My Alert Rules"
    folder_uid = grafana_folder.rule_folder.uid
    interval_seconds = 60
    org_id = 1

    rule {
        name = "My Random Walk Alert"
        condition = "C"
        for = "0s"

        // Query the datasource.
        data {
            ref_id = "A"
            relative_time_range {
                from = 600
                to = 0
            }
            datasource_uid = grafana_data_source.testdata_datasource.uid
            // `model` is a JSON blob that sends datasource-specific data.
            // It's different for every datasource. The alert's query is defined here.
            model = jsonencode({
                intervalMs = 1000
                maxDataPoints = 43200
                refId = "A"
            })
        }

        // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
        data {
            datasource_uid = "__expr__"
            // You can also create a rule in the UI, then GET that rule to obtain the JSON.
            // This can be helpful when using more complex reduce expressions.
            model = <<EOT
{"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
EOT
            ref_id = "B"
            relative_time_range {
                from = 0
                to = 0
            }
        }

        // Now, let's use a math expression as our threshold.
        // We want to alert when the value of stage "B" above exceeds 70.
        data {
            datasource_uid = "__expr__"
            ref_id = "C"
            relative_time_range {
                from = 0
                to = 0
            }
            model = jsonencode({
                expression = "$B > 70"
                type = "math"
                refId = "C"
            })
        }
    }
}

前往 Grafana 使用者介面並檢查您的警示規則。

您可以查看警示規則是否正在觸發。您也可以查看每個警示規則查詢階段的視覺效果。

當警示觸發時，Grafana 會透過您定義的原則路由傳送通知。

例如，如果您選擇 Slack 作為聯絡點，Grafana 的嵌入式警示管理員會自動將訊息發佈給 Slack。