Funzioni di sistema per Backup di Azure

Questo articolo descrive come scrivere query personalizzate nei log di Monitoraggio di Azure usando le funzioni di sistema.

Backup di Azure fornisce un set di funzioni, denominate funzioni di sistema o funzioni della soluzione disponibili per impostazione predefinita nelle aree di lavoro Log Analytics (LA).

Queste funzioni operano sui dati nelle tabelle Backup di Azure non elaborate in LA e restituiscono dati formattati che consentono di recuperare facilmente informazioni di tutte le entità correlate al backup, usando query semplici. Gli utenti possono passare parametri a queste funzioni per filtrare i dati restituiti da queste funzioni.

È consigliabile usare le funzioni di sistema per eseguire query sui dati di backup nelle aree di lavoro di La per creare report personalizzati, in quanto offrono numerosi vantaggi, come descritto nella sezione seguente.

Vantaggi dell'uso delle funzioni di sistema

• Query più semplici: l'uso delle funzioni consente di ridurre il numero di join necessari nelle query. Per impostazione predefinita, le funzioni restituiscono schemi "flat" che incorporano tutte le informazioni relative all'entità (istanza di backup, processo, insieme di credenziali e così via) sottoposte a query. Ad esempio, se è necessario ottenere un elenco di processi di backup riusciti in base al nome dell'elemento di backup e al contenitore associato, una semplice chiamata alla funzione _AzureBackup_getJobs() fornirà tutte queste informazioni per ogni processo. D'altra parte, l'esecuzione di query direttamente sulle tabelle non elaborate richiederebbe l'esecuzione di più join tra le tabelle AddonAzureBackupJobs e CoreAzureBackup .

• Transizione più fluida dall'evento di diagnostica legacy: l'uso delle funzioni di sistema consente di passare senza problemi dall'evento di diagnostica legacy (AzureBackupReport in modalità AzureDiagnostics) agli eventi specifici delle risorse. Tutte le funzioni di sistema fornite da Backup di Azure consentono di specificare un parametro che consente di scegliere se la funzione deve eseguire query sui dati solo dalle tabelle specifiche della risorsa o eseguire query sui dati della tabella legacy e delle tabelle specifiche delle risorse (con deduplicazione dei record).

  • Se è stata eseguita correttamente la migrazione alle tabelle specifiche delle risorse, è possibile scegliere di escludere la tabella legacy dalla query eseguita dalla funzione.
  • Se si sta attualmente eseguendo la migrazione e si dispone di alcuni dati nelle tabelle legacy necessarie per l'analisi, è possibile scegliere di includere la tabella legacy. Al termine della transizione e non sono più necessari dati dalla tabella legacy, è possibile aggiornare il valore del parametro passato alla funzione nelle query per escludere la tabella legacy.
  • Se si usa ancora solo la tabella legacy, le funzioni continueranno a funzionare se si sceglie di includere la tabella legacy tramite lo stesso parametro. Tuttavia, è consigliabile passare alle tabelle specifiche delle risorse prima.

• Riduce la possibilità di interruzione delle query personalizzate: se Backup di Azure introduce miglioramenti allo schema delle tabelle LA sottostanti per supportare scenari di creazione di report futuri, la definizione delle funzioni verrà aggiornata anche per tenere conto delle modifiche dello schema. Pertanto, se si usano funzioni di sistema per la creazione di query personalizzate, le query non verranno interrotte, anche se sono presenti modifiche nello schema sottostante delle tabelle.

Tipi di funzioni di sistema offerte da Backup di Azure

• Funzioni principali: queste sono funzioni che consentono di eseguire query su qualsiasi entità chiave Backup di Azure, ad esempio istanze di backup, insiemi di credenziali, criteri, processi ed entità di fatturazione. Ad esempio, la funzione _AzureBackup_getBackupInstances restituisce un elenco di tutte le istanze di backup presenti nell'ambiente a partire dall'ultimo giorno completato (in formato UTC). I parametri e lo schema restituito per ognuna di queste funzioni di base sono riepilogati di seguito in questo articolo.

• Funzioni di tendenza: si tratta di funzioni che restituiscono record cronologici per le entità correlate al backup (ad esempio, istanze di backup, gruppi di fatturazione) e consentono di ottenere informazioni sulla tendenza giornaliera, settimanale e mensile sulle metriche chiave (ad esempio, Conteggio, Archiviazione utilizzata) relative a queste entità. I parametri e lo schema restituito per ognuna di queste funzioni di tendenza sono riepilogati di seguito in questo articolo.

Elenco delle funzioni di sistema

Funzioni di sistema

_AzureBackup_GetVaults()

Questa funzione restituisce l'elenco di tutti gli insiemi di credenziali di Servizi di ripristino nell'ambiente di Azure associati all'area di lavoro la.

Parametri

Campi restituiti

_AzureBackup_GetPolicies()

Questa funzione restituisce l'elenco dei criteri di backup usati nell'ambiente Azure insieme a informazioni dettagliate su ogni criterio, ad esempio il tipo di origine dati, il tipo di replica di archiviazione e così via.

Parametri

Campi restituiti

_AzureBackup_GetJobs()

Questa funzione restituisce un elenco di tutti i processi correlati di backup e ripristino attivati in un intervallo di tempo specificato, insieme a informazioni dettagliate su ogni processo, ad esempio lo stato del processo, la durata del processo, i dati trasferiti e così via.

Parametri

Campi restituiti

_AzureBackup_GetBackupInstances()

Questa funzione restituisce l'elenco delle istanze di backup associate agli insiemi di credenziali di Servizi di ripristino, insieme a informazioni dettagliate su ogni istanza di backup, ad esempio l'utilizzo dell'archiviazione cloud, i criteri associati e così via.

Parametri

Campi restituiti

_AzureBackup_GetBillingGroups()

Questa funzione restituisce un elenco di tutte le entità di fatturazione correlate al backup (gruppi di fatturazione) insieme alle informazioni sui componenti di fatturazione chiave, ad esempio le dimensioni front-end e l'archiviazione cloud totale.

Parametri

Campi restituiti

Funzioni di tendenza

_AzureBackup_GetBackupInstancesTrends()

Questa funzione restituisce record cronologici per ogni istanza di backup, consentendo di visualizzare le tendenze chiave giornaliere, settimanali e mensili correlate al numero di istanze di backup e al consumo di archiviazione, a più livelli di granularità.

Parametri

Campi restituiti

_AzureBackup_GetBillingGroupsTrends()

Questa funzione restituisce record cronologici per ogni entità di fatturazione, consentendo di visualizzare le tendenze chiave giornaliere, settimanali e mensili correlate alle dimensioni front-end e al consumo di archiviazione, a più livelli di granularità.

Parametri

Campi restituiti

Query di esempio

Di seguito sono riportate alcune query di esempio che consentono di iniziare a usare le funzioni di sistema.

• Tutti i processi di backup delle macchine virtuali di Azure non riusciti in un determinato intervallo di tempo

  _AzureBackup_GetJobs("2021-03-05", "2021-03-06") //call function with RangeStart and RangeEnd parameters set, and other parameters with default value
  | where BackupSolution=="Azure Virtual Machine Backup" and Status=="Failed"
  | project BackupInstanceFriendlyName, BackupInstanceId, OperationCategory, Status,  JobStartDateTime=StartTime, JobDuration=DurationInSecs/3600, ErrorTitle, DataTransferred=DataTransferredInMBs
  

• Tutti i processi di backup del log SQL in un determinato intervallo di tempo

  _AzureBackup_GetJobs("2021-03-05", "2021-03-06","*","*","*","*",true,"*","*","*","*","*","*",false) //call function with RangeStart and RangeEnd parameters set, ExcludeLog parameter as false, and other parameters with default value
  | where BackupSolution=="SQL in Azure VM Backup" and Operation=="Log"
  | project BackupInstanceFriendlyName, BackupInstanceId, OperationCategory, Status,  JobStartDateTime=StartTime, JobDuration=DurationInSecs/3600, ErrorTitle, DataTransferred=DataTransferredInMBs
  

• Tendenza settimanale dell'archiviazione di backup usata per la macchina virtuale "testvm"

  _AzureBackup_GetBackupInstancesTrends("2021-01-01", "2021-03-06","*","*","*","*",false,"*","*","*","*",true, "Weekly") //call function with RangeStart and RangeEnd parameters set, AggregationType parameter as Weekly, and other parameters with default value
  | where BackupSolution == "Azure Virtual Machine Backup"
  | where FriendlyName == "testvm"
  | project TimeGenerated, VaultStore_StorageConsumptionInMBs
  | render timechart 
  

Passaggi successivi

Altre informazioni sui Report di backup