使用 Azure Monitor 创建、查看和管理活动日志警报
活动日志警报是当新发生的活动日志事件与警报中指定的条件匹配时激活的警报。 你可以使用 Azure 资源管理器模板来创建这些适用于 Azure 资源的警报。 你还可以在 Azure 门户中创建、更新或删除这些警报。
通常,你可以创建活动日志警报,以便在 Azure 订阅中的资源发生特定的更改时接收通知。 警报通常限于特定的资源组或资源。 例如,你可能希望在示例资源组 myProductionResourceGroup
中的任何虚拟机被删除时收到通知。 或者,你可能希望在任何新角色分配到订阅中的用户时收到通知。
重要
无法使用创建活动日志警报的接口来创建有关服务运行状况通知的警报。 若要详细了解如何创建和使用服务运行状况通知,请参阅接收有关服务运行状况通知的活动日志警报。
创建警报规则时,请确保:
- 范围中的订阅并未不同于创建警报的订阅。
- 条件必须是配置警报时所依据的级别、状态、调用方、资源组、资源 ID 或资源类型事件类别。
- 警报配置 JSON 中没有
anyOf
条件或嵌套条件。 只允许有一个allOf
条件,不可以有更多allOf
或anyOf
条件。 - 当类别是
administrative
时,必须在警报中至少指定上述条件之一。 无法创建每次在活动日志中创建事件时都会激活的警报。 - 无法为活动日志
alert
类别中的事件创建警报。
Azure 门户
可以使用 Azure 门户创建和修改活动日志警报规则。 该体验与 Azure 活动日志相集成,以确保针对所关注的特定事件顺利创建警报。 在 Azure 门户中,可从 Azure Monitor 的“警报”窗格或从 Azure Monitor 的“活动日志”窗格中创建新的活动日志警报规则。
从 Azure Monitor 的“警报”窗格创建警报规则
以下步骤说明如何在 Azure 门户中创建活动日志警报规则:
在 Azure 门户中,选择“监视” 。 “监视”窗格将所有监视设置和数据合并到一个视图中。
选择“警报”>“+ 创建”>“警报规则”。
提示
大多数资源窗格的资源菜单中也有“警报”菜单项,该项位于“监视”下方。 你也可以从那里创建警报规则。
在“范围”选项卡中,单击“选择范围”。 然后,在加载的上下文窗格中,选择要发出警报的目标资源。 使用“按订阅筛选”、“按资源类型筛选”和“按位置筛选”下拉框查找要监视的资源。 也可以使用搜索栏查找资源。
注意
可以选择整个订阅、资源组或同一订阅中的一个或多个特定资源作为目标。 如果选择订阅或资源组作为目标,并且还选择了资源类型,则规则将应用于所选订阅或资源组内该类型的所有资源。 如果选择了特定的目标资源,则规则将只应用于该资源。 不能选择多个订阅,或来自不同订阅的多个资源。
如果选定的资源具有可对其创建警报规则的活动日志操作,你将看到“可用信号类型”列出了活动日志。 你可在 Azure 资源提供程序操作中查看活动日志警报支持的资源类型的完整列表。
选择目标资源之后,单击“完成”。
转到“条件”选项卡。然后,在加载的上下文窗格中,你将看到资源支持的信号列表,其中包括来自各种类别的活动日志的信号。 选择要创建警报规则的活动日志信号或操作。
随后会显示过去 6 小时内的活动日志操作的图表。 使用“图表时间段”下拉列表查看更早之前的操作历史记录。
在“警报逻辑”下,可以选择定义更多筛选条件:
- 事件级别:事件的严重级别:“详细”、“信息性”、“警告”、“错误”或“严重”。
- 状态:事件的状态:例如,“已启动”、“失败”或“成功”。
- 事件发起者:也称为“调用方”。 电子邮件地址或执行操作的用户的 Azure Active Directory 标识符。
注意
定义其中至少一个条件可帮助你实现更有效的规则。 例如,当警报范围是整个订阅并且所选信号为
All Administrative Operations
时,如果提供事件级别、状态或启动信息,那么你的规则会更具体。转到“操作”选项卡,可在其中定义在警报规则生成警报时触发的操作和通知。 可通过选择现有操作组或创建新的操作组,将操作组添加到警报规则中。
转到“详细信息”选项卡。在“项目详细信息”下,选择将在其中保存警报规则资源的资源组。 在“警报规则详细信息”下,指定警报规则名称。 还可以提供警报规则说明。
注意
用户当前无法配置活动日志警报的警报严重性。 严重性级别始终默认设置为 Sev4。
转到“标记”,可在其中为创建的警报规则设置标记。
转到“查看 + 创建”选项卡,可在其中查看你的选择,然后再创建警报规则。 还将执行快速自动验证,在任何信息丢失或需要更正时通知你。 准备好创建警报规则后,单击“创建”。
从 Azure Monitor 的“活动日志”窗格创建警报规则
要创建活动日志警报,还有一种方法是通过 Azure 门户中的活动日志使用已发生的活动日志事件。
在“Azure Monitor - 活动日志”窗格中,可筛选或查找所需的事件,然后选择“新建警报规则”创建针对将来类似事件的警报 。
这将打开“创建警报规则”向导,包括根据之前选择的活动日志事件已填充的范围和条件。 你可根据需要在此阶段编辑和修改范围和条件。 请注意,默认情况下,新规则的确切范围和条件是从原始事件属性复制而来的。 例如,对于发生事件的确切资源,以及发起事件的特定用户或服务名称,都默认包含在新的警报规则中。 如果要使警报规则更具一般性,可相应地修改范围和条件(请参阅“从 Azure Monitor 警报窗格创建警报规则”部分中的步骤 3-9)。
然后按照“从 Azure Monitor 警报窗格创建警报规则”部分中的步骤 9-12 进行操作。
在 Azure 门户中查看和管理
在 Azure 门户中,选择“监视”>“警报”。 然后选择“警报规则”。
此时将显示可用警报规则的列表。
筛选或搜索要修改的活动日志规则。
可以使用可用的筛选器(“订阅”、“资源组”、“资源”、“信号类型”或“状态”)来查找想要编辑的活动规则。
选择警报规则以将其打开进行编辑。 进行所需的更改,然后选择“保存”。
Azure 资源管理器模板
若要使用 Azure 资源管理器模板创建活动日志警报规则,请创建 microsoft.insights/activityLogAlerts
类型的资源。 然后,填充所有相关属性。 下面是一个用于创建活动日志警报规则的模板:
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"activityLogAlertName": {
"type": "string",
"metadata": {
"description": "Unique name (within the Resource Group) for the Activity log alert."
}
},
"activityLogAlertEnabled": {
"type": "bool",
"defaultValue": true,
"metadata": {
"description": "Indicates whether or not the alert is enabled."
}
},
"actionGroupResourceId": {
"type": "string",
"metadata": {
"description": "Resource Id for the Action group."
}
}
},
"resources": [
{
"type": "Microsoft.Insights/activityLogAlerts",
"apiVersion": "2017-04-01",
"name": "[parameters('activityLogAlertName')]",
"location": "Global",
"properties": {
"enabled": "[parameters('activityLogAlertEnabled')]",
"scopes": [
"[subscription().id]"
],
"condition": {
"allOf": [
{
"field": "category",
"equals": "Administrative"
},
{
"field": "operationName",
"equals": "Microsoft.Resources/deployments/write"
},
{
"field": "resourceType",
"equals": "Microsoft.Resources/deployments"
}
]
},
"actions": {
"actionGroups":
[
{
"actionGroupId": "[parameters('actionGroupResourceId')]"
}
]
}
}
}
]
}
之前的示例 JSON 可以保存为文件,例如 sampleActivityLogAlert.json。 你可以在 Azure 门户中使用 Azure 资源管理器配置此示例。
注意
请注意,活动日志警报可定义的最高级别是订阅级别。 无法对两个订阅定义一个警报。 定义应按每个订阅发出警报。
以下字段是可以在 Azure 资源管理器模板中用于条件字段的选项。 (请注意,“资源运行状况”、“顾问”和“服务运行状况”有额外的属性字段,这是它们的特殊字段。)
resourceId
:应该对其生成警报的活动日志事件中受影响资源的资源 ID。category
:活动日志事件的类别。 例如:Administrative
、ServiceHealth
、ResourceHealth
、Autoscale
、Security
、Recommendation
或Policy
。caller
:执行活动日志事件操作的用户的电子邮件地址或 Azure Active Directory 标识符。level
:应该对其生成警报的活动日志事件中的活动级别。 例如:Critical
、Error
、Warning
、Informational
或Verbose
。operationName
:活动日志事件中的操作名称。 例如:Microsoft.Resources/deployments/write
。resourceGroup
:活动日志事件中受影响资源的资源组名称。resourceProvider
:有关详细信息,请参阅 Azure 资源提供程序和类型。 有关将资源提供程序映射到 Azure 服务的列表,请参阅 Azure 服务的资源提供程序。status
:描述活动事件中操作状态的字符串。 例如:Started
、In Progress
、Succeeded
、Failed
、Active
或Resolved
。subStatus
:通常情况下,此字段是对应 REST 调用的 HTTP 状态代码。 但它还可以包含其他描述子状态的字符串。 HTTP 状态代码的示例包括OK
(HTTP 状态代码:200)、No Content
(HTTP 状态代码:204)和Service Unavailable
(HTTP 状态代码:503)等等。resourceType
:受事件影响的资源的类型。 例如:Microsoft.Resources/deployments
。
例如:
"condition": {
"allOf": [
{
"field": "category",
"equals": "Administrative"
},
{
"field": "resourceType",
"equals": "Microsoft.Resources/deployments"
}
]
}
有关活动日志字段的详细信息,请参阅 Azure 活动日志事件架构。
注意
新的活动日志警报规则可能需要 5 分钟才能变为活动状态。
REST API
Azure Monitor 活动日志警报 API 是一个 REST API。 它与 Azure 资源管理器 REST API 完全兼容。 可以使用资源管理器 cmdlet 或 Azure CLI,通过 PowerShell 来使用它。
注意
若要与 Azure 交互,建议使用 Azure Az PowerShell 模块。 请参阅安装 Azure PowerShell 以开始使用。 若要了解如何迁移到 Az PowerShell 模块,请参阅 将 Azure PowerShell 从 AzureRM 迁移到 Az。
使用 PowerShell 部署资源管理器模板
若要使用 PowerShell 部署前面的 Azure 资源管理器模板部分所示的示例资源管理器模板,请使用以下命令:
New-AzResourceGroupDeployment -ResourceGroupName "myRG" -TemplateFile sampleActivityLogAlert.json -TemplateParameterFile sampleActivityLogAlert.parameters.json
sampleActivityLogAlert.parameters.json 文件中包含的一些值是为在创建警报规则时所需的参数提供的。
使用活动日志 PowerShell cmdlet
活动日志警报具有专用的 PowerShell cmdlet 可用:
- Set-AzActivityLogAlert:创建新的活动日志警报,或更新现有的活动日志警报。
- Get-AzActivityLogAlert:获取一个或多个活动日志警报资源。
- Enable-AzActivityLogAlert:启用现有活动日志警报并设置其标记。
- Disable-AzActivityLogAlert:禁用现有活动日志警报并设置其标记。
- Remove-AzActivityLogAlert:删除活动日志警报。
Azure CLI
你可以使用 az monitor activity-log alert 集下的专用 Azure CLI 命令来管理活动日志警报规则。
要创建新的活动日志警报规则,请使用以下命令:
- az monitor activity-log alert create:创建新的活动日志警报规则资源。
- az monitor activity-log alert scope:为已创建的活动日志警报规则添加范围。
- az monitor activity-log alert action-group:将操作组添加到活动日志警报规则。
若要检索一个活动日志警报规则资源,请使用 Azure CLI 命令 az monitor activity-log alert show。 若要查看某个资源组中的所有活动日志警报规则资源,请使用 az monitor activity-log alert list。 你可以使用 Azure CLI 命令 az monitor activity-log alert delete 删除活动日志警报规则资源。
后续步骤
- 了解活动日志的 Webhook 架构。
- 阅读活动日志概述。
- 详细了解操作组。
- 了解服务运行状况通知。