Assinar eventos do Gerenciamento de Recursos do Azure na Grade de Eventos

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

Criar tópico do sistema de recursos

Esta seção mostra como criar um tópico do sistema do tipo microsoft.resourcenotifications.resources.

CLI do Azure

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.resources 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.resources \
               --location Global        
   

PowerShell do Azure

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

   Set-AzContext -Subscription AZURESUBSCRIPTIONID
   

2. Crie um tópico do sistema do tipo microsoft.resourcenotifications.resources usando o comando New-AzEventGridSystemTopic.

   New-AzEventGridSystemTopic -name SYSTEMTOPICNAME `
                   -resourcegroup RESOURCEGROUPNAME `
                   -source /subscriptions/AZURESUBSCRIPTIONID `
                   -topictype microsoft.resourcenotifications.resources `
                   -location global    
   

Portal do Azure

1. Faça logon no Portal do Azure.

2. Na barra de pesquisa, digite Tópicos do Sistema da Grade de Eventos e selecione um na lista de seleção.

3. Na página Tópicos do sistema na Grade de Eventos, selecione Criar na barra de ferramentas.

4. Na página Criar Tópico do Sistema de Grade de Eventos, selecione Gerenciamento de Recursos do Azure – versão prévia para o Tipo de tópico.

   

5. Selecione o grupo de recursos no qual você deseja criar o tópico do sistema.

6. Insira um nome para o tópico do sistema.

7. Selecione Examinar + criar

8. Na página Examinar + criar escolha Criar.

9. Na página de implantação bem-sucedida, selecione Ir para o recurso para navegar até a página do tópico do sistema. Você verá os detalhes sobre o tópico do sistema nesta página.

Assinar eventos

CLI do Azure

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

O comando de amostra a seguir cria uma assinatura de evento para eventos CreatedOrUpdated e Excluídos. Se você não especificar included-event-types, todos os tipos de evento serão incluídos por padrão.

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

PowerShell do Azure

Crie uma assinatura de evento para o tópico acima usando o comando New-AzEventGridSystemTopicEventSubscription.

O comando de amostra a seguir cria uma assinatura de evento para eventos CreatedOrUpdated e Excluídos. Se você não especificar IncludedEventType, todos os tipos de evento serão incluídos por padrão.

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName EVENTSUBSCRIPTIONNAME `
                -ResourceGroupName RESOURCEGROUPNAME `
                -SystemtopicName SYSTEMTOPICNAME `
                -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
                -Endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBSNAMESPACE/eventhubs/EVENTHUB `
                -EndpointType eventhub

Portal do Azure

1. Na página Tópico do sistema da Grade de Eventos, selecione Assinatura de Evento na barra de ferramentas.

2. Veja se o Tipo de Tópico, o Recurso de Origem e o Nome do Tópico são preenchidos automaticamente.

3. Insira um nome para a assinatura de evento.

4. Para filtrar para tipos de evento, selecione o evento, por exemplo, CreatedOrUpdated ou Excluídos.

   

5. Selecione tipo de ponto de extremidade.

6. Configure o manipulador de eventos com base no tipo de ponto de extremidade selecionado. No exemplo a seguir, um hub de eventos do Azure é selecionado.

   

7. Selecione a guia Filtros para fornecer filtragem por assunto e filtragem avançada. Por exemplo, para filtrar eventos de recursos em um grupo de recursos específico, siga estas etapas:

   1. Selecione Habilitar filtragem por assunto.

   2. Na seção Filtros de Assunto, para Assunto começa com, forneça o valor do grupo de recursos neste formato: /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}.

      

8. Em seguida, selecione Criar para criar a assinatura de evento.

Excluir assinatura de evento e tópico do sistema

CLI do Azure

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 arnSystemTopicResources

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

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

PowerShell do Azure

Para excluir uma assinatura de evento, use o comando Remove-AzEventGridSystemTopicEventSubscription. Veja um exemplo:

Remove-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription -ResourceGroupName sampletestrg -SystemTopicName arnSystemTopicResources

Para excluir o tópico do sistema, use o comando Remove-AzEventGridSystemTopic. Veja um exemplo:

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

Portal do Azure

1. Entre no portal do Azure.
2. Na barra de pesquisa, digite Tópicos do Sistema da Grade de Eventos e pressione ENTER.
3. Selecione o tópico do sistema.
4. Na página Tópicos do Sistema da Grade de Eventos, selecione Excluir na barra de ferramentas.

Exemplos de filtragem

Assinar para criar, atualizar, excluir notificações para máquinas virtuais em uma assinatura do Azure

Esta seção mostra o exemplo de filtragem de assinatura para criar, atualizar e excluir notificações para máquinas virtuais em uma assinatura do Azure.

CLI do Azure

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources 
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
	--endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

PowerShell do Azure

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub `
            -AdvancedFilter @(@{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

Portal do Azure

1. Escolha tipos de evento CreatedOrUpdated e Excluídos.

2. Na guia Filtros da assinatura de evento, escolha os seguintes filtros avançados.

   Key = "data.resourceInfo.type"
   Operator = "StringEndsWith" 
   Value = "virtualMachines"
   

Assine a VM para criar, atualizar e excluir notificações de um grupo de recursos específico

CLI do Azure

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources \
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
	--endpoint/subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --subject-begins-with /subscription/{Azure subscription ID}/resourceGroups/<Resource group name>/
	--advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

PowerShell do Azure

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub -AdvancedFilter @(@{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

Portal do Azure

Na guia Filtros da assinatura do evento, habilite a filtragem de assunto e use o seguinte filtro de assunto:

Subject begins with = /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}

Em seguida, escolha os seguintes filtros avançados.

Key = "data.resourceInfo.type"
Operator = "String ends with"
Value = "virtualMachines"

Assinar a VM para criar e atualizar notificações por um local específico em uma assinatura

CLI do Azure

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources \
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated \
	--endpoint/subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --subject-begins-with /subscription/{Azure subscription ID}/resourceGroups/<Resource group name>/
    --advanced-filter data.resourceInfo.location StringIn eastus 
    –-advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

PowerShell do Azure

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub `
            -AdvancedFilter @(@{operator = "StringIn"; key = "data.resourceInfo.location"; value ="eastus"}, @{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

Portal do Azure

Na guia Filtros da assinatura do evento, habilite a filtragem de assunto e use o seguinte filtro de assunto:

Subject begins with = /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}

Em seguida, escolha os seguintes filtros avançados.

Key = "data.resourceInfo.location",
Operator = "String is in"
Value = "eastus"

AND

Key = “data.resourceInfo.type”, Operador = “Cadeia de caracteres termina com” Valor = “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 ajudar você 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.