通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

订阅 Azure 资源通知引发的事件 - 健康状况资源系统主题（预览版）

  • 项目

本文介绍订阅“Azure 资源通知 - 运行状况资源”发布的事件所需的步骤。 有关这些事件的详细信息，请参阅 Azure 资源通知 - 运行状况资源事件。

创建运行状况资源系统主题

  1. 将帐户设置为要在其中创建系统主题的 Azure 订阅。

    az account set –s AZURESUBSCRIPTIONID

  2. 使用 az eventgrid system-topic create 命令创建 microsoft.resourcenotifications.healthresources 类型的系统主题。

    az eventgrid system-topic create --name SYSTEMTOPICNAME --resource-group RESOURCEGROUPNAME --source /subscriptions/AZURESUBSCRIPTIONID --topic-type microsoft.resourcenotifications.healthresources --location Global

订阅活动

使用 az eventgrid system-topic event-subscription create 命令为上述主题创建事件订阅。

以下示例命令为 AvailabilityStatusChanged 事件创建事件订阅。

az eventgrid system-topic event-subscription create --name EVENTSUBSCRIPTIONNAME --resource-group RESOURCEGROUPNAME --system-topic-name SYSTEMTOPICNAME –included-event-types Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged --endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/MYEVENTHUBSNAMESPACE/eventhubs/MYEVENTHUB --endpoint-type eventhub

以下示例命令为 ResourceAnnotated 事件创建事件订阅。

az eventgrid system-topic event-subscription create --name EVENTSUBSCRIPTIONNAME --resource-group RESOURCEGROUPNAME --system-topic-name SYSTEMTOPICNAME –included-event-types Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated --endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/MYEVENTHUBSNAMESPACE/eventhubs/MYEVENTHUB --endpoint-type eventhub

如果未指定 included-event-types，则默认包含所有事件类型。

若要从特定资源筛选事件，请使用 --subject-begins-with 参数。 该示例演示如何订阅指定资源组中资源的 AvailabilityStatusChanged 事件。

az eventgrid system-topic event-subscription create --name EVENTSUBSCRIPTIONNAME --resource-group RESOURCEGROUPNAME --system-topic-name SYSTEMTOPICNAME –included-event-types Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged --endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/MYEVENTHUBSNAMESPACE/eventhubs/MYEVENTHUB --endpoint-type eventhub --subject-begins-with /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/SOURCERESOURCEGROUP/

删除事件订阅和系统主题

若要删除事件订阅，请使用 az eventgrid system-topic event-subscription delete 命令。 下面是一个示例：

az eventgrid system-topic event-subscription delete --name firstEventSubscription --resourcegroup sampletestrg --system-topic-name arnSystemTopicHealth

若要删除系统主题，请使用 az eventgrid system-topic delete 命令。 下面是一个示例：

az eventgrid system-topic delete --name arnsystemtopicHealth --resource-group sampletestrg

筛选示例

订阅属于未计划类别的平台发起的注释。

你可能想要筛选到需要操作的事件。 要实现快速缓解操作，准实时警报至关重要。 通过筛选到 Azure 发起的计划外活动，你可以立即注意到工作负载中需要立即关注的意外活动。 你可能想要重新部署或触发与最终用户的通信来告知影响。

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicHealth 
	--included-event-types Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated \
	--endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
	--advanced-filter data.resourceInfo.properties.context StringEndsWith Platform Initiated \
	--advanced-filter data.resourceInfo.properties.category StringEndsWith Unplanned

订阅范围限定为特定目标类型的注释

如果能够筛选到需要关注或缓解影响的资源类型，你就可以专注于重要的事项。 即使在 VM 中，你也许只关心父级或整个虚拟机规模集的运行状况，而不关心虚拟机规模集中的某个实例受到影响的情况。 此筛选器让你能够精确找到你需要准实时警报的资源类型。

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicHealth \
	--included-event-types Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated \
	--endpoint/subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
	--advanced-filter data.resourceInfo.targetResourceType StringContains Microsoft.Compute/virtualMachines

联系我们

如果对此功能有任何疑问或反馈，请通过 arnsupport@microsoft.com 随时联系我们。

为了更好地帮助你提供有关特定事件的特定反馈，请提供以下信息：

对于丢失的事件：

  • 系统主题类型名称
  • 执行操作时的近似时间戳 (UTC)
  • 为其生成通知的基本资源 ID
  • 在 Azure 门户中导航到你的资源，然后选择最右侧的 JSON 视图。 资源 ID 是 JSON 视图页上的第一个字段。
  • 预期的事件类型
  • 执行的操作（例如 VM 已启动或停止、已创建存储帐户等）
  • 遇到的问题的说明（例如，VM 已启动，但未生成 Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged 事件）
  • 如果可能，请提供所执行的操作的相关 ID

对于延迟或具有意外内容的事件

  • 系统主题类型名称
  • 不包括 data.resourceInfo.properties 的通知的全部内容
  • 遇到的问题的说明和受影响的字段值

请确保在共享此数据时未提供任何最终用户身份信息。

后续步骤

有关这些事件的详细信息，请参阅 Azure 资源通知 - 运行状况资源事件。