Delen via

Azure-resourcemeldingen - Statusresourcegebeurtenissen in Azure Event Grid (preview)

  • Artikel

HealthResources-systeemonderwerp biedt nauwkeurige, betrouwbare en uitgebreide statusinformatie, waardoor u meer inzicht hebt in de diverse serviceproblemen die van invloed zijn op uw Azure-resources, namelijk virtuele machines met één exemplaar (VM's), VMS van virtuele-machineschaalsets en virtuele-machineschaalsets. Health Resources biedt twee gebeurtenistypen voor verbruik: AvailabilityStatusChanged en ResourceAnnotated.

Dit artikel bevat de eigenschappen en het schema voor Azure Resource Notifications Health Resources-gebeurtenissen. Zie het Gebeurtenisschema van Azure Event Grid voor een inleiding tot gebeurtenisschema's in het algemeen. Daarnaast vindt u voorbeelden van gegenereerde gebeurtenissen en een koppeling naar een gerelateerd artikel over het maken van systeemonderwerp voor dit onderwerptype.

Gebeurtenistypen

Health Resources biedt twee gebeurtenistypen voor gebruik:

Gebeurtenistype Beschrijving
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Wordt gegenereerd wanneer de beschikbaarheidsstatus van één exemplaar-VM, een virtuele-machineschaalset of een VIRTUELE machine in een virtuele-machineschaalset verandert.

Deze informatie biedt inzicht in alle keren dat uw VM's met één exemplaar, VM's in virtuele-machineschaalsets of virtuele-machineschaalsets zelf niet beschikbaar zijn vanwege problemen met de Azure-service. Zie het overzicht van Azure Resource Health - Azure Service Health voor meer informatie over de verschillende statussen.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Wordt gegenereerd wanneer de status van een VIRTUELE machine, een virtuele-machineschaalset of een VM in een virtuele-machineschaalset wordt beïnvloed door beschikbaarheidsonderbrekingen. Het platform verzendt context over de reden waarom de onderbreking heeft plaatsgevonden om u te helpen op de juiste wijze te reageren.

Met deze informatie kunt u de beschikbaarheidsstatus van uw resources afleiden door cruciale informatie te verstrekken over de redenen en oorzaken van wijzigingen in beschikbaarheid. Met behulp van deze gegevens kunt u sneller en meer gerichte risicobeperkende maatregelen nemen. Zie Statusaantekeningen van de virtuele Resource Health-machine voor meer informatie over de verschillende gegenereerde aantekeningen.

Op rollen gebaseerd toegangsbeheer

Deze gebeurtenissen worden momenteel uitsluitend verzonden op het azure-abonnementsbereik. Het impliceert dat de entiteit die het gebeurtenisabonnement voor dit onderwerptype maakt, meldingen ontvangt in dit Azure-abonnement. Om veiligheidsredenen is het noodzakelijk om de mogelijkheid om gebeurtenisabonnementen op dit onderwerp te maken te beperken tot principals met leestoegang voor het hele Azure-abonnement. Als u toegang wilt krijgen tot gegevens via dit systeemonderwerp, is naast de algemene machtigingen die zijn vereist voor Event Grid, de volgende specifieke machtiging voor Azure-resourcemeldingen nodig: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.

Gebeurtenisschema's

Dit is het schema:

{
    "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
}

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap Type Omschrijving
id String Unieke id van de gebeurtenis
source String Het Azure-abonnement waarvoor dit systeemonderwerp wordt gemaakt.
subject String Door Publisher gedefinieerd pad naar de basisresource waarop deze gebeurtenis wordt verzonden.
type String Geregistreerd gebeurtenistype van dit type systeemonderwerp
time Snaar
Formatteren: 2022-11-07T18:43:09.2894075Z		 Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider
data Object Bevat gebeurtenisgegevens die specifiek zijn voor de resourceprovider. Zie de volgende tabel voor meer informatie.
specversion String CloudEvents schemaspecificatieversie.

Het data object heeft de volgende eigenschappen:

Eigenschap Type Description
resourceInfo Object Gegevens die specifiek zijn voor de resource. Zie de volgende tabel voor meer informatie.
apiVersion String API-versie van de resource-eigenschappen.
operationalInfo Object Details van operationele informatie met betrekking tot de resource.

Het resourceInfo object heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
id String Door Publisher gedefinieerd pad naar het gebeurtenisonderwerp
name String Dit veld geeft de gebeurtenis-id aan. Hierbij wordt altijd de waarde van het laatste gedeelte van het id veld gebruikt.
type String Het type gebeurtenis dat wordt verzonden. In deze context is Microsoft.ResourceHealth/AvailabilityStatuses het of Microsoft.ResourceHealth/ResourceAnnotated.
properties Object Nettolading van de resource. Zie de volgende tabel voor meer informatie.

Het operationalInfo object heeft de volgende eigenschappen:

Eigenschap Type Description
resourceEventTime Datum en tijd Datum en tijd waarop de resource is bijgewerkt.

Het properties object binnen het data object is anders voor AvailabilityStatusChanged en ResourceAnnotated gebeurtenissen.

Eigenschappen voor de gebeurtenis AvailabilityStatusChanged

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

Voor de AvailabilityStatusChanged gebeurtenis heeft het properties object de volgende eigenschappen:

Eigenschap Type Omschrijving
targetResourceId String De basisresource waarvoor de beschikbaarheidsinformatie wordt verzonden.
targetResourceType String Het type basisresource.
occurredTime String Het tijdstip waarop deze werkelijke gebeurtenis is verzonden.
previousAvailabilityState String Vorige beschikbaarheidsstatus.
availabilityState String Huidige beschikbaarheidsstatus. Zie Beschikbaarheidsstatussen - Ophalen per resource - REST API (Azure Resource Health) voor de lijst met waarden.

Eigenschappen voor de gebeurtenis ResourceAnnotated

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

Voor de ResourceAnnotated gebeurtenis heeft het properties object de volgende eigenschappen:

Eigenschap Type Omschrijving
targetResourceId String De basisresource waarvoor de aantekeningsgegevens worden verzonden.
targetResourceType String Het type basisresource.
occurredTime String Tijdstempel toen de aantekening werd verzonden door het Azure-platform als reactie op beschikbaarheidsbeïnvloedende gebeurtenis.
annotationName String De naam van de aantekening. Zie Voor de lijst met aantekeningen en de bijbehorende beschrijvingen de statusaantekeningen van de virtuele Resource Health-machine - Azure Service Health.
reason String Korte instructie over waarom de beschikbaarheid van resources is gewijzigd of beïnvloed.
summary String Gedetailleerde instructie over de activiteit en oorzaak dat de beschikbaarheid van resources kan worden gewijzigd of beïnvloed.
context String Hiermee bepaalt u of de beschikbaarheid van resources is beïnvloed door Azure of door de gebruiker veroorzaakte activiteit.
category String Bepaalt of de beschikbaarheid van resources is beïnvloed vanwege geplande of niet-geplande activiteit. Deze eigenschap is alleen van toepassing op Platform-Initiated gebeurtenissen.

Voorbeeld van gebeurtenissen

Gebeurtenis AvailabilityStatusChanged

In het volgende voorbeeld ziet u het schema van een gewijzigde sleutelwaardegebeurtenis:

{
  "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-gebeurtenis

In het volgende voorbeeld ziet u het schema van een gewijzigde sleutelwaardegebeurtenis:

{
  "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"
}

Contact opnemen

Als u vragen of feedback over deze functie hebt, aarzel dan niet om ons te bereiken op arnsupport@microsoft.com.

Geef de volgende informatie op om u beter te helpen met specifieke feedback over een bepaalde gebeurtenis:

Voor ontbrekende gebeurtenissen:

  • Naam van systeemonderwerptype
  • Geschatte tijdstempel in UTC toen de bewerking werd uitgevoerd
  • Basisresource-id waarvoor de melding is gegenereerd
  • Navigeer naar uw resource in Azure Portal en selecteer de JSON-weergave uiterst rechts. Resource-id is het eerste veld op de JSON-weergavepagina.
  • Verwacht gebeurtenistype
  • De bewerking is uitgevoerd (bijvoorbeeld vm gestart of gestopt, opslagaccount gemaakt, enzovoort)
  • Beschrijving van het probleem dat is opgetreden (bijvoorbeeld dat de VM is gestart en er geen gebeurtenis Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged is gegenereerd)
  • Geef indien mogelijk de correlatie-id op van de uitgevoerde bewerking

Voor gebeurtenissen die zijn vertraagd of onverwachte inhoud hebben

  • Naam van systeemonderwerptype
  • Volledige inhoud van de melding met uitzondering van data.resourceInfo.properties
  • Beschrijving van probleem opgetreden en beïnvloede veldwaarden

Zorg ervoor dat u geen identificeerbare informatie voor eindgebruikers opgeeft terwijl u deze gegevens deelt.

Volgende stappen

Zie Abonneren op Azure-resourcemeldingen - Statusresourcegebeurtenissen.