Compartilhar via

Assinar os eventos gerados pelas Notificações de Recursos do Azure - Tópico do sistema de Recursos de Integridade (Versão prévia)

  • Artigo

Este artigo explica as etapas necessárias para assinar eventos publicados por Notificações de Recursos do Azure – Recursos de Integridade. Para obter informações detalhadas sobre esses eventos, consulte Notificações de Recursos do Azure – Eventos de Recursos de Integridade.

Criar tópico do sistema de Recursos de Integridade

  1. Defina a conta para a assinatura do Azure em que você deseja criar o tópico do sistema.

    az account set –s AZURESUBSCRIPTIONID

  2. Crie um tópico do sistema do tipo microsoft.resourcenotifications.healthresources usando o comando 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

Assinar eventos

Crie uma assinatura de evento para o tópico acima usando o comando az eventgrid system-topic event-subscription create.

O comando de exemplo a seguir cria uma assinatura de evento para o evento 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

O comando de exemplo a seguir cria uma assinatura de evento para o evento 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

Se você não especificar included-event-types, todos os tipos de evento serão incluídos por padrão.

Para filtrar eventos de um recurso específico, use o parâmetro --subject-begins-with. O exemplo mostra como assinar eventos AvailabilityStatusChanged para recursos em um grupo de recursos especificado.

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/

Excluir assinatura de evento e tópico do sistema

Para excluir a assinatura de evento, use o comando az eventgrid system-topic event-subscription delete. Veja um exemplo:

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

Para excluir o tópico do sistema, use o comando az eventgrid system-topic delete. Veja um exemplo:

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

Exemplos de filtragem

Assine anotações iniciadas na plataforma que pertencem à categoria Não planejada.

Talvez você queira filtrar para eventos que exigem uma ação. Alertas quase em tempo real são essenciais para habilitar ações de mitigação rápida. Ao filtrar para a atividade iniciada e não planejada do Azure, você pode ficar instantaneamente a par da atividade inesperada entre as cargas de trabalho que exigem atenção imediata. Talvez você queira reimplantar ou disparar a comunicação com seus usuários finais para notificar o impacto.

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

Assinar anotações com escopo para um tipo de destino específico

Ter a capacidade de filtrar para os tipos de recursos que exigem atenção ou mitigação após o impacto pode permitir que você se concentre no que importa. Mesmo dentro de VMs, talvez você se importe apenas quando a integridade do conjunto de dimensionamento de máquinas virtuais pai ou inteiro for afetada em comparação com quando uma instância em um conjunto de dimensionamento de máquinas virtuais for afetada. Esse filtro permite aprimorar com precisão o tipo de recursos para o qual você deseja obter alertas quase em tempo real.

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

Fale conosco

Se você tiver dúvidas ou comentários sobre esse recursos, não hesite em nos contatar em arnsupport@microsoft.com.

Para ajudá-lo melhor com comentários específicos sobre um determinado evento, forneça as seguintes informações:

Para eventos ausentes:

  • Nome do tipo de tópico do sistema
  • Carimbo de data/hora aproximado em UTC quando a operação foi executada
  • ID do recurso base para a qual a notificação foi gerada
  • Navegue até o recurso no portal do Azure e selecione o modo de exibição JSON no canto superior direito. A ID do recurso é o primeiro campo na página de exibição JSON.
  • Tipo de evento esperado
  • Operação executada (por exemplo, VM iniciada ou interrompida, conta de armazenamento criada etc.)
  • Descrição do problema encontrado (por exemplo, VM iniciada e nenhum evento Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged gerado)
  • Se possível, forneça a ID de correlação da operação executada

Para o evento que foi atrasado ou tem conteúdo inesperado

  • Nome do tipo de tópico do sistema
  • Conteúdo inteiro da notificação excluindo data.resourceInfo.properties
  • Descrição do problema encontrado e valores de campo afetados

Verifique se você não está fornecendo informações identificáveis do usuário final enquanto compartilha esses dados.

Próximas etapas

Para obter informações detalhadas sobre esses eventos, consulte Notificações de Recursos do Azure – Eventos de Recursos de Integridade.