Prenumerera på händelser som genereras av Azure Resource Notifications – hälsoresurssystemavsnitt (förhandsversion)

Den här artikeln beskriver de steg som krävs för att prenumerera på händelser som publicerats av Azure Resource Notifications – Health Resources. Detaljerad information om dessa händelser finns i Azure Resource Notifications – Health Resources events (Azure Resource Notifications – Health Resources events).

Avsnittet Skapa hälsoresurser system

Azure CLI

1. Ange kontot till den Azure-prenumeration där du vill skapa systemämnet.

   az account set –s AZURESUBSCRIPTIONID
   

2. Skapa ett systemämne av typen microsoft.resourcenotifications.healthresources med kommandot 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        
   

Azure PowerShell

1. Ange kontot till den Azure-prenumeration där du vill skapa systemämnet.

   Set-AzContext -Subscription AZURESUBSCRIPTIONID
   

2. Skapa ett systemämne av typen microsoft.resourcenotifications.healthresources med kommandot New-AzEventGridSystemTopic .

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

Azure-portalen

1. Logga in på Azure-portalen.

2. I sökfältet skriver du Event Grid System Topics och väljer det i listrutan.

3. På sidan Systemavsnitt för Event Grid väljer du + Skapa i verktygsfältet.

4. På sidan Skapa Event Grid-systemämne väljer du Azure Resource Notifications – Hälsohändelser för ämnestyp.

   

5. Välj den resursgrupp där du vill skapa systemämnet.

6. Ange ett namn för systemämnet.

7. Välj Granska + skapa

   

8. På sidan Granska + skapa väljer du Skapa.

9. På sidan för lyckad distribution väljer du Gå till resurs för att navigera till sidan för systemavsnittet. Du ser information om ditt systemavsnitt på den här sidan.

   

Prenumerera på händelser

Azure CLI

Skapa en händelseprenumeration för ämnet ovan med kommandot az eventgrid system-topic event-subscription create .

Följande exempelkommando skapar en händelseprenumeration för händelsen 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        

Följande exempelkommando skapar en händelseprenumeration för händelsen 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        

Om du inte anger included-event-typesinkluderas alla händelsetyper som standard.

Om du vill filtrera händelser från en specifik resurs använder du parametern --subject-begins-with . Exemplet visar hur du prenumererar på AvailabilityStatusChanged händelser för resurser i en angiven resursgrupp.

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/  

Azure PowerShell

Skapa en händelseprenumeration för ämnet ovan med kommandot New-AzEventGridSystemTopicEventSubscription .

Följande exempelkommando skapar en händelseprenumeration för händelsen AvailabilityStatusChanged .

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName EVENTSUBSCRIPTIONNAME -ResourceGroupName RESOURCEGROUPNAME -SystemtopicName SYSTEMTOPICNAME -IncludedEventType Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged -Endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBSNAMESPACE/eventhubs/EVENTHUB -EndpointType eventhub

Följande exempelkommando skapar en händelseprenumeration för händelsen ResourceAnnotated .

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName EVENTSUBSCRIPTIONNAME -ResourceGroupName RESOURCEGROUPNAME -SystemtopicName SYSTEMTOPICNAME -IncludedEventType Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated -Endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBSNAMESPACE/eventhubs/EVENTHUB -EndpointType eventhub

Om du inte anger IncludedEventTypeinkluderas alla händelsetyper som standard.

Om du vill filtrera händelser från en specifik resurs använder du parametern -SubjectBeginsWith . Exemplet visar hur du prenumererar på AvailabilityStatusChanged händelser från resurser i en angiven resursgrupp.

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName EVENTSUBSCRIPTIONNAME -ResourceGroupName RESOURCEGROUPNAME -SystemtopicName SYSTEMTOPICNAME -IncludedEventType Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged -Endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBSNAMESPACE/eventhubs/EVENTHUB -EndpointType eventhub -SubjectBeginsWith /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/SOURCERESOURCEGROUP/

Azure-portalen

1. På sidan Systemämne för Event Grid väljer du + Händelseprenumeration i verktygsfältet.

2. Bekräfta att ämnestypen, källresursen och ämnesnamnet fylls i automatiskt.

3. Ange ett namn för händelseprenumerationen.

4. För Filtrera till händelsetyper väljer du händelsen, till exempel Tillgänglighetsstatus ändrad eller Resurs kommenterad.

   

5. Välj slutpunktstyp.

6. Konfigurera händelsehanterare utan den slutpunktstyp som du har valt. I följande exempel väljs en Azure-händelsehubb.

   

7. Välj fliken Filter för att ange ämnesfiltrering och avancerad filtrering. Om du till exempel vill filtrera efter händelser från resurser i en specifik resursgrupp följer du dessa steg:

   1. Välj Aktivera ämnesfiltrering.

   2. I avsnittet Ämnesfilter för Ämne börjar med anger du värdet för resursgruppen i det här formatet: /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}.

      

8. Välj sedan Skapa för att skapa händelseprenumerationen.

Ta bort händelseprenumeration och systemämne

Azure CLI

Om du vill ta bort händelseprenumerationen använder du az eventgrid system-topic event-subscription delete kommandot . Här är ett exempel:

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

Om du vill ta bort systemämnet använder du az eventgrid system-topic delete kommandot . Här är ett exempel:

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

Azure PowerShell

Om du vill ta bort en händelseprenumeration använder du Remove-AzEventGridSystemTopicEventSubscription kommandot . Här är ett exempel:

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

Om du vill ta bort systemämnet använder du Remove-AzEventGridSystemTopic kommandot . Här är ett exempel:

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnsystemtopicHealth

Azure-portalen

1. Logga in på Azure-portalen.
2. I sökfältet skriver du Event Grid System Topics och trycker på RETUR.
3. Välj systemämnet.
4. På sidan Systemämne för Event Grid väljer du Ta bort i verktygsfältet.

Filtreringsexempel

Prenumerera på plattformsinitierade anteckningar som tillhör oplanerad kategori.

Du kanske vill filtrera efter händelser som kräver en åtgärd. Nästan realtidsaviseringar är viktiga för att aktivera åtgärder för snabbreducering. Genom att filtrera till Azure-initierad och oplanerad aktivitet kan du omedelbart bli medveten om oväntad aktivitet i de arbetsbelastningar som kräver omedelbar uppmärksamhet. Du kanske vill distribuera om eller utlösa kommunikation till slutanvändarna för att meddela effekten.

Azure CLI

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 

Azure PowerShell

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription -ResourceGroupName sampletestrg -SystemtopicName arnSystemTopicHealth -IncludedEventType Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources  -EndpointType eventhub -AdvancedFilter @(@{operator = "StringEndsWith"; key = "data.resourceInfo.properties.context" ; value ="Platform Initiated"}, @{operator = "StringEndsWith"; key = "data.resourceInfo.properties.category" ; value ="Unplanned"})

Azure-portalen

1. Välj Resurs kommenterad som händelsetyp.

2. På fliken Filter i händelseprenumerationen väljer du följande avancerade filter.

   - Key = data.resourceInfo.properties.context 
   - Operator = StringEndsWith 
   - Value = Platform Initiated
   
       AND
   
   - Key = data.resourceInfo.properties.category 
   - Operator = StringEndsWith 
   - Value = Unplanned
   

Prenumerera på anteckningar som är begränsade till en viss måltyp

Om du har möjlighet att filtrera efter de resurstyper som kräver uppmärksamhet eller åtgärd vid påverkan kan du fokusera på det som är viktigt. Även inom virtuella datorer kanske du bara bryr dig när hälsotillståndet för den överordnade eller hela VM-skalningsuppsättningen påverkas jämfört med när en instans i en VM-skalningsuppsättning påverkas. Med det här filtret kan du exakt anpassa den typ av resurser som du vill använda nästan realtidsaviseringar för.

Azure CLI

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

Azure PowerShell

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription -ResourceGroupName sampletestrg -SystemtopicName arnSystemTopicHealth -IncludedEventType Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources  -EndpointType eventhub -AdvancedFilter @(@{operator = "StringContains"; key = "data.resourceInfo.properties.targetResourceType" ; value ="Microsoft.Compute/virtualMachines"})

Azure-portalen

På fliken Filter i händelseprenumerationen väljer du följande avancerade filter.

Key = data.resourceInfo.properties.targetResourceType
Operator = String contains
Value = Microsoft.Compute/virtualMachines

Kontakta oss

Om du har frågor eller feedback om den här funktionen kan du kontakta oss på arnsupport@microsoft.com.

Ange följande information för att bättre hjälpa dig med specifik feedback om en viss händelse:

För saknade händelser:

• Namn på systemämnestyp
• Ungefärlig tidsstämpel i UTC när åtgärden kördes
• Basresurs-ID som meddelandet genererades för
• Gå till resursen i Azure-portalen och välj JSON-vy längst till höger. Resurs-ID är det första fältet på JSON-vysidan.
• Förväntad händelsetyp
• Åtgärden utfördes (till exempel startad eller stoppad virtuell dator, lagringskonto som skapats osv.)
• Beskrivning av påträffade problem (till exempel startad virtuell dator och ingen Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged-händelse genererad)
• Ange om möjligt korrelations-ID för den utförda åtgärden

För händelse som har fördröjts eller har oväntat innehåll

• Namn på systemämnestyp
• Hela innehållet i meddelandet exklusive data.resourceInfo.properties
• Beskrivning av problem som påträffas och påverkade fältvärden

Se till att du inte tillhandahåller någon identifierbar information för slutanvändare när du delar dessa data.

Nästa steg

Detaljerad information om dessa händelser finns i Azure Resource Notifications – Health Resources events (Azure Resource Notifications – Health Resources events).