使用 Terraform 创建提醒政策

本文档介绍如何使用 Google Cloud Terraform 提供程序在 Google Cloud 项目中创建提醒政策。 Google Cloud Terraform 提供程序为提醒政策和通知渠道提供以下资源：

Terraform 是一种用于构建、更改和版本控制基础架构的工具。它使用配置文件来说明运行单个应用或整个基础架构所需的组件。 如需详细了解如何使用 Terraform，请参阅以下文档：

准备工作

如需获得使用 Terraform 创建提醒政策所需的权限，请让您的管理员为您授予项目的 Monitoring Editor (roles/monitoring.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需详细了解 Cloud Monitoring 角色，请参阅使用 Identity and Access Management 控制访问权限。

创建提醒政策

如需在 Google Cloud 项目中创建提醒政策，请执行以下操作：

  1. 安装和配置 Terraform。

  2. 在 Cloud Shell 中，前往包含 Terraform 配置的目录。

  3. 修改配置文件并添加提醒政策。

    例如，以下配置定义了一项提醒政策，该政策会在虚拟机实例的 CPU 利用率超过 50% 且持续 1 分钟以上时发送通知，并且每 30 分钟发送一次重复通知。

    resource "google_monitoring_alert_policy" "alert_policy" {
  display_name = "CPU Utilization > 50%"
  documentation {
    content = "The $${metric.display_name} of the $${resource.type} $${resource.label.instance_id} in $${resource.project} has exceeded 50% for over 1 minute."
  }
  combiner     = "OR"
  conditions {
    display_name = "Condition 1"
    condition_threshold {
        comparison = "COMPARISON_GT"
        duration = "60s"
        filter = "resource.type = \"gce_instance\" AND metric.type = \"compute.googleapis.com/instance/cpu/utilization\""
        threshold_value = "50"
        trigger {
          count = "1"
        }
    }
  }

  alert_strategy {
    notification_channel_strategy {
        renotify_interval = "1800s"
        notification_channel_names = [google_monitoring_notification_channel.email.name]
    }
  }

  notification_channels = [google_monitoring_notification_channel.email.name]

  user_labels = {
    severity = "warning"
  }
}

    在上面的示例中，notification_channels 字段定义了提醒政策的通知渠道。notification_channel_names 字段将相应通知渠道配置为发送重复通知。这两个字段都引用 display_name 为 email 的通知渠道（该渠道在 Terraform 配置中的其他位置定义）。如需了解详情，请参阅使用 Terraform 创建和管理通知渠道。

    您可以使用标签将提醒政策与 App Hub 应用相关联。如需了解详情，请参阅如何将提醒政策与 App Hub 应用相关联。

  4. 在 Cloud Shell 中，输入 terraform apply。

如需修改提醒政策，请进行修改，然后重新应用 Terraform 配置。如需了解详情，请参阅使用 Terraform 管理提醒政策。

后续步骤

  • 详细了解 Terraform。
  • 试用将Google Cloud Terraform 提供程序与 Cloud Monitoring 搭配使用的代码示例。
  • 查看 GitHub 上的 Google Cloud Terraform 提供程序仓库。
  • 提交 GitHub 问题以报告错误或提出有关 Terraform 的问题。