Подписка на события, создаваемые уведомлениями о ресурсах Azure. Системный раздел "Ресурсы работоспособности" (предварительная версия)
В этой статье описываются действия, необходимые для подписки на события, опубликованные уведомлениями о ресурсах Azure — ресурсы работоспособности. Подробные сведения об этих событиях см. в разделе "Уведомления о ресурсах Azure" — события работоспособности.
Создание системного раздела "Ресурсы работоспособности"
Установите учетную запись в подписку Azure, в которой вы хотите создать системный раздел.
az account set –s AZURESUBSCRIPTIONID
Создайте системный раздел типа
microsoft.resourcenotifications.healthresources
с помощьюaz eventgrid system-topic create
команды.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
Подписка на заметки, область с определенным типом целевого объекта
Возможность отфильтровать типы ресурсов, требующие внимания или устранения последствий, позволяют сосредоточиться на том, что важно. Даже в виртуальных машинах, возможно, вам нужно заботиться только о работоспособности родительского или всего масштабируемого набора виртуальных машин, а также о том, что экземпляр в масштабируемом наборе виртуальных машин затронут. Этот фильтр позволяет точно отклонить тип ресурсов, для которых требуется получать оповещения в режиме реального времени.
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 при выполнении операции
- Базовый идентификатор ресурса, для которого было создано уведомление
- Перейдите к ресурсу в портал Azure и выберите представление JSON в правом верхнем углу. Идентификатор ресурса — это первое поле на странице представления JSON.
- Ожидаемый тип события
- Операция выполнена (например, запущенная или остановленная виртуальная машина, созданная учетная запись служба хранилища и т. д.)
- Описание возникной проблемы (например, виртуальная машина запущена и не создано событие Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
- Если это возможно, укажите идентификатор корреляции выполненной операции.
Для события, которое было отложено или имеет непредвиденное содержимое
- Имя типа системного раздела
- Все содержимое уведомления, за исключением data.resourceInfo.properties
- Описание проблем, возникающих и затронутых значений полей
Убедитесь, что вы не предоставляете ни одной идентифицируемой пользователем информации при совместном использовании этих данных.
Следующие шаги
Подробные сведения об этих событиях см. в разделе "Уведомления о ресурсах Azure" — события работоспособности.