Subscrever eventos da Gestão de Recursos do Azure na Grelha de Eventos (Pré-visualização)

Este artigo explica os passos necessários para subscrever eventos publicados pelas 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.

Tópico Criar 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 onde você deseja criar o tópico do sistema.

   az account set –s AZURESUBSCRIPTIONID
   

2. Crie um tópico do tipo microsoft.resourcenotifications.resources sistema usando o az eventgrid system-topic create comando.

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

Azure PowerShell

1. Defina a conta para a assinatura do Azure onde 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. Inicie sessão no Portal do Azure.

2. Na barra de pesquisa, digite Tópicos do Sistema de Grade de Eventos e selecione-o na lista suspensa.

3. Na página de tópicos do sistema 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 - Visualização 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 Rever + criar

8. Na página Rever + criar, selecione 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ê vê os detalhes sobre o tópico do sistema nesta página.

Subscrever eventos

CLI do Azure

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

O comando de exemplo a seguir cria uma assinatura de evento para eventos CreatedOrUpdated e Delete . 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        

Azure PowerShell

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

O comando de exemplo a seguir cria uma assinatura de evento para eventos CreatedOrUpdated e Delete . 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 de Grade de Eventos, selecione Assinatura de Evento na barra de ferramentas.

2. Confirme 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 do evento.

4. Em Filtrar para tipos de evento, selecione o evento, por exemplo, CreatedOrUpdated ou Deleted.

   

5. Selecione o tipo de ponto final.

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 de assunto e filtragem avançada. Por exemplo, para filtrar eventos de recursos em um grupo de recursos específico, siga estas etapas:

   1. Selecione Ativar filtragem de 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 do evento.

Excluir assinatura de evento e tópico do sistema

CLI do Azure

Para excluir a assinatura do evento, use o az eventgrid system-topic event-subscription delete comando. Eis 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 az eventgrid system-topic delete comando. Eis um exemplo:

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

Azure PowerShell

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

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

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

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

Portal do Azure

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

Exemplos de filtragem

Inscrever-se para criar, atualizar e excluir notificações para máquinas virtuais em uma assinatura do Azure

Esta seção mostra um 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

Azure PowerShell

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 os tipos de evento CreatedOrUpdated e Delete .

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

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

Inscrever-se para criar, atualizar e excluir notificações de VM por 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

Azure PowerShell

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"

Inscrever-se para criar e atualizar notificações de VM por um local específico dentro de 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

Azure PowerShell

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 = "String termina com" Valor = "virtualMachines"

Contactos

Se você tiver alguma dúvida ou feedback sobre este recurso, não hesite em contactar-nos em arnsupport@microsoft.com.

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

Para eventos em falta:

• Nome do tipo de tópico do sistema
• Carimbo de data/hora aproximado em UTC quando a operação foi executada
• ID do recurso de base para o qual a notificação foi gerada
• Navegue até seu recurso no portal do Azure e selecione o modo de exibição JSON no canto direito. 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 o ID de correlação da operação executada

Para eventos que foram atrasados ou têm conteúdo inesperado

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

Certifique-se de que não está a fornecer quaisquer informações identificáveis do utilizador final enquanto partilha estes dados.

Próximos passos

Para obter informações detalhadas sobre esses eventos, consulte Notificações de recursos do Azure - Eventos de recursos.