Azure-Ressourcenbenachrichtigungen: Integritätsressourcenereignisse in Azure Event Grid (Vorschau)

  • Artikel

Das Thema „HealthResources“-System bietet genaue, zuverlässige und umfassende Integritätsinformationen, sodass tiefere Kenntnisse der verschiedenen Dienstprobleme, die sich auf Ihre Azure-Ressourcen auswirken, nämlich einzelne virtuelle Computer (VMs), VMS-Skalierungsgruppen für virtuelle Computer und Skalierungsgruppen für virtuelle Computer. Health Resources bietet zwei Ereignistypen für den Verbrauch: AvailabilityStatusChanged und ResourceAnnotated.

Dieser Artikel enthält die Eigenschaften und das Schema für Azure Resource Notifications Health Resources-Ereignisse. Eine Einführung in Ereignisschemas im Allgemeinen finden Sie unter Azure Event Grid-Ereignisschema. Darüber hinaus finden Sie Beispiele für generierte Ereignisse und einen Link zu einem verwandten Artikel zum Erstellen eines Systemthemas für diesen Thementyp.

Ereignistypen

Integritätsressourcen bieten zwei Ereignistypen für den Verbrauch:

Ereignistyp Beschreibung
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Wird ausgelöst, wenn sich der Verfügbarkeitsstatus einer einzelnen Instanz-VM, eines Skalierungssatzes eines virtuellen Computers oder einer VM in einer VM-Skalierungsgruppe ändert.

Diese Informationen bieten Einblicke in die Zeiten, in denen Ihre einzelnen Instanz-VMs, VMs in VM-Skalierungssätzen oder VM-Skalierungssätzen selbst aufgrund von Azure-Dienstproblemen nicht verfügbar waren. Weitere Informationen zu den verschiedenen Integritätsstatus finden Sie in der Azure Resource Health-Übersicht – Azure Service Health.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Wird ausgelöst, wenn die Integrität eines virtuellen Computers, eines VM-Skalierungssatzes oder einer VM in einem Skalierungssatz für virtuelle Computer beeinträchtigt wird, durch die Verfügbarkeit beeinträchtigt wird. Die Plattform gibt Kontext aus, warum die Unterbrechung aufgetreten ist, um Sie bei der entsprechenden Reaktion zu unterstützen.

Anhand dieser Informationen können Sie den Verfügbarkeitsstatus Ihrer Ressourcen ableiten, indem sie wichtige Informationen zu den Gründen und Ursachen für Änderungen an der Verfügbarkeit bereitstellen. Mithilfe dieser Daten können Sie schnellere und gezieltere Abhilfemaßnahmen ergreifen. Weitere Informationen zu den verschiedenen ausgegebenen Anmerkungen finden Sie unter Integritätsanmerkungen zu Resource Health-VMs.

Rollenbasierte Zugriffssteuerung

Derzeit werden diese Ereignisse ausschließlich im Azure-Abonnementbereich ausgegeben. Es bedeutet, dass die Entität, die das Ereignisabonnement für diesen Thementyp erstellt, Benachrichtigungen über dieses Azure-Abonnement empfängt. Aus Sicherheitsgründen müssen Sie die Möglichkeit zum Erstellen von Ereignisabonnements in diesem Thema auf Prinzipale mit Lesezugriff über das gesamte Azure-Abonnement beschränken. Für den Zugriff auf Daten über dieses Systemthema ist zusätzlich zu den generischen Berechtigungen, die von Event Grid benötigt werden, die folgende spezifische Azure Resource Notifications-Berechtigung erforderlich: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.

Ereignisschemata

Das folgende Schema wird verwendet:

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

Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:

Eigenschaft Typ Beschreibung
id String Eindeutiger Bezeichner der Veranstaltung
source String Das Azure-Abonnement, für das dieses Systemthema erstellt wird.
subject String Publisher hat den Pfad zur Basisressource definiert, für die dieses Ereignis ausgegeben wird.
type String Registrierter Ereignistyp dieses Systemthematyps
time String
Format: 2022-11-07T18:43:09.2894075Z		 Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeitangabe des Anbieters.
data Object Enthält die für den Ressourcenanbieter spezifischen Ereignisdaten. Weitere Informationen finden Sie in der nächsten Tabelle.
specversion String Version der CloudEvents-Schemaspezifikation.

Das data-Objekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
resourceInfo Object Daten, die für die Ressource spezifisch sind. Weitere Informationen finden Sie in der nächsten Tabelle.
apiVersion String Die API-Version der Ressourceneigenschaften.
operationalInfo Object Details der betriebstechnischen Informationen zur Ressource.

Das resourceInfo-Objekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
id String Vom Herausgeber definierter Pfad zum Ereignisbetreff
name String Dieses Feld gibt die Ereignis-ID an. Es verwendet immer den Wert des letzten Abschnitts des id Felds.
type String Der Ereignistyp, der ausgegeben wird. In diesem Zusammenhang ist es entweder Microsoft.ResourceHealth/AvailabilityStatuses oder Microsoft.ResourceHealth/ResourceAnnotated.
properties Object Payload der Ressource. Weitere Informationen finden Sie in der nächsten Tabelle.

Das operationalInfo-Objekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ BESCHREIBUNG
resourceEventTime DateTime Datum und Uhrzeit der Aktualisierung der Ressource.

Das properties Innerhalb des data Objekts unterscheidet sich um AvailabilityStatusChanged und ResourceAnnotated Ereignisse.

Eigenschaften für das AvailabilityStatusChanged-Ereignis

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

Für das AvailabilityStatusChanged Ereignis weist das properties Objekt die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
targetResourceId String Die Basisressource, für die die Verfügbarkeitsinformationen ausgegeben werden.
targetResourceType String Der Typ der Basisressource.
occurredTime String Der Zeitpunkt, zu dem dieses tatsächliche Ereignis ausgegeben wurde.
previousAvailabilityState String Vorheriger Verfügbarkeitsstatus.
availabilityState String Aktueller Verfügbarkeitsstatus. Die Liste der Werte finden Sie unter Verfügbarkeitsstatus – Get By Resource – REST API (Azure Resource Health).

Eigenschaften für das ResourceAnnotated-Ereignis

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

Für das ResourceAnnotated Ereignis weist das properties Objekt die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
targetResourceId String Die Basisressource, für die die Anmerkungsinformationen ausgegeben werden.
targetResourceType String Der Typ der Basisressource.
occurredTime String Zeitstempel, als die Anmerkung von der Azure-Plattform als Reaktion auf das verfügbarkeitsbeeinflusste Ereignis ausgegeben wurde.
annotationName String Der Name des Annotation-Objekts. Die Liste der Anmerkungen und die entsprechenden Beschreibungen finden Sie unter Integritätsanmerkungen zu Resource Health-VMs – Azure Service Health.
reason String Kurze Aussage darüber, warum sich die Ressourcenverfügbarkeit geändert oder beeinflusst hat.
summary String Detaillierte Erklärung zur Aktivität und Ursache für die Änderung oder Beeinflussung der Ressourcenverfügbarkeit.
context String Bestimmt, ob die Ressourcenverfügbarkeit aufgrund von Azure oder durch den Benutzer verursachten Aktivitäten beeinflusst wurde.
category String Bestimmt, ob die Ressourcenverfügbarkeit aufgrund geplanter oder ungeplanter Aktivitäten beeinflusst wurde. Diese Eigenschaft kann nur mit Platform-Initiated Ereignissen verwendet werden.

Beispielereignisse

AvailabilityStatusChanged Ereignis

Das folgende Beispiel zeigt das Schema eines Ereignisses aufgrund eines geänderten Schlüssel-Wert-Paars:

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

Das folgende Beispiel zeigt das Schema eines Ereignisses aufgrund eines geänderten Schlüssel-Wert-Paars:

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

Kontakt

Wenn Sie Fragen oder Feedback zu diesem Feature haben, zögern Sie nicht, uns unter arnsupport@microsoft.com zu kontaktieren.

Um Ihnen besser mit spezifischem Feedback zu einem bestimmten Ereignis zu helfen, geben Sie die folgenden Informationen an:

Für fehlende Ereignisse:

  • Name des Systemthematyps
  • Ungefährer Zeitstempel in UTC, zu dem der Vorgang ausgeführt wurde
  • Basisressourcen-ID, für die die Benachrichtigung generiert wurde
  • Navigieren Sie im Azure-Portal zu Ihrer Ressource, und wählen Sie die JSON-Ansicht ganz rechts aus. Die Ressourcen-ID ist das erste Feld auf der JSON-Ansichtsseite.
  • Erwarteter Ereignistyp
  • Vorgang ausgeführt (z. B. VM gestartet oder beendet, Speicherkonto erstellt usw.)
  • Beschreibung des aufgetretenen Problems (z. B. VM gestartet und kein Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged-Ereignis generiert)
  • Geben Sie nach Möglichkeit die Korrelations-ID des ausgeführten Vorgangs an.

Für ein Ereignis, das verzögert wurde oder unerwartete Inhalte aufweist

  • Name des Systemthematyps
  • Vollständiger Inhalt der Benachrichtigung ohne data.resourceInfo.properties
  • Beschreibung des aufgetretenen Problems und die betroffenen Feldwerte

Stellen Sie sicher, dass Sie keine personenbezogenen Informationen zu den Endbenutzer*innen einschließen, wenn Sie diese Daten freigeben.

Nächste Schritte

Siehe Abonnieren von Azure-Ressourcenbenachrichtigungen – Ereignisse für Integritätsressourcen.