Notifiche delle risorse di Azure - Eventi delle risorse di integrità in Griglia di eventi di Azure (anteprima)
L'argomento del sistema HealthResources fornisce informazioni accurate, affidabili e complete sull'integrità, consentendo una comprensione più approfondita dei diversi problemi del servizio che influisce 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 Griglia di eventi di Azure schema di eventi. 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 cambia. Queste informazioni forniscono informazioni dettagliate 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 Azure Integrità risorse - 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 influisce sulle interruzioni. La piattaforma genera contesto per il motivo per cui si è verificata l'interruzione per facilitare la risposta in modo appropriato. 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 Integrità risorse annotazioni sull'integrità della macchina virtuale. |
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 questa 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 sull'intera sottoscrizione di Azure. Per accedere ai dati tramite questo argomento di sistema, oltre alle autorizzazioni generiche richieste da Griglia di eventi, è necessaria l'autorizzazione specifica per le notifiche delle risorse di Azure seguenti: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.
Schemi di eventi
Ecco lo schema:
{
"id": string,
"topic": string,
"subject": string,
"data": {
"resourceInfo": {
"id": string,
"name": string,
"type": string,
"properties": {
<<Different for AvailabilityStatusChanged event and ResourceAnnotated event>>
}
},
"operationalInfo":{
"resourceEventTime": date-time
},
"apiVersion": string
},
"eventType": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged | Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
"dataVersion": string,
"metadataVersion": string,
"eventTime": string
}
Un evento presenta i seguenti dati di primo livello:
| Proprietà | Digita | Description |
|---|---|---|
id |
Stringa | Identificatore univoco dell'evento |
topic |
Stringa | Sottoscrizione di Azure per cui viene creato questo argomento di sistema |
subject |
Stringa | Percorso definito dal server di pubblicazione della risorsa di base in cui viene generato questo evento. |
data |
Oggetto | Contiene dati dell'evento specifici per il provider di risorse. Per altre informazioni, vedere la tabella seguente. |
eventType |
Stringa | Tipo di evento registrato di questo tipo di argomento di sistema |
dataVersion |
Stringa | Versione dello schema dell'oggetto dati |
metadataVersion |
Stringa | Versione dello schema dei metadati dell'evento |
eventTime |
Stringa Formato: 2022-11-07T18:43:09.2894075Z |
Ora in cui viene generato l'evento in base all'ora UTC del provider |
Di seguito sono elencate le proprietà dell'oggetto data:
| Proprietà | Digita | Descrizione |
|---|---|---|
resourceInfo |
Oggetto | Dati specifici della risorsa. Per altre informazioni, vedere la tabella seguente. |
apiVersion |
Stringa | Versione api delle proprietà della risorsa. |
operationalInfo |
Oggetto | Dettagli delle informazioni operative relative alla risorsa. |
Di seguito sono elencate le proprietà dell'oggetto resourceInfo:
| Proprietà | Digita | Description |
|---|---|---|
id |
Stringa | Percorso definito dal server di pubblicazione per l'oggetto dell'evento |
name |
Stringa | Questo campo indica l'ID evento. Accetta sempre il valore dell'ultima sezione del id campo. |
type |
Stringa | Tipo di evento generato. In questo contesto, è Microsoft.ResourceHealth/AvailabilityStatuses o Microsoft.ResourceHealth/ResourceAnnotated. |
properties |
Oggetto | Payload della risorsa. Per altre informazioni, vedere la tabella seguente. |
Di seguito sono elencate le proprietà dell'oggetto operationalInfo:
| Proprietà | Digita | Descrizione |
|---|---|---|
resourceEventTime |
Data/Ora | Data e ora di aggiornamento della risorsa. |
L'oggetto properties all'interno dell'oggetto data è diverso per AvailabilityStatusChanged gli eventi e ResourceAnnotated .
Proprietà per l'evento AvailabilityStatusChanged
"properties": {
"targetResourceId": string,
"targetResourceType": string,
"occurredTime": string,
"previousAvailabilityState": string,
"availabilityState": string
}
Per l'evento, l'oggetto AvailabilityStatusChanged properties ha le proprietà seguenti:
| Proprietà | Digita | Description |
|---|---|---|
targetResourceId |
Stringa | Risorsa di base per cui vengono generate le informazioni di disponibilità. |
targetResourceType |
Stringa | Tipo della risorsa di base. |
occurredTime |
Stringa | Ora in cui è stato generato l'evento effettivo. |
previousAvailabilityState |
Stringa | Stato di disponibilità precedente. |
availabilityState |
Stringa | Stato di disponibilità corrente. Per l'elenco dei valori, vedere Statuses -Get By Resource - REST API (Azure Integrità risorse). |
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, l'oggetto ResourceAnnotated properties ha le proprietà seguenti:
| Proprietà | Digita | Description |
|---|---|---|
targetResourceId |
Stringa | Risorsa di base per cui vengono generate le informazioni sull'annotazione. |
targetResourceType |
Stringa | Tipo della risorsa di base. |
occurredTime |
Stringa | Timestamp quando l'annotazione è stata generata dalla piattaforma Azure in risposta all'evento che influenza la disponibilità. |
annotationName |
Stringa | Nome dell'elemento Annotation. Per l'elenco delle annotazioni e le descrizioni corrispondenti, vedere Integrità risorse annotazioni sull'integrità della macchina virtuale - Integrità dei servizi di Azure. |
reason |
Stringa | Breve dichiarazione sul motivo per cui la disponibilità delle risorse è cambiata o è stata influenzata. |
summary |
Stringa | Istruzione dettagliata sull'attività e causa della modifica o dell'influenza della disponibilità delle risorse. |
context |
Stringa | Determina se la disponibilità delle risorse è stata influenzata a causa dell'attività causata da Azure o dall'utente. |
category |
Stringa | Determina se la disponibilità delle risorse è stata influenzata a causa di attività pianificate o non pianificate. Questa proprietà è applicabile solo agli Platform-Initiated eventi. |
Eventi di esempio
Evento AvailabilityStatusChanged
{
"id": "1fb6fa94-d965-4306-abeq-4810f0774e97",
"topic": "/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"
},
"eventType": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged",
"dataVersion": "1",
"metadataVersion": "1",
"eventTime": "2023-07-24T19:20:37.9245071Z"
}
Evento ResourceAnnotated
{
"id": "8945cf9b-e220-496e-ab4f-f3a239318995",
"topic": "/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"
},
"eventType": "Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
"dataVersion": "1",
"metadataVersion": "1",
"eventTime": "2023-07-24T19:20:37.9245071Z"
}
Contatti
In caso di domande o commenti su questa funzionalità, non esitare a contattarci all'indirizzo arnsupport@microsoft.com.
Per facilitare l'assistenza con un feedback specifico su un determinato evento, fornire le informazioni seguenti:
Per gli eventi mancanti:
- Nome del tipo di argomento di sistema
- Timestamp approssimativo in formato UTC quando è stata eseguita l'operazione
- ID risorsa di base per cui è stata generata la notifica
- Passare alla risorsa in 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, Archiviazione account 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 l'evento che è stato ritardato o ha contenuto imprevisto
- Nome del tipo di argomento di sistema
- Intero contenuto della notifica esclusa data.resourceInfo.properties
- Descrizione del problema rilevato e dei valori dei campi interessati
Assicurarsi di non fornire informazioni identificabili dall'utente finale durante la condivisione di questi dati.
Passaggi successivi
Vedere Sottoscrivere gli eventi delle notifiche delle risorse di Azure - Risorse di integrità.