Condividi tramite

Notifiche delle risorse di Azure - Eventi delle risorse di integrità in Griglia di eventi di Azure (anteprima)

  • Articolo

L'argomento di sistema HealthResources fornisce informazioni accurate, affidabili e complete sull'integrità, consentendo una comprensione più approfondita dei diversi problemi del servizio che influiscono sulle risorse di Azure, ovvero macchine virtuali a istanza singola, macchine virtuali del set di scalabilità di macchine virtuali e set di scalabilità di macchine virtuali. Risorse integrità offre due tipi di evento per l'utilizzo: AvailabilityStatusChanged e ResourceAnnotated.

Questo articolo fornisce le proprietà e lo schema per gli eventi delle risorse di integrità delle notifiche delle risorse di Azure. Per un'introduzione agli schemi di eventi in generale, vedere Schema di eventi di Griglia di eventi di Azure. Inoltre, è possibile trovare esempi di eventi generati e un collegamento a un articolo correlato su come creare un argomento di sistema per questo tipo di argomento.

Tipi di evento

Risorse integrità offre due tipi di evento per l'utilizzo:

Tipo di evento Descrizione
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Generato quando lo stato di disponibilità di una macchina virtuale a istanza singola, un set di scalabilità di macchine virtuali o una macchina virtuale in un set di scalabilità di macchine virtuali cambiano.

Queste informazioni forniscono dettagli su tutte le volte in cui le macchine virtuali a istanza singola, le macchine virtuali nei set di scalabilità di macchine virtuali o i set di scalabilità di macchine virtuali stessi non sono stati disponibili a causa di problemi del servizio di Azure. Per altre informazioni sui vari stati di integrità, vedere Panoramica di Integrità risorse di Azure - Integrità dei servizi di Azure.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Generato quando l'integrità di una macchina virtuale, di un set di scalabilità di macchine virtuali o di una macchina virtuale in un set di scalabilità di macchine virtuali influisce sulla disponibilità che quindi causa interruzioni. La piattaforma genera contesto per il motivo per cui si è verificata l'interruzione per facilitare una risposta appropriata.

Queste informazioni consentono di dedurre lo stato di disponibilità delle risorse fornendo informazioni cruciali sui motivi e sulle cause delle modifiche nella disponibilità. Usando questi dati, è possibile adottare misure di mitigazione più rapide e mirate. Per altre informazioni sulle varie annotazioni generate, vedere Annotazioni sull'integrità della macchina virtuale Integrità risorse.

Controllo degli accessi in base al ruolo

Attualmente, questi eventi vengono generati esclusivamente nell'ambito della sottoscrizione di Azure. Implica che l'entità che crea la sottoscrizione di eventi per questo tipo di argomento riceve notifiche in tutta la sottoscrizione di Azure. Per motivi di sicurezza, è fondamentale limitare la possibilità di creare sottoscrizioni di eventi in questo argomento alle entità con accesso in lettura nell'intera sottoscrizione di Azure. Per accedere ai dati tramite questo argomento di sistema è necessaria, oltre alle autorizzazioni generiche richieste da Griglia di eventi, l'autorizzazione specifica per le notifiche delle risorse di Azure seguenti: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.

Schemi di eventi

Ecco lo 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
}

Un evento presenta i seguenti dati di primo livello:

Proprietà Type Descrizione
id Stringa Identificatore univoco dell'evento
source String Sottoscrizione di Azure per cui viene creato questo argomento di sistema.
subject String Percorso definito dal server di pubblicazione della risorsa di base in cui viene generato questo evento.
type String Tipo di evento registrato di questo tipo di argomento di sistema
time string
Formato: 2022-11-07T18:43:09.2894075Z		 Ora di generazione dell'evento in base all'ora UTC del provider
data Object Contiene dati dell'evento specifici del provider di risorse. Per altre informazioni, vedere la tabella seguente.
specversion String Versione della specifica dello schema CloudEvents.

Di seguito sono elencate le proprietà dell'oggetto data:

Proprietà Type Descrizione
resourceInfo Object Dati specifici della risorsa. Per altre informazioni, vedere la tabella seguente.
apiVersion String Versione API delle proprietà della risorsa.
operationalInfo Object Dettagli delle informazioni operative relative alla risorsa.

Di seguito sono elencate le proprietà dell'oggetto resourceInfo:

Proprietà Type Descrizione
id Stringa Percorso definito dall'editore all'oggetto dell'evento
name String Questo campo indica l'ID evento. Acquisisce sempre il valore dell'ultima sezione del campo id.
type String Tipo di evento generato. In questo contesto, è Microsoft.ResourceHealth/AvailabilityStatuses o Microsoft.ResourceHealth/ResourceAnnotated.
properties Object Payload della risorsa. Per altre informazioni, vedere la tabella seguente.

Di seguito sono elencate le proprietà dell'oggetto operationalInfo:

Proprietà Type Descrizione
resourceEventTime Data/Ora Data e ora di aggiornamento della risorsa.

properties all'interno dell'oggetto data è diverso per gli eventi AvailabilityStatusChanged e ResourceAnnotated.

Proprietà per l'evento AvailabilityStatusChanged

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

Per l'evento AvailabilityStatusChanged, l'oggetto properties ha le proprietà seguenti:

Proprietà Type Descrizione
targetResourceId Stringa Risorsa di base per cui vengono generate le informazioni sulla disponibilità.
targetResourceType String Tipo della risorsa di base.
occurredTime String Ora in cui è stato generato l'evento effettivo.
previousAvailabilityState String Stato disponibilità precedente.
availabilityState String Stato di disponibilità corrente. Per l'elenco dei valori, vedere Stati di disponibilità - Ottenere per risorsa - API REST (Integrità risorse di Azure).

Proprietà per l'evento ResourceAnnotated

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

Per l'evento ResourceAnnotated, l'oggetto properties ha le proprietà seguenti:

Proprietà Type Descrizione
targetResourceId Stringa Risorsa di base per cui vengono generate le informazioni sull'annotazione.
targetResourceType String Tipo della risorsa di base.
occurredTime String Timestamp di quando l'annotazione è stata generata dalla piattaforma Azure in risposta all'evento che influenza la disponibilità.
annotationName String Nome dell'elemento Annotation. Per l'elenco delle annotazioni e le descrizioni corrispondenti, vedere Annotazioni sull'integrità della macchina virtuale Integrità risorse - Integrità dei servizi di Azure.
reason String Breve dichiarazione sul motivo per cui la disponibilità delle risorse è cambiata o è stata influenzata.
summary String Istruzione dettagliata sull'attività e causa della modifica o dell'influenza della disponibilità delle risorse.
context String Determina se la disponibilità delle risorse è stata influenzata a causa dell'attività causata da Azure o dall'utente.
category String Determina se la disponibilità delle risorse è stata influenzata a causa di attività pianificate o non pianificate. Questa proprietà è applicabile solo agli eventi Platform-Initiated.

Eventi di esempio

Evento AvailabilityStatusChanged

L'esempio seguente illustra lo schema di un evento modificato con valore chiave:

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

Evento ResourceAnnotated

L'esempio seguente illustra lo schema di un evento modificato con valore chiave:

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

Contatti

In caso di domande o commenti riguardo questa funzionalità, contattarci all'indirizzo arnsupport@microsoft.com.

Per ricevere assistenza più mirata con feedback specifico su un determinato evento, fornire le informazioni seguenti:

Per eventi mancanti:

  • Nome del tipo di argomento di sistema
  • Timestamp approssimativo in ora UTC di quando è stata eseguita l'operazione
  • ID risorsa di base per cui è stata generata la notifica
  • Passare alla risorsa nel portale di Azure e selezionare Visualizzazione JSON nell'angolo all'estrema destra. L'ID risorsa è il primo campo nella pagina di visualizzazione JSON.
  • Tipo di evento previsto
  • Operazione eseguita (ad esempio, macchina virtuale avviata o arrestata, account di archiviazione creato e così via)
  • Descrizione del problema rilevato (ad esempio, macchina virtuale avviata e nessun evento Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged generato)
  • Se possibile, specificare l'ID di correlazione dell'operazione eseguita

Per un evento ritardato o con contenuto imprevisto

  • Nome del tipo di argomento di sistema
  • Intero contenuto della notifica, escluso data.resourceInfo.properties
  • Descrizione del problema rilevato e dei valori dei campi interessati

Assicurarsi di non fornire informazioni personali dell'utente finale durante la condivisione di questi dati.

Passaggi successivi

Vedere Sottoscrivere le notifiche delle risorse di Azure - Eventi delle risorse di integrità.