如何使用Terraform创建Azure Application Insights Teams告警？

一、前置准备 #

• 获取Teams频道Webhook URL：
  1. 打开目标Teams频道，点击右上角「...」→「连接器」
  2. 搜索「Incoming Webhook」，点击「添加」→「配置」
  3. 命名后点击「创建」，复制生成的Webhook URL（务必保密）
• 安装Terraform：
  下载对应系统的安装包并配置环境变量，执行terraform version验证安装成功
• 配置云平台凭证：
  以Azure为例，安装Azure CLI后执行az login完成登录；若为AWS，配置~/.aws/credentials或通过AWS CLI登录
• 确认应用资源信息：
  记录三个目标应用的云资源ID（如Azure App Service的资源ID）或资源名称、所属资源组

二、Terraform代码实现（以Azure App Service为例） #

1. 目录结构 #

创建单独的Terraform工作目录，包含以下文件：

• main.tf：核心资源定义
• variables.tf：变量声明
• terraform.tfvars：敏感变量赋值（请勿提交至版本控制）

2. 变量声明（variables.tf） #

variable "teams_webhook_url" {
  type        = string
  description = "Teams频道的Incoming Webhook地址"
  sensitive   = true # 标记为敏感变量，避免输出泄露
}

variable "app_service_ids" {
  type        = list(string)
  description = "需要监控的3个App Service资源ID列表"
}

variable "resource_group_name" {
  type        = string
  description = "应用所属的资源组名称"
}

3. 核心资源定义（main.tf） #

# 创建Teams告警动作组
resource "azurerm_monitor_action_group" "teams_alert_group" {
  name                = "teams-error-alert-action-group"
  resource_group_name = var.resource_group_name
  short_name          = "teams-alert"

  # 添加Teams Webhook接收器
  webhook_receiver {
    name                    = "teams-webhook-receiver"
    service_uri             = var.teams_webhook_url
    use_common_alert_schema = true # 使用通用告警格式，Teams可直接解析
  }
}

# 循环为每个应用创建错误告警规则
resource "azurerm_monitor_log_alert" "app_error_alerts" {
  count               = length(var.app_service_ids)
  name                = "app-error-alert-${element(split("/", var.app_service_ids[count.index]), length(split("/", var.app_service_ids[count.index]))-1)}"
  resource_group_name = var.resource_group_name
  scopes              = [var.app_service_ids[count.index]]
  description         = "监测到${element(split("/", var.app_service_ids[count.index]), length(split("/", var.app_service_ids[count.index]))-1)}应用日志中出现错误"

  # 告警规则：查询应用日志中的Error级别条目
  criteria {
    query = <<-QUERY
      AppServiceConsoleLogs
      | where Level == "Error"
      | where _ResourceId == "${var.app_service_ids[count.index]}"
      | summarize error_count = count() by bin(TimeGenerated, 5m)
      | where error_count > 0
    QUERY
    query_type        = "ResultCount"
    operator          = "GreaterThan"
    threshold         = 0
    time_aggregation  = "Total"
    window_size       = "PT5M" # 每5分钟检查一次日志
  }

  # 关联动作组，触发时发送告警到Teams
  action {
    action_group_id = azurerm_monitor_action_group.teams_alert_group.id
  }

  enabled = true # 启用告警规则
}

4. 敏感变量赋值（terraform.tfvars） #

teams_webhook_url = "你的Teams Webhook URL"
app_service_ids = [
  "/subscriptions/你的订阅ID/resourceGroups/资源组名称/providers/Microsoft.Web/sites/应用1名称",
  "/subscriptions/你的订阅ID/resourceGroups/资源组名称/providers/Microsoft.Web/sites/应用2名称",
  "/subscriptions/你的订阅ID/resourceGroups/资源组名称/providers/Microsoft.Web/sites/应用3名称"
]
resource_group_name = "你的资源组名称"

三、部署与验证 #

1. 初始化Terraform：在工作目录执行terraform init，下载所需的云提供商插件
2. 预览部署计划：执行terraform plan，检查资源创建逻辑是否符合预期
3. 执行部署：执行terraform apply，输入yes确认部署
4. 测试告警：手动在目标应用中触发错误（如抛出异常），等待5分钟左右，检查Teams频道是否收到告警消息

四、新手常见注意事项 #

• 敏感信息保护：不要将terraform.tfvars或包含Webhook URL的代码提交至公共仓库，可使用Terraform环境变量（如TF_VAR_teams_webhook_url）传递敏感值
• 日志查询调整：根据应用的日志类型修改criteria中的查询语句（如.NET应用可使用ApplicationInsightsLogs，Java应用可调整日志级别字段）
• 权限检查：确保当前云账号拥有Monitor Contributor或资源组级别的权限，否则无法创建告警规则
• 告警阈值优化：根据业务需求调整window_size和threshold参数，避免误告警

内容的提问来源于stack exchange，提问作者ZotNet