Panoramica delle tabelle di Azure Resource Graph

Azure Resource Graph (ARG) consente di eseguire query sulle risorse di Azure tra le sottoscrizioni usando KQL (Kusto Query Language). Questo articolo fornisce una suddivisione dettagliata dei campi comunemente presenti nelle tabelle ARG, in particolare i campi rilevanti per gli scenari di integrità e governance dei servizi di Azure.

Usare la tabella Integrità dei servizi per eseguire una query:

  • Proprietà dell'Evento di Integrità dei Servizi (microsoft.resourcehealth/events)
  • Proprietà delle risorse interessate da Integrità dei servizi (microsoft.resourcehealth/events/impactedresources)

Usare la tabella Integrità risorse per eseguire una query.

Query Tables Tipo di valore Informazioni
Evento di Integrità dei servizi
Risorse impattate dallo stato di salute dei servizi		 ServiceHealthResources
ServiceHealthResources		 microsoft.resourcehealth/events
microsoft.resourcehealth/events/impactedresources		 Eventi di integrità dei servizi, ad esempio interruzioni, manutenzione pianificata o altri eventi imprevisti.
Le risorse di Azure specifiche interessate da tali eventi.
Integrità delle risorse (solo macchine virtuali) Risorse Sanitarie microsoft.resourcehealth/availabilitystatuses, microsoft.resourcehealth/resourceannotations Monitoraggio dell'integrità della macchina virtuale, diagnostica

Questa tabella mostra i campi principali nella tabella ARG per le query Integrità del servizio, Risorse interessate e Integrità delle risorse che rappresentano i metadati sulle risorse di Azure.

Nome campo Description
Documento d'identità ID risorsa di Azure completo (ad esempio, /subscriptions/<subscription-id>/providers/Microsoft.ResourceHealth/events/<tracking-id>)
nome Nome della risorsa
type Tipo di risorsa (ad esempio, Microsoft.Compute/virtualMachines)
tenantId ID del tenant a cui appartiene la risorsa
ubicazione Area di Azure in cui viene distribuita la risorsa (il valore predefinito è Globale)
subscriptionId ID della sottoscrizione a cui appartiene la risorsa
resourceGroup Nome del gruppo di risorse
tags Coppie chiave-valore assegnate alla risorsa
properties Oggetti JSON contenenti proprietà specifiche della risorsa
sku Dettagli SKU (tier, nome) per le risorse applicabili
kind Tipo di risorsa (usato in Servizi app, ad esempio, functionapp o app Web)
managedBy Indica se un altro servizio di Azure gestisce la risorsa
identity Configurazione dell'identità (ad esempio, assegnata dal sistema o assegnata dall'utente)
piano Dettagli del piano del mercato
zone Zone di disponibilità in cui viene distribuita la risorsa
extendedLocation Dettagli della posizione estesa (ad esempio, posizioni personalizzate)

Integrità del servizio

Le query ServiceHealthResources forniscono informazioni sulle risorse nelle sottoscrizioni interessate dagli eventi di salute del servizio.

Queste notifiche sono una sottoclasse di eventi del log attività e sono disponibili anche nel log attività di Azure.

A seconda della classificazione degli eventi, le notifiche sull'integrità del servizio EventType e EventSubtype possono essere informative o soggette ad azione.

Proprietà dell'Evento di Integrità dei Servizi (microsoft.resourcehealth/events)

Screenshot dei campi visualizzati nella colonna delle proprietà di Integrità dei servizi.

I valori nel campo properties vengono utilizzati per eseguire query sugli eventi di Salute del Servizio Azure.

Esistono alcune proprietà comuni in tutti i diversi tipi di evento, ma tutti gli elementi in properties devono essere considerati dinamici in base al tipo di evento.

Questi campi vengono usati insieme per tenere traccia, filtrare e analizzare gli eventi di integrità dei servizi nell'ambiente Azure.
Ad esempio, è possibile eseguire un'interrogazione per tutti gli Critical ServiceIssue eventi in una località specifica che sono ancora Active.

Questa tabella elenca tutte le proprietà che è possibile usare nelle query sull'integrità dei servizi e sulle risorse interessate.

Proprietà Description
EventType Classificazione generale: Problema di Servizio, Manutenzione Programmata, Avviso Sanitario, Fatturazione, Avviso di Sicurezza, Problemi Emergenti e Revisione Post Incidente (PIR)
EventSubType Sottotipo specifico: Ritiro, Modifiche fiscali, Cambiamenti dei prezzi, Modifiche dell'ID del contatore, Variazione del tasso di cambio, Abuso di terzi non autorizzati, Sottostima e Sovrastima
Status Stato corrente dell'evento: attivo o risolto
EventLevel Gravità: informativo, avviso, critico, errore
Level Spesso rispecchia EventLevel ed è utilizzato per il rendering dell'interfaccia utente.
EventSource Indica il sistema di origine che ha generato l'evento come ServiceHealthResources o HealthResources
TrackingId Identificatore univoco dell'evento
Title Titolo dell'evento
Summary Descrizione dell'evento
Il riepilogo completo dell'evento si trova nel Description campo .
Priority Livello di priorità assegnato all'evento
ImpactStartTime Quando l'evento che causa l'impatto è iniziato
ImpactMitigationTime Quando la mitigazione è prevista o completata
Impact Descrizione dell'impatto sui servizi
Region Quali aree e servizi sono interessati
RecommendedActions Azioni suggerite per utenti e/o amministratori
ExternalIncidentId ID incidente usato esternamente (ad esempio in ServiceNow)
PlatformInitiated Indica se la piattaforma Azure attiva l'evento ( ad esempio, una mitigazione automatizzata o una manutenzione attivata dal sistema)
SubscriptionId Identificatore univoco della sottoscrizione di Azure interessata dall'evento
LastUpdateTime Timestamp dell'aggiornamento più recente dell'evento
CurrencyType Valuta utilizzata negli eventi correlati alla fatturazione (ad esempio, USD, EUR)
impactType Natura dell'impatto, ad esempio SubscriptionList, ServicesForSubTenants
BillingId Identificatore usato per associare l'evento a un account di fatturazione o a una transazione
EventTags Tag di metadati usati per classificare o filtrare gli eventi (ad esempio, Sicurezza, Manutenzione, Interruzione)
duration Etichetta descrittiva o titolo per l'evento
Description Descrizione completa dell'evento

Annotazioni

La struttura "properties" è dinamica e varia in base a EventType ed EventSubType. Non tutti i campi sono presenti in ogni evento.
I campi come isEventSensitive potrebbero essere vuoti o omessi a meno che l'evento non sia correlato alla sicurezza.
Spesso EventSubType è vuoto a meno che l'evento non sia un avviso di fatturazione o una consulenza per il pensionamento.
Per altre informazioni, vedere Tag eventi di Integrità dei servizi e Filtrare le notifiche tramite livello di evento.

I sistemi di controllo degli accessi assicurano che solo gli utenti autorizzati con una necessità valida possano visualizzare informazioni riservate. Per altre informazioni, vedere Visualizzare e accedere agli avvisi di sicurezza.

Funzionamento di questi campi

  • Governance e monitoraggio: combinare EventType, Severity e Status che monitora i problemi in corso e ne valuta l'impatto.
  • Filtro e avvisi: usare SubscriptionIde Impact che filtra gli eventi rilevanti per team o carichi di lavoro specifici.
  • Analisi cronologica: usare ImpactStartTime e ImpactMitigationTime per comprendere le sequenze temporali degli eventi e le implicazioni del contratto di servizio.
  • Integrazione dell'API REST: questi campi vengono esposti tramite integrità dei servizi di Azure REST API, consentendo l'accesso programmatico e l'automazione.
  • Eventi di filtro e ambito: SubscriptionId, Impact, TrackingIde PlatformInitiated consentono di restringere le risorse interessate e le modalità.
  • Tenere traccia e analizzare: LastUpdateTime, Headere EventTags supportano il monitoraggio e l'analisi cronologica.
  • Supportare flussi di lavoro finanziari e di conformità: BillingId e CurrencyType sono essenziali per gli eventi e i controlli correlati alla fatturazione.

Risorse interessate

Screenshot dei campi visualizzati nella colonna Proprietà delle risorse interessate.

Impostare la type colonna nella tabella ServiceHealthResources su microsoft.resourcehealth/events/impactedresources in modo da aprire la query per cercare informazioni sulle risorse interessate da eventi di integrità dei servizi, ad esempio interruzioni, manutenzione pianificata o avvisi di sicurezza.

Proprietà delle risorse interessate

Nome del campo Description
resourceName Nome della risorsa interessata
resourceGroupName Nome del gruppo di risorse
targetResourceType Tipo della risorsa interessata
targetResourceId ID risorsa completo
targetRegion Area della risorsa interessata
systemData Metadati relativi a chi ha creato o modificato la voce
maintenanceStartTime Quando l'evento che causa l'impatto è iniziato
maintenanceEndTime Quando l'evento che causa l'impatto è terminato
targetResourceType Tipo della risorsa interessata(ad esempio, Microsoft.Compute/virtualMachines)
targetResourceId ID risorsa completo della risorsa interessata
resourceGroup Nome del Gruppo di risorse
targetRegion Area della risorsa interessata
staus Stato corrente dell'evento
info

Integrità risorse

Esistono due tipi di tabelle in HealthResources Azure Resource Graph (ARG) che forniscono informazioni dettagliate sullo stato di integrità delle risorse di Azure, in particolare le macchine virtuali.

microsoft.resourcehealth/availabilitystatuses
Questa tabella fornisce lo stato di disponibilità più recente delle risorse di Azure, principalmente macchine virtuali ,in base ai controlli di integrità eseguiti dalla piattaforma Azure.

È possibile usare questa query per:

  • Tenere traccia dell'integrità delle macchine virtuali nell'ambiente: ottenere una visualizzazione consolidata dello stato di integrità delle macchine virtuali in tutte le sottoscrizioni o i gruppi di risorse.
  • Diagnosticare rapidamente i problemi: identificare le macchine virtuali contrassegnate come non disponibili o danneggiate e analizzare le cause sottostanti.
  • Controlla le origini dei tempi di inattività: determinare se le interruzioni del servizio derivano da eventi avviati dalla piattaforma (ad esempio manutenzione) o dalle azioni dei clienti.
  • Creare dashboard operative: visualizzare i dati sull'integrità in tempo reale per monitorare gli accordi sul livello di servizio (SLA) e mantenere la consapevolezza delle operazioni.
  • Aggiungere contesto con annotazioni: combinare questa tabella con resourceannotations per comprendere i motivi delle modifiche alla disponibilità, ad esempio i riavvii o le interruzioni.

microsoft.resourcehealth/resourceannotations
Questa tabella fornisce annotazioni dettagliate sulle modifiche apportate alla disponibilità delle risorse di Azure, in particolare le macchine virtuali. Aggiunge contesto, ad esempio l'attribuzione degli errori, l'analisi dei tempi di inattività e i metadati di impatto. Questi campi consentono di comprendere il motivo per cui la disponibilità di una macchina virtuale è cambiata, se è dovuta a manutenzione della piattaforma, azioni dei clienti o errori imprevisti.

È possibile usare questa query per:

  • Analizzare i tempi di inattività delle macchine virtuali: comprendere la causa radice delle modifiche alla disponibilità.
  • Correlare gli eventi di salute: unirsi a availabilitystatuses per ottenere sia lo stato che il contesto.
  • Controlla le azioni della piattaforma: identificare se Azure ha avviato un riavvio o un arresto.
  • Migliorare il monitoraggio dell'SLA: attribuire i guasti a cause specifiche per l'analisi dell'impatto commerciale.
  • Creare dashboard: visualizzare le annotazioni di stato insieme ad altri metadati delle risorse.

Per altre informazioni su queste tabelle, vedere Grafico delle risorse di disponibilità della macchina virtuale.

Proprietà di HealthResources

Screenshot dei campi mostrati nella colonna delle proprietà di Integrità risorse.

Questi campi delle proprietà forniscono effettivamente le informazioni sulla salute:

Proprietà Description
availabilityState Stato di integrità corrente: disponibile, non disponibile o danneggiato
previousAvailabilityState Stato di integrità precedente prima dello stato corrente
reasonType Motivo dello stato di integrità corrente (ad esempio, PlatformInitiated, UserInitiated)
reasonChronicityType Indica se il problema è persistente o temporaneo
annotationName Etichetta descrittiva per l'evento di integrità del sistema (ad esempio, VirtualMachineRestarted)
title Titolo dell'evento Salute
summary Riepilogo dell'evento di salute
impactStartTime Timestamp all'inizio dell'evento
impactMitigationTime Timestamp quando è prevista o completata la mitigazione
recommendedActions Azioni suggerite per l'utente

Funzionamento di questi campi

  • Monitoraggio e avvisi: availabilityState, reasonTypee impactStartTime consentono di identificare e rispondere a interruzioni o riduzione delle prestazioni.
  • Analisi della causa radice: reasonChronicityType, annotationNamee summary forniscono il contesto per la risoluzione dei problemi.
  • Governance e creazione di report: location, subscriptionIde resourceGroup consentono il filtro e l'aggregazione tra ambienti.
  • Automazione: recommendedActions può essere usata per attivare flussi di lavoro di correzione automatizzati.

Risoluzione dei problemi

Domanda
Perché maintenanceStartTime, maintenanceEndTime e info vengono visualizzati come null nei risultati della query ARG?
Risposta
Questi campi possono essere visualizzati null nelle query ARG per gli eventi microsoft.resourcehealth a causa di diversi fattori. La comprensione dei campi consente di interpretare i dati in modo più accurato.

  • Dipendenza del tipo di evento:
    Solo gli eventi di manutenzione pianificata includono dettagli sui tempi di manutenzione. Altri tipi di evento, ad esempio Problema del servizio o Avviso di sicurezza, non usano tali campi, quindi sono Null.
  • Ciclo di vita degli eventi e controllo di accesso:
    • Gli eventi appena creati o in fase iniziale potrebbero non avere i dettagli completi per compilare i campi o le finestre di manutenzione confermate.
    • Alcuni eventi sensibili richiedono autorizzazioni elevate per visualizzare i dati completi. Senza l'accesso corretto, i campi vengono visualizzati vuoti.
  • Cronologia eventi e consigli:
    • Filtrare gli eventi PlannedMaintenance.
    • Verificare il ruolo e le autorizzazioni di accesso.
    • Controllare lo stato dell'evento.
    • Segnalare eventuali gap di dati coerenti tramite i canali di supporto appropriati.

Se maintenanceStartTime, maintenanceEndTime o info vengono visualizzati come "null" come valore nei risultati della query ARG, dovresti controllare il riquadro della Manutenzione pianificata. Screenshot del riquadro Manutenzione pianificata.

Per altre informazioni sulle query, vedere:

  • Last updated on