Dela via

Azure-resursmeddelanden – Hälsoresurshändelser i Azure Event Grid (förhandsversion)

  • Artikel

HealthResources-systemavsnittet ger korrekt, tillförlitlig och omfattande hälsoinformation, vilket ger djupare förståelse för de olika tjänstproblem som påverkar dina Azure-resurser, nämligen virtuella datorer med en instans (VM), VMS för vm-skalningsuppsättningar och vm-skalningsuppsättningar för virtuella datorer. Hälsoresurser erbjuder två händelsetyper för förbrukning: AvailabilityStatusChanged och ResourceAnnotated.

Den här artikeln innehåller egenskaper och schemat för händelser för Azure Resource Notifications Health Resources. En introduktion till händelsescheman i allmänhet finns i Händelseschema för Azure Event Grid. Dessutom hittar du exempel på genererade händelser och en länk till en relaterad artikel om hur du skapar systemämne för den här ämnestypen.

Händelsetyper

Hälsoresurser erbjuder två händelsetyper för förbrukning:

Händelsetyp beskrivning
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Utlöses när tillgänglighetsstatusen för en virtuell dator med en enskild instans, en VM-skalningsuppsättning eller en virtuell dator i en vm-skalningsuppsättning ändras.

Den här informationen ger insikter om alla gånger som dina virtuella datorer med en enskild instans, virtuella datorer i vm-skalningsuppsättningar eller vm-skalningsuppsättningar har varit otillgängliga på grund av problem med Azure-tjänsten. Mer information om de olika hälsostatusarna finns i Översikt över Azure Resource Health – Azure Service Health.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Utlöses när hälsotillståndet för en virtuell dator, en VM-skalningsuppsättning eller en virtuell dator i en VM-skalningsuppsättning påverkas av tillgänglighet som påverkar störningar. Plattformen genererar kontext om varför störningen har inträffat för att hjälpa dig att svara på rätt sätt.

Den här informationen hjälper dig att härleda tillgänglighetstillståndet för dina resurser genom att tillhandahålla viktig information om orsakerna till och orsakerna till ändringar i tillgängligheten. Med hjälp av dessa data kan du vidta snabbare och mer riktade åtgärdsåtgärder. Mer information om de olika anteckningar som genereras finns i Hälsoanteckningar för den virtuella datorn Resource Health.

Rollbaserad åtkomstkontroll

För närvarande genereras dessa händelser exklusivt i Azure-prenumerationsomfånget. Det innebär att entiteten som skapar händelseprenumerationen för den här ämnestypen tar emot meddelanden i hela den här Azure-prenumerationen. Av säkerhetsskäl är det absolut nödvändigt att begränsa möjligheten att skapa händelseprenumerationer i det här avsnittet till huvudkonton med läsåtkomst över hela Azure-prenumerationen. För att få åtkomst till data via det här systemavsnittet, utöver de allmänna behörigheter som krävs av Event Grid, krävs följande specifika behörighet för Azure Resource Notifications: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.

Händelsescheman

Här är schemat:

{
    "id": string,
    "source": string,
    "subject": string,
    "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged | Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
    "time ": string, 
    "data": {
        "resourceInfo": {
            "id": string,
            "name": string,
            "type": string,
            "properties": { 
                <<Different for AvailabilityStatusChanged event and ResourceAnnotated event>>            
            }
        },
        "operationalInfo":{
			"resourceEventTime": date-time
		},
        "apiVersion": string 
    }, 
    "specversion": string
}

En händelse har följande data på den översta nivån:

Property Type Description
id String Unik identifierare för händelsen
source String Den Azure-prenumeration som det här systemämnet skapas för.
subject String Den utgivardefinierade sökvägen till den basresurs som händelsen genereras på.
type String Registrerad händelsetyp av den här systemämnestypen
time Sträng
Format: 2022-11-07T18:43:09.2894075Z		 Den tid då händelsen genereras baserat på leverantörens UTC-tid
data Objekt Innehåller händelsedata som är specifika för resursprovidern. Mer information finns i nästa tabell.
specversion String CloudEvents schemaspecifikationsversion.

Objektet data har följande egenskaper:

Property Type Beskrivning
resourceInfo Objekt Data som är specifika för resursen. Mer information finns i nästa tabell.
apiVersion String API-versionen av resursegenskaperna.
operationalInfo Objekt Information om driftinformation som rör resursen.

Objektet resourceInfo har följande egenskaper:

Property Type Description
id String Publisher-definierad sökväg till händelseämnet
name String Det här fältet anger händelse-ID. Det tar alltid värdet för det sista avsnittet i id fältet.
type String Den typ av händelse som genereras. I det här sammanhanget är det antingen Microsoft.ResourceHealth/AvailabilityStatuses eller Microsoft.ResourceHealth/ResourceAnnotated.
properties Objekt Nyttolasten för resursen. Mer information finns i nästa tabell.

Objektet operationalInfo har följande egenskaper:

Property Type Beskrivning
resourceEventTime Datum/tid Datum och tid då resursen uppdaterades.

I properties -objektet skiljer sig data för AvailabilityStatusChanged och ResourceAnnotated händelser.

Egenskaper för händelsen AvailabilityStatusChanged

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "previousAvailabilityState": string,
                "availabilityState": string
            }

För händelsen AvailabilityStatusChangedproperties har objektet följande egenskaper:

Property Type Description
targetResourceId String Den basresurs som tillgänglighetsinformationen genereras för.
targetResourceType String Typ av basresurs.
occurredTime String Den tid då den här faktiska händelsen genererades.
previousAvailabilityState String Tidigare tillgänglighetsstatus.
availabilityState String Aktuell tillgänglighetsstatus. Listan med värden finns i Tillgänglighetsstatusar – Hämta efter resurs – REST API (Azure Resource Health).

Egenskaper för händelsen ResourceAnnotated

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "annotationName": string,
                "reason": string,
                "summary": string,
                "context": string,
                "category": string,
            }

För händelsen ResourceAnnotatedproperties har objektet följande egenskaper:

Property Type Description
targetResourceId String Den basresurs som anteckningsinformationen genereras för.
targetResourceType String Typ av basresurs.
occurredTime String Tidsstämpel när anteckningen genererades av Azure-plattformen som svar på tillgänglighetspåverkande händelser.
annotationName String Namnet på anteckningen. Listan över anteckningar och motsvarande beskrivningar finns i Resource Health virtual machine Health Annotations – Azure Service Health.
reason String Kort instruktion om varför resurstillgängligheten har ändrats eller påverkats.
summary String Detaljerad instruktion om aktiviteten och orsaken till att resurstillgängligheten ändras eller påverkas.
context String Avgör om resurstillgängligheten påverkades på grund av att Azure eller användaren orsakade aktiviteten.
category String Avgör om resurstillgängligheten påverkades på grund av planerad eller oplanerad aktivitet. Den här egenskapen gäller endast händelser Platform-Initiated .

Exempelhändelser

AvailabilityStatusChanged-händelse

I följande exempel visas schemat för en ändrad nyckel/värde-händelse:

{
  "id": "1fb6fa94-d965-4306-abeq-4810f0774e97",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/availabilityStatuses/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/availabilityStatuses",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "previousAvailabilityState": "Unavailable",
        "availabilityState": "Available"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2023-12-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

ResourceAnnotated-händelse

I följande exempel visas schemat för en ändrad nyckel/värde-händelse:

{
  "id": "8945cf9b-e220-496e-ab4f-f3a239318995",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/resourceAnnotations/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/resourceAnnotations",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "annotationName": "VirtualMachineDeallocationInitiated",
        "reason": "Stopping and deallocating",
        "summary": "This virtual machine is stopped and deallocated as requested by an authorized user or process.",
        "context": "Customer Initiated",
        "category": "Not Applicable"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2022-08-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

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

Se Prenumerera på Azure-resursmeddelanden – Hälsoresurshändelser.