Funzioni di sistema nei log di Monitoraggio 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.
Nota
Le funzioni di sistema vengono gestite da Microsoft e le relative definizioni non possono essere modificate dagli utenti. Se sono necessarie funzioni modificabili, è possibile creare funzioni salvate in LA.
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 utilizzate) relative a queste entità. I parametri e lo schema restituito per ognuna di queste funzioni di tendenza sono riepilogati di seguito in questo articolo.
Nota
Attualmente, le funzioni di sistema restituiscono dati fino all'ultimo giorno completato (in formato UTC). I dati per il giorno parziale corrente non vengono restituiti. Pertanto, se si desidera recuperare i record per il giorno corrente, sarà necessario usare le tabelle LA non elaborate.
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
| Nome del parametro | Descrizione | Obbligatorio? | Valore di esempio | Tipo di dati |
|---|---|---|---|---|
| RangeStart | Usare questo parametro insieme al parametro RangeEnd solo se è necessario recuperare tutti i record correlati all'insieme di credenziali nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd sono Null, che farà recuperare la funzione solo il record più recente per ogni insieme di credenziali. | N | "2021-03-03 00:00:00" | Data/Ora |
| RangeEnd | Usare questo parametro insieme al parametro RangeStart solo se è necessario recuperare tutti i record correlati all'insieme di credenziali nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd sono Null, che farà recuperare la funzione solo il record più recente per ogni insieme di credenziali. | N | "2021-03-10 00:00:00" | Data/Ora |
| VaultSubscriptionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di sottoscrizioni in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di ID sottoscrizione come parametro per questa funzione, è possibile recuperare solo gli insiemi di credenziali presenti nelle sottoscrizioni specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutte le sottoscrizioni. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Usare questo parametro per filtrare l'output della funzione per un determinato set di aree in cui sono presenti i dati di backup. La specifica di un elenco delimitato da virgole di aree come parametro per questa funzione consente di recuperare solo gli insiemi di credenziali presenti nelle aree specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record nella funzione in tutte le aree. | N | eastus,westus |
String |
| VaultList | Usare questo parametro per filtrare l'output della funzione per un determinato set di insiemi di credenziali. Se si specifica un elenco delimitato da virgole di nomi di insieme di credenziali come parametro per questa funzione, è possibile recuperare i record relativi solo agli insiemi di credenziali specificati. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutti gli insiemi di credenziali. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Usare questo parametro per filtrare l'output della funzione per i record relativi a un particolare tipo di insieme di credenziali. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca della funzione sia per gli insiemi di credenziali di Servizi di ripristino che per gli insiemi di credenziali di Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Usare questo parametro per scegliere se eseguire query sui dati nella tabella di AzureDiagnostics legacy. Se il valore di questo parametro è false, la funzione esegue una query sui dati della tabella AzureDiagnostics e delle tabelle specifiche della risorsa. Se il valore di questo parametro è true, la funzione esegue una query sui dati solo dalle tabelle specifiche della risorsa. Il valore predefinito è true. | N | true | Booleano |
Campi restituiti
| Nome campo | Descrizione | Tipo di dati |
|---|---|---|
| UniqueId | Chiave primaria che indica l'ID univoco dell'insieme di credenziali | String |
| ID. | ID di Azure Resource Manager (ARM) dell'insieme di credenziali | String |
| Nome | Nome dell'insieme di credenziali | String |
| SubscriptionId | ID della sottoscrizione in cui è presente l'insieme di credenziali | String |
| Ufficio | Posizione in cui è presente l'insieme di credenziali | String |
| VaultStore_Archiviazione ReplicationType | Archiviazione tipo di replica associato all'insieme di credenziali | String |
| Tag | Tag dell'insieme di credenziali | String |
| TimeGenerated | Timestamp del record | Data/Ora |
| Type | Tipo dell'insieme di credenziali, ad esempio "Microsoft.RecoveryServices/vaults" o "Microsoft.DataProtection/backupVaults" | String |
_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
| Nome del parametro | Descrizione | Obbligatorio? | Valore di esempio | Tipo di dati |
|---|---|---|---|---|
| RangeStart | Usare questo parametro insieme al parametro RangeStart solo se è necessario recuperare tutti i record correlati ai criteri nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd è Null, che farà recuperare la funzione solo il record più recente per ogni criterio. | N | "2021-03-03 00:00:00" | Data/Ora |
| RangeEnd | Usare questo parametro insieme al parametro RangeStart solo se è necessario recuperare tutti i record correlati ai criteri nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd è Null, che farà recuperare la funzione solo il record più recente per ogni criterio. | N | "2021-03-10 00:00:00" | Data/Ora |
| VaultSubscriptionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di sottoscrizioni in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di ID sottoscrizione come parametro per questa funzione, è possibile recuperare solo i criteri presenti nelle sottoscrizioni specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutte le sottoscrizioni. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Usare questo parametro per filtrare l'output della funzione per un determinato set di aree in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di aree come parametro per questa funzione, è possibile recuperare solo i criteri presenti nelle aree specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record nella funzione in tutte le aree. | N | eastus,westus |
String |
| VaultList | Usare questo parametro per filtrare l'output della funzione per un determinato set di insiemi di credenziali. Se si specifica un elenco delimitato da virgole di nomi di insieme di credenziali come parametro per questa funzione, è possibile recuperare i record dei criteri relativi solo agli insiemi di credenziali specificati. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record dei criteri in tutti gli insiemi di credenziali. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Usare questo parametro per filtrare l'output della funzione per i record relativi a un particolare tipo di insieme di credenziali. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca della funzione sia per gli insiemi di credenziali di Servizi di ripristino che per gli insiemi di credenziali di Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Usare questo parametro per scegliere se eseguire query sui dati nella tabella di AzureDiagnostics legacy. Se il valore di questo parametro è false, la funzione esegue una query sui dati della tabella AzureDiagnostics e delle tabelle specifiche della risorsa. Se il valore di questo parametro è true, la funzione esegue una query sui dati solo dalle tabelle specifiche della risorsa. Il valore predefinito è true. | N | true | Booleano |
| BackupSolutionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di soluzioni di backup usate nell'ambiente Azure. Ad esempio, se si specifica Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM come valore di questo parametro, la funzione restituisce solo i record correlati agli elementi di cui è stato eseguito il backup usando il backup di macchine virtuali di Azure, SQL nel backup di macchine virtuali di Azure o DPM in Backup di Azure. Per impostazione predefinita, il valore di questo parametro è '*', che rende la funzione restituisce record relativi a tutte le soluzioni di backup supportate dai report di backup (i valori supportati sono "Backup di macchine virtuali di Azure", "SQL in Backup delle macchine virtuali di Azure", "SAP HANA in Backup delle macchine virtuali di Azure", "Archiviazione di Azure (File di Azure) Backup", "Backup di Azure Agent", "DPM", " Backup di Azure Server", "Database di Azure per PostgreSQL Server Backup", "Backup BLOB di Azure", "Backup dischi di Azure" o una combinazione delimitata da virgole di uno di questi valori). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
Campi restituiti
| Nome campo | Descrizione | **Tipo di dati ** |
|---|---|---|
| UniqueId | Chiave primaria che indica l'ID univoco dei criteri | String |
| ID. | ID di Azure Resource Manager (ARM) dei criteri | String |
| Nome | Nome del criterio | String |
| TimeZone | Fuso orario in cui è definito il criterio | String |
| Soluzione di backup | Soluzione di backup a cui sono associati i criteri. Ad esempio, Backup di macchine virtuali di Azure, SQL in Backup di macchine virtuali di Azure e così via. | String |
| TimeGenerated | Timestamp del record | Datetime |
| VaultUniqueId | Chiave esterna che fa riferimento all'insieme di credenziali associato ai criteri | String |
| VaultResourceId | ID di Azure Resource Manager (ARM) dell'insieme di credenziali associato ai criteri | String |
| VaultName | Nome dell'insieme di credenziali associato al criterio | String |
| VaultTags | Tag dell'insieme di credenziali associato al criterio | String |
| VaultLocation | Posizione dell'insieme di credenziali associato ai criteri | String |
| VaultSubscriptionId | ID sottoscrizione dell'insieme di credenziali associato al criterio | String |
| VaultStore_Archiviazione ReplicationType | Archiviazione tipo di replica dell'insieme di credenziali associato ai criteri | String |
| VaultType | Tipo dell'insieme di credenziali, ad esempio "Microsoft.RecoveryServices/vaults" o "Microsoft.DataProtection/backupVaults" | String |
| ExtendedProperties | Proprietà aggiuntive dei criteri | Dinamico |
_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
| Nome del parametro | Descrizione | Obbligatorio? | Valore di esempio | **Tipo di dati ** |
|---|---|---|---|---|
| RangeStart | Usare questo parametro insieme al parametro RangeEnd per recuperare l'elenco di tutti i processi avviati nel periodo di tempo da RangeStart a RangeEnd. | Y | "2021-03-03 00:00:00" | Data/Ora |
| RangeEnd | Usare questo parametro insieme al parametro RangeStart per recuperare l'elenco di tutti i processi avviati nel periodo di tempo da RangeStart a RangeEnd. | Y | "2021-03-10 00:00:00" | Data/Ora |
| VaultSubscriptionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di sottoscrizioni in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di ID sottoscrizione come parametro per questa funzione, è possibile recuperare solo i processi associati agli insiemi di credenziali nelle sottoscrizioni specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutte le sottoscrizioni. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Usare questo parametro per filtrare l'output della funzione per un determinato set di aree in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di aree come parametro per questa funzione, è possibile recuperare solo i processi associati agli insiemi di credenziali nelle aree specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record nella funzione in tutte le aree. | N | eastus,westus |
String |
| VaultList | Usare questo parametro per filtrare l'output della funzione per un determinato set di insiemi di credenziali. Se si specifica un elenco delimitato da virgole di nomi di insieme di credenziali come parametro per questa funzione, è possibile recuperare i processi relativi solo agli insiemi di credenziali specificati. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei processi in tutti gli insiemi di credenziali. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Usare questo parametro per filtrare l'output della funzione per i record relativi a un particolare tipo di insieme di credenziali. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca della funzione sia per gli insiemi di credenziali di Servizi di ripristino che per gli insiemi di credenziali di Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Usare questo parametro per scegliere se eseguire query sui dati nella tabella di AzureDiagnostics legacy. Se il valore di questo parametro è false, la funzione esegue una query sui dati della tabella AzureDiagnostics e delle tabelle specifiche della risorsa. Se il valore di questo parametro è true, la funzione esegue una query sui dati solo dalle tabelle specifiche della risorsa. Il valore predefinito è true. | N | true | Booleano |
| BackupSolutionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di soluzioni di backup usate nell'ambiente Azure. Ad esempio, se si specifica Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM come valore di questo parametro, la funzione restituisce solo i record correlati agli elementi di cui è stato eseguito il backup usando il backup di macchine virtuali di Azure, SQL nel backup di macchine virtuali di Azure o DPM in Backup di Azure. Per impostazione predefinita, il valore di questo parametro è '*', che rende la funzione restituisce record relativi a tutte le soluzioni di backup supportate dai report di backup (i valori supportati sono "Backup di macchine virtuali di Azure", "SQL in Backup delle macchine virtuali di Azure", "SAP HANA in Backup delle macchine virtuali di Azure", "Archiviazione di Azure (File di Azure) Backup", "Backup di Azure Agent", "DPM", " Backup di Azure Server", "Database di Azure per PostgreSQL Server Backup", "Backup BLOB di Azure", "Backup dischi di Azure" o una combinazione delimitata da virgole di uno di questi valori). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| JobOperationList | Usare questo parametro per filtrare l'output della funzione per un tipo specifico di processo. Ad esempio, le operazioni di backup o ripristino. Per impostazione predefinita, il valore di questo parametro è "*", che esegue la ricerca della funzione sia per i processi di backup che di ripristino. | N | "Backup" | String |
| JobStatusList | Usare questo parametro per filtrare l'output della funzione per uno stato di processo specifico. Ad esempio, Completato, Non riuscito e così via. Per impostazione predefinita, il valore di questo parametro è "*", che esegue la ricerca della funzione per tutti i processi indipendentemente dallo stato. | N | Failed,CompletedWithWarnings |
String |
| JobFailureCodeList | Usare questo parametro per filtrare l'output della funzione per un codice di errore specifico. Per impostazione predefinita, il valore di questo parametro è "*", che esegue la ricerca della funzione per tutti i processi indipendentemente dal codice di errore. | N | "Esito positivo" | String |
| DatasourceSetName | Usare questo parametro per filtrare l'output della funzione in una determinata risorsa padre. Ad esempio, per restituire SQL nelle istanze di backup di macchine virtuali di Azure appartenenti alla macchina virtuale "testvm", specificare testvm come valore di questo parametro. Per impostazione predefinita, il valore è "*", che esegue la ricerca dei record in tutte le istanze di backup. | N | "testvm" | String |
| BackupInstanceName | Usare questo parametro per cercare i processi in una determinata istanza di backup in base al nome. Per impostazione predefinita, il valore è "*", che esegue la ricerca dei record in tutte le istanze di backup. | N | "testvm" | String |
| ExcludeLog | Usare questo parametro per escludere i processi di log dall'essere restituiti dalla funzione (consente di ottenere prestazioni delle query). Per impostazione predefinita, il valore di questo parametro è true, che rende la funzione esclude i processi di log. | N | true | Booleano |
Campi restituiti
| Nome campo | Descrizione | **Tipo di dati ** |
|---|---|---|
| UniqueId | Chiave primaria che indica l'ID univoco del processo | String |
| OperationCategory | Categoria dell'operazione eseguita. Ad esempio, Backup, Ripristino | String |
| Operazione | Dettagli dell'operazione eseguita. Ad esempio, Log (per il backup del log) | String |
| Status | Stato del processo. Ad esempio, Completed, Failed, CompletedWithWarnings | String |
| ErrorTitle | Codice di errore del processo | String |
| StartTime | Data e ora di inizio del processo | Data/Ora |
| DurationInSecs | Durata del processo in secondi | Double |
| DataTransferredInMBs | Dati trasferiti dal processo in MB. Attualmente, questo campo è supportato solo per i carichi di lavoro dell'insieme di credenziali di Servizi di ripristino | Double |
| RestoreJobRPDateTime | Data e ora di creazione del punto di ripristino da recuperare. Attualmente, questo campo è supportato solo per i carichi di lavoro dell'insieme di credenziali di Servizi di ripristino | Data/Ora |
| RestoreJobRPLocation | Posizione in cui è stato archiviato il punto di ripristino in corso di ripristino | String |
| BackupInstanceUniqueId | Chiave esterna che fa riferimento all'istanza di backup associata al processo | String |
| BackupInstanceId | ID di Azure Resource Manager (ARM) dell'istanza di backup associata al processo | String |
| BackupInstanceFriendlyName | Nome dell'istanza di backup associata al processo | String |
| DatasourceResourceId | ID di Azure Resource Manager (ARM) dell'origine dati sottostante associata al processo. Ad esempio, ID di Azure Resource Manager (ARM) della macchina virtuale | String |
| DatasourceFriendlyName | Nome descrittivo dell'origine dati sottostante associata al processo | String |
| DatasourceType | Tipo dell'origine dati associata al processo. Ad esempio " Microsoft.Compute/virtualMachines" | String |
| BackupSolution | Soluzione di backup a cui è associato il processo. Ad esempio, Backup di macchine virtuali di Azure, SQL in Backup di macchine virtuali di Azure e così via. | String |
| DatasourceSetResourceId | ID di Azure Resource Manager (ARM) della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'istanza di SQL nell'origine dati della macchina virtuale di Azure, questo campo conterrà l'ID di Azure Resource Manager (ARM) della macchina virtuale in cui esiste il database SQL | String |
| DatasourceSetType | Tipo della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'origine dati SAP HANA nella macchina virtuale di Azure, questo campo sarà Microsoft.Compute/virtualMachines perché la risorsa padre è una macchina virtuale di Azure | String |
| VaultResourceId | ID di Azure Resource Manager (ARM) dell'insieme di credenziali associato al processo | String |
| VaultUniqueId | Chiave esterna che fa riferimento all'insieme di credenziali associato al processo | String |
| VaultName | Nome dell'insieme di credenziali associato al processo | String |
| VaultTags | Tag dell'insieme di credenziali associato al processo | String |
| VaultSubscriptionId | ID sottoscrizione dell'insieme di credenziali associato al processo | String |
| VaultLocation | Posizione dell'insieme di credenziali associato al processo | String |
| VaultStore_Archiviazione ReplicationType | Archiviazione tipo di replica dell'insieme di credenziali associato al processo | String |
| VaultType | Tipo dell'insieme di credenziali, ad esempio "Microsoft.RecoveryServices/vaults" o "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Timestamp del record | Data/Ora |
_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
| Nome del parametro | Descrizione | Obbligatorio? | Valore di esempio | **Tipo di dati ** |
|---|---|---|---|---|
| RangeStart | Usare questo parametro insieme al parametro RangeEnd solo se è necessario recuperare tutti i record correlati all'istanza di backup nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd è Null, che farà recuperare la funzione solo il record più recente per ogni istanza di backup. | N | "2021-03-03 00:00:00" | DataTime |
| RangeEnd | Usare questo parametro insieme al parametro RangeStart solo se è necessario recuperare tutti i record correlati all'istanza di backup nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd è Null, che farà recuperare la funzione solo il record più recente per ogni istanza di backup. | N | "2021-03-10 00:00:00" | Data/Ora |
| VaultSubscriptionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di sottoscrizioni in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di ID sottoscrizione come parametro per questa funzione, è possibile recuperare solo le istanze di backup presenti nelle sottoscrizioni specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutte le sottoscrizioni. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Usare questo parametro per filtrare l'output della funzione per un determinato set di aree in cui sono presenti i dati di backup. La specifica di un elenco delimitato da virgole di aree come parametro per questa funzione consente di recuperare solo le istanze di backup presenti nelle aree specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record nella funzione in tutte le aree. | N | eastus,westus |
String |
| VaultList | Usare questo parametro per filtrare l'output della funzione per un determinato set di insiemi di credenziali. Se si specifica un elenco delimitato da virgole di nomi di insieme di credenziali come parametro per questa funzione, è possibile recuperare i record delle istanze di backup relative solo agli insiemi di credenziali specificati. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record delle istanze di backup in tutti gli insiemi di credenziali. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Usare questo parametro per filtrare l'output della funzione per i record relativi a un particolare tipo di insieme di credenziali. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca della funzione sia per gli insiemi di credenziali di Servizi di ripristino che per gli insiemi di credenziali di Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Usare questo parametro per scegliere se eseguire query sui dati nella tabella di AzureDiagnostics legacy. Se il valore di questo parametro è false, la funzione esegue una query sui dati della tabella AzureDiagnostics e delle tabelle specifiche della risorsa. Se il valore di questo parametro è true, la funzione esegue una query sui dati solo dalle tabelle specifiche della risorsa. Il valore predefinito è true. | N | true | Booleano |
| BackupSolutionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di soluzioni di backup usate nell'ambiente Azure. Ad esempio, se si specifica Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM come valore di questo parametro, la funzione restituisce solo i record correlati agli elementi di cui è stato eseguito il backup usando il backup di macchine virtuali di Azure, SQL nel backup di macchine virtuali di Azure o DPM in Backup di Azure. Per impostazione predefinita, il valore di questo parametro è '*', che rende la funzione restituisce record relativi a tutte le soluzioni di backup supportate dai report di backup (i valori supportati sono "Backup di macchine virtuali di Azure", "SQL in Backup delle macchine virtuali di Azure", "SAP HANA in Backup delle macchine virtuali di Azure", "Archiviazione di Azure (File di Azure) Backup", "Backup di Azure Agent", "DPM", " Backup di Azure Server", "Database di Azure per PostgreSQL Server Backup", "Backup BLOB di Azure", "Backup dischi di Azure" o una combinazione delimitata da virgole di uno di questi valori). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Usare questo parametro per scegliere se includere solo le istanze di backup protette attivamente o includere anche le istanze per le quali la protezione è stata arrestata e le istanze per cui il backup iniziale è in sospeso. Per i carichi di lavoro dell'insieme di credenziali dei servizi di ripristino, i valori supportati sono "Protected", "ProtectionStopped", "InitialBackupPending" o una combinazione delimitata da virgole di uno di questi valori. Per i carichi di lavoro dell'insieme di credenziali di Backup, i valori supportati sono "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" o una combinazione delimitata da virgole di uno di questi valori. Per impostazione predefinita, il valore è "*", che esegue la ricerca della funzione per tutte le istanze di backup indipendentemente dai dettagli di protezione. | N | "Protetto" | String |
| DatasourceSetName | Usare questo parametro per filtrare l'output della funzione in una determinata risorsa padre. Ad esempio, per restituire SQL nelle istanze di backup di macchine virtuali di Azure appartenenti alla macchina virtuale "testvm", specificare testvm come valore di questo parametro. Per impostazione predefinita, il valore è "*", che esegue la ricerca dei record in tutte le istanze di backup. | N | "testvm" | String |
| BackupInstanceName | Usare questo parametro per cercare una particolare istanza di backup in base al nome. Per impostazione predefinita, il valore è "*", che esegue la ricerca della funzione per tutte le istanze di backup. | N | "testvm" | String |
| DisplayAllFields | Utilizzare questo parametro per scegliere se recuperare solo un subset dei campi restituiti dalla funzione. Se il valore di questo parametro è false, la funzione elimina le informazioni correlate all'archiviazione e al punto di conservazione dall'output della funzione. Ciò è utile se si usa questa funzione come passaggio intermedio in una query più grande ed è necessario ottimizzare le prestazioni della query eliminando le colonne che non sono necessarie per l'analisi. Per impostazione predefinita, il valore di questo parametro è true, che rende la funzione restituisce tutti i campi relativi all'istanza di backup. | N | true | Booleano |
Campi restituiti
| Nome campo | Descrizione | Tipo di dati |
|---|---|---|
| UniqueId | Chiave primaria che indica l'ID univoco dell'istanza di backup | String |
| ID. | ID di Azure Resource Manager (ARM) dell'istanza di backup | String |
| FriendlyName | Nome descrittivo dell'istanza di backup | String |
| ProtectionInfo | Informazioni sulle impostazioni di protezione dell'istanza di backup. Ad esempio, la protezione è configurata, la protezione è stata arrestata, il backup iniziale in sospeso | String |
| LatestRecoveryPoint | Data e ora del punto di ripristino più recente associato all'istanza di backup. Attualmente, questo campo è supportato solo per i carichi di lavoro dell'insieme di credenziali di Servizi di ripristino. | Data/Ora |
| OldestRecoveryPoint | Data e ora del punto di ripristino meno recente associato all'istanza di backup. Attualmente, questo campo è supportato solo per i carichi di lavoro dell'insieme di credenziali di Servizi di ripristino. | Data/Ora |
| SourceSizeInMBs | Dimensioni front-end dell'istanza di backup in MB | Double |
| VaultStore_Archiviazione ConsumptionInMBs | Totale spazio di archiviazione cloud usato dall'istanza di backup nel livello standard dell'insieme di credenziali | Double |
| DataSourceFriendlyName | Nome descrittivo dell'origine dati corrispondente all'istanza di backup | String |
| BackupSolution | Soluzione di backup a cui è associata l'istanza di backup. Ad esempio, Backup di macchine virtuali di Azure, SQL in Backup di macchine virtuali di Azure e così via. | String |
| DatasourceType | Tipo dell'origine dati corrispondente all'istanza di backup. Ad esempio " Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | ID di Azure Resource Manager (ARM) dell'origine dati sottostante corrispondente all'istanza di backup. Ad esempio, ID di Azure Resource Manager (ARM) della macchina virtuale | String |
| DatasourceSetFriendlyName | Nome descrittivo della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'origine dati SQL nella macchina virtuale di Azure, questo campo conterrà il nome della macchina virtuale in cui esiste il database SQL | String |
| DatasourceSetFriendlyName | Nome descrittivo della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'origine dati SQL nella macchina virtuale di Azure, questo campo conterrà il nome della macchina virtuale in cui esiste il database SQL | String |
| DatasourceSetResourceId | ID di Azure Resource Manager (ARM) della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'istanza di SQL nell'origine dati della macchina virtuale di Azure, questo campo conterrà l'ID di Azure Resource Manager (ARM) della macchina virtuale in cui esiste il database SQL | String |
| DatasourceSetType | Tipo della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'origine dati SAP HANA nella macchina virtuale di Azure, questo campo sarà Microsoft.Compute/virtualMachines perché la risorsa padre è una macchina virtuale di Azure | String |
| PolicyName | Nome dei criteri associati all'istanza di backup | String |
| PolicyUniqueId | Chiave esterna che fa riferimento ai criteri associati all'istanza di backup | String |
| PolicyId | ID di Azure Resource Manager (ARM) dei criteri associati all'istanza di backup | String |
| VaultResourceId | ID di Azure Resource Manager (ARM) dell'insieme di credenziali associato all'istanza di backup | String |
| VaultUniqueId | Chiave esterna che fa riferimento all'insieme di credenziali associato all'istanza di backup | String |
| VaultName | Nome dell'insieme di credenziali associato all'istanza di backup | String |
| VaultTags | Tag dell'insieme di credenziali associato all'istanza di backup | String |
| VaultSubscriptionId | ID sottoscrizione dell'insieme di credenziali associato all'istanza di backup | String |
| VaultLocation | Posizione dell'insieme di credenziali associato all'istanza di backup | String |
| VaultStore_Archiviazione ReplicationType | Archiviazione tipo di replica dell'insieme di credenziali associato all'istanza di backup | String |
| VaultType | Tipo dell'insieme di credenziali, ovvero "Microsoft.RecoveryServices/vaults" o "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Timestamp del record | Data/Ora |
_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
| Nome del parametro | Descrizione | Obbligatorio? | Valore di esempio | Tipo di data |
|---|---|---|---|---|
| RangeStart | Usare questo parametro insieme al parametro RangeEnd solo se è necessario recuperare tutti i record correlati al gruppo di fatturazione nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd è Null, che farà recuperare la funzione solo il record più recente per ogni gruppo di fatturazione. | N | "2021-03-03 00:00:00" | Data/Ora |
| RangeEnd | Usare questo parametro insieme al parametro RangeStart solo se è necessario recuperare tutti i record correlati al gruppo di fatturazione nel periodo di tempo da RangeStart a RangeEnd. Per impostazione predefinita, il valore di RangeStart e RangeEnd è Null, che farà recuperare la funzione solo il record più recente per ogni gruppo di fatturazione. | N | "2021-03-10 00:00:00" | Data/Ora |
| VaultSubscriptionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di sottoscrizioni in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di ID sottoscrizione come parametro per questa funzione, è possibile recuperare solo i gruppi di fatturazione presenti nelle sottoscrizioni specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutte le sottoscrizioni. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Usare questo parametro per filtrare l'output della funzione per un determinato set di aree in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di aree come parametro per questa funzione, è possibile recuperare solo i gruppi di fatturazione che si trovano nelle aree specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record nella funzione in tutte le aree. | N | eastus,westus |
String |
| VaultList | Usare questo parametro per filtrare l'output della funzione per un determinato set di insiemi di credenziali. Se si specifica un elenco delimitato da virgole di nomi di insieme di credenziali come parametro per questa funzione, è possibile recuperare i record delle istanze di backup relative solo agli insiemi di credenziali specificati. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record dei gruppi di fatturazione in tutti gli insiemi di credenziali. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Usare questo parametro per filtrare l'output della funzione per i record relativi a un particolare tipo di insieme di credenziali. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca della funzione sia per gli insiemi di credenziali di Servizi di ripristino che per gli insiemi di credenziali di Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Usare questo parametro per scegliere se eseguire query sui dati nella tabella di AzureDiagnostics legacy. Se il valore di questo parametro è false, la funzione esegue una query sui dati della tabella AzureDiagnostics e delle tabelle specifiche della risorsa. Se il valore di questo parametro è true, la funzione esegue una query sui dati solo dalle tabelle specifiche della risorsa. Il valore predefinito è true. | N | true | Booleano |
| BackupSolutionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di soluzioni di backup usate nell'ambiente Azure. Ad esempio, se si specifica Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM come valore di questo parametro, la funzione restituisce solo i record correlati agli elementi di cui è stato eseguito il backup usando il backup di macchine virtuali di Azure, SQL nel backup di macchine virtuali di Azure o DPM in Backup di Azure. Per impostazione predefinita, il valore di questo parametro è '*', che rende la funzione restituisce record relativi a tutte le soluzioni di backup supportate dai report di backup (i valori supportati sono "Backup di macchine virtuali di Azure", "SQL in Backup delle macchine virtuali di Azure", "SAP HANA in Backup delle macchine virtuali di Azure", "Archiviazione di Azure (File di Azure) Backup", "Backup di Azure Agent", "DPM", " Backup di Azure Server", "Database di Azure per PostgreSQL Server Backup", "Backup BLOB di Azure", "Backup dischi di Azure" o una combinazione delimitata da virgole di uno di questi valori). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Usare questo parametro per cercare un determinato gruppo di fatturazione in base al nome. Per impostazione predefinita, il valore è "*", che esegue la ricerca della funzione per tutti i gruppi di fatturazione. | N | "testvm" | String |
Campi restituiti
| Nome campo | Descrizione | Tipo di dati |
|---|---|---|
| UniqueId | Chiave primaria che indica l'ID univoco del gruppo di fatturazione | String |
| FriendlyName | Nome descrittivo del gruppo di fatturazione | String |
| Nome | Nome del gruppo di fatturazione | String |
| Type | Tipo di gruppo di fatturazione. Ad esempio, ProtectedContainer o BackupItem | String |
| SourceSizeInMBs | Dimensioni front-end del gruppo di fatturazione in MB | Double |
| VaultStore_Archiviazione ConsumptionInMBs | Totale spazio di archiviazione cloud utilizzato dal gruppo di fatturazione nel livello standard dell'insieme di credenziali | Double |
| BackupSolution | Soluzione di backup a cui è associato il gruppo di fatturazione. Ad esempio, Backup di macchine virtuali di Azure, SQL in Backup di macchine virtuali di Azure e così via. | String |
| VaultResourceId | ID di Azure Resource Manager (ARM) dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultUniqueId | Chiave esterna che fa riferimento all'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultName | Nome dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultTags | Tag dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultSubscriptionId | ID sottoscrizione dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultLocation | Posizione dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultStore_Archiviazione ReplicationType | Archiviazione tipo di replica dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultType | Tipo dell'insieme di credenziali, ad esempio "Microsoft.RecoveryServices/vaults" o "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Timestamp del record | Data/Ora |
| ExtendedProperties | Proprietà aggiuntive del gruppo di fatturazione | Dinamico |
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
| Nome del parametro | Descrizione | Obbligatorio? | Valore di esempio | Tipo di dati |
|---|---|---|---|---|
| RangeStart | Usare questo parametro insieme al parametro RangeEnd per recuperare tutti i record correlati all'istanza di backup nel periodo di tempo da RangeStart a RangeEnd. | Y | "2021-03-03 00:00:00" | Data/Ora |
| RangeEnd | Usare questo parametro insieme al parametro RangeStart per recuperare tutti i record correlati all'istanza di backup nel periodo di tempo da RangeStart a RangeEnd. | Y | "2021-03-10 00:00:00" | Data/Ora |
| VaultSubscriptionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di sottoscrizioni in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di ID sottoscrizione come parametro per questa funzione, è possibile recuperare solo le istanze di backup presenti nelle sottoscrizioni specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutte le sottoscrizioni. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Usare questo parametro per filtrare l'output della funzione per un determinato set di aree in cui sono presenti i dati di backup. La specifica di un elenco delimitato da virgole di aree come parametro per questa funzione consente di recuperare solo le istanze di backup presenti nelle aree specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record nella funzione in tutte le aree. | N | eastus,westus |
String |
| VaultList | Usare questo parametro per filtrare l'output della funzione per un determinato set di insiemi di credenziali. Se si specifica un elenco delimitato da virgole di nomi di insieme di credenziali come parametro per questa funzione, è possibile recuperare i record delle istanze di backup relative solo agli insiemi di credenziali specificati. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record delle istanze di backup in tutti gli insiemi di credenziali. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Usare questo parametro per filtrare l'output della funzione per i record relativi a un particolare tipo di insieme di credenziali. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca della funzione sia per gli insiemi di credenziali di Servizi di ripristino che per gli insiemi di credenziali di Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Usare questo parametro per scegliere se eseguire query sui dati nella tabella di AzureDiagnostics legacy. Se il valore di questo parametro è false, la funzione esegue una query sui dati della tabella AzureDiagnostics e delle tabelle specifiche della risorsa. Se il valore di questo parametro è true, la funzione esegue una query sui dati solo dalle tabelle specifiche della risorsa. Il valore predefinito è true. | N | true | Booleano |
| BackupSolutionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di soluzioni di backup usate nell'ambiente Azure. Ad esempio, se si specifica Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM come valore di questo parametro, la funzione restituisce solo i record correlati agli elementi di cui è stato eseguito il backup usando il backup di macchine virtuali di Azure, SQL nel backup di macchine virtuali di Azure o DPM in Backup di Azure. Per impostazione predefinita, il valore di questo parametro è '*', che rende la funzione restituisce record relativi a tutte le soluzioni di backup supportate dai report di backup (i valori supportati sono "Backup di macchine virtuali di Azure", "SQL in Backup delle macchine virtuali di Azure", "SAP HANA in Backup delle macchine virtuali di Azure", "Archiviazione di Azure (File di Azure) Backup", "Backup di Azure Agent", "DPM", " Backup di Azure Server", "Database di Azure per PostgreSQL Server Backup", "Backup BLOB di Azure", "Backup dischi di Azure" o una combinazione delimitata da virgole di uno di questi valori). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Usare questo parametro per scegliere se includere solo le istanze di backup protette attivamente o includere anche le istanze per le quali la protezione è stata arrestata e le istanze per cui il backup iniziale è in sospeso. Per i carichi di lavoro dell'insieme di credenziali dei servizi di ripristino, i valori supportati sono "Protected", "ProtectionStopped", "InitialBackupPending" o una combinazione delimitata da virgole di uno di questi valori. Per i carichi di lavoro dell'insieme di credenziali di Backup, i valori supportati sono "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" o una combinazione delimitata da virgole di uno di questi valori. Per impostazione predefinita, il valore è "*", che esegue la ricerca della funzione per tutte le istanze di backup indipendentemente dai dettagli di protezione. | N | "Protetto" | String |
| DatasourceSetName | Usare questo parametro per filtrare l'output della funzione in una determinata risorsa padre. Ad esempio, per restituire SQL nelle istanze di backup di macchine virtuali di Azure appartenenti alla macchina virtuale "testvm", specificare testvm come valore di questo parametro. Per impostazione predefinita, il valore è "*", che esegue la ricerca dei record in tutte le istanze di backup. | N | "testvm" | String |
| BackupInstanceName | Usare questo parametro per cercare una particolare istanza di backup in base al nome. Per impostazione predefinita, il valore è "*", che esegue la ricerca della funzione per tutte le istanze di backup. | N | "testvm" | String |
| DisplayAllFields | Utilizzare questo parametro per scegliere se recuperare solo un subset dei campi restituiti dalla funzione. Se il valore di questo parametro è false, la funzione elimina le informazioni correlate all'archiviazione e al punto di conservazione dall'output della funzione. Ciò è utile se si usa questa funzione come passaggio intermedio in una query più grande ed è necessario ottimizzare le prestazioni della query eliminando le colonne che non sono necessarie per l'analisi. Per impostazione predefinita, il valore di questo parametro è true, che rende la funzione restituisce tutti i campi relativi all'istanza di backup. | N | true | Booleano |
| AggregationType | Usare questo parametro per specificare la granularità temporale in corrispondenza della quale recuperare i dati. Se il valore di questo parametro è "Daily", la funzione restituisce un record per ogni istanza di backup al giorno, consentendo di analizzare le tendenze giornaliere del consumo di archiviazione e del numero di istanze di backup. Se il valore di questo parametro è "Weekly", la funzione restituisce un record per ogni istanza di backup alla settimana, consentendo di analizzare le tendenze settimanali. Analogamente, è possibile specificare "Mensile" per analizzare le tendenze mensili. Il valore predefinito è "Daily". Se si visualizzano dati in intervalli di tempo più grandi, è consigliabile usare "Settimanale" o "Mensile" per migliorare le prestazioni delle query e semplificare l'analisi delle tendenze. | N | "Settimanale" | String |
Campi restituiti
| Nome campo | Descrizione | Tipo di dati |
|---|---|---|
| UniqueId | Chiave primaria che indica l'ID univoco dell'istanza di backup | String |
| ID. | ID di Azure Resource Manager (ARM) dell'istanza di backup | String |
| FriendlyName | Nome descrittivo dell'istanza di backup | String |
| ProtectionInfo | Informazioni sulle impostazioni di protezione dell'istanza di backup. Ad esempio, la protezione è configurata, la protezione è stata arrestata, il backup iniziale in sospeso | String |
| LatestRecoveryPoint | Data e ora del punto di ripristino più recente associato all'istanza di backup. Attualmente, questo campo è supportato solo per i carichi di lavoro dell'insieme di credenziali di Servizi di ripristino | Data/Ora |
| OldestRecoveryPoint | Data e ora del punto di ripristino meno recente associato all'istanza di backup | Attualmente, questo campo è supportato solo per i carichi di lavoro dell'insieme di credenziali di Servizi di ripristino |
| SourceSizeInMBs | Dimensioni front-end dell'istanza di backup in MB | Double |
| VaultStore_Archiviazione ConsumptionInMBs | Totale spazio di archiviazione cloud usato dall'istanza di backup nel livello standard dell'insieme di credenziali | Double |
| DataSourceFriendlyName | Nome descrittivo dell'origine dati corrispondente all'istanza di backup | String |
| BackupSolution | Soluzione di backup a cui è associata l'istanza di backup. Ad esempio, Backup di macchine virtuali di Azure, SQL in Backup di macchine virtuali di Azure e così via. | String |
| DatasourceType | Tipo dell'origine dati corrispondente all'istanza di backup. Ad esempio " Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | ID di Azure Resource Manager (ARM) dell'origine dati sottostante corrispondente all'istanza di backup. Ad esempio, ID di Azure Resource Manager (ARM) della macchina virtuale | String |
| DatasourceSetFriendlyName | Nome descrittivo della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'origine dati SQL nella macchina virtuale di Azure, questo campo conterrà il nome della macchina virtuale in cui esiste il database SQL | String |
| DatasourceSetResourceId | ID di Azure Resource Manager (ARM) della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'istanza di SQL nell'origine dati della macchina virtuale di Azure, questo campo conterrà l'ID di Azure Resource Manager (ARM) della macchina virtuale in cui esiste il database SQL | String |
| DatasourceSetType | Tipo della risorsa padre dell'origine dati (ove applicabile). Ad esempio, per un'origine dati SAP HANA nella macchina virtuale di Azure, questo campo sarà Microsoft.Compute/virtualMachines perché la risorsa padre è una macchina virtuale di Azure | String |
| PolicyName | Nome dei criteri associati all'istanza di backup | String |
| PolicyUniqueId | Chiave esterna che fa riferimento ai criteri associati all'istanza di backup | String |
| PolicyId | ID di Azure Resource Manager (ARM) dei criteri associati all'istanza di backup | String |
| VaultResourceId | ID di Azure Resource Manager (ARM) dell'insieme di credenziali associato all'istanza di backup | String |
| VaultUniqueId | Chiave esterna che fa riferimento all'insieme di credenziali associato all'istanza di backup | String |
| VaultName | Nome dell'insieme di credenziali associato all'istanza di backup | String |
| VaultTags | Tag dell'insieme di credenziali associato all'istanza di backup | String |
| VaultSubscriptionId | ID sottoscrizione dell'insieme di credenziali associato all'istanza di backup | String |
| VaultLocation | Posizione dell'insieme di credenziali associato all'istanza di backup | String |
| VaultStore_Archiviazione ReplicationType | Archiviazione tipo di replica dell'insieme di credenziali associato all'istanza di backup | String |
| VaultType | Tipo dell'insieme di credenziali, ad esempio "Microsoft.RecoveryServices/vaults" o "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Timestamp del record | Data/Ora |
_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
| Nome del parametro | Descrizione | Obbligatorio? | Valore di esempio | Tipo di dati |
|---|---|---|---|---|
| RangeStart | Usare questo parametro insieme al parametro RangeEnd per recuperare tutti i record correlati al gruppo di fatturazione nel periodo di tempo da RangeStart a RangeEnd. | Y | "2021-03-03 00:00:00" | Data/Ora |
| RangeEnd | Usare questo parametro insieme al parametro RangeStart per recuperare tutti i record correlati al gruppo di fatturazione nel periodo di tempo da RangeStart a RangeEnd. | Y | "2021-03-10 00:00:00" | Data/Ora |
| VaultSubscriptionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di sottoscrizioni in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di ID sottoscrizione come parametro per questa funzione, è possibile recuperare solo i gruppi di fatturazione presenti nelle sottoscrizioni specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record in tutte le sottoscrizioni. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Usare questo parametro per filtrare l'output della funzione per un determinato set di aree in cui sono presenti i dati di backup. Se si specifica un elenco delimitato da virgole di aree come parametro per questa funzione, è possibile recuperare solo i gruppi di fatturazione che si trovano nelle aree specificate. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record nella funzione in tutte le aree. | N | eastus,westus |
String |
| VaultList | Usare questo parametro per filtrare l'output della funzione per un determinato set di insiemi di credenziali. Se si specifica un elenco delimitato da virgole di nomi di insieme di credenziali come parametro per questa funzione, è possibile recuperare i record delle istanze di backup relative solo agli insiemi di credenziali specificati. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca dei record dei gruppi di fatturazione in tutti gli insiemi di credenziali. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Usare questo parametro per filtrare l'output della funzione per i record relativi a un particolare tipo di insieme di credenziali. Per impostazione predefinita, il valore di questo parametro è '*', che esegue la ricerca della funzione sia per gli insiemi di credenziali di Servizi di ripristino che per gli insiemi di credenziali di Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Usare questo parametro per scegliere se eseguire query sui dati nella tabella di AzureDiagnostics legacy. Se il valore di questo parametro è false, la funzione esegue una query sui dati della tabella AzureDiagnostics e delle tabelle specifiche della risorsa. Se il valore di questo parametro è true, la funzione esegue una query sui dati solo dalle tabelle specifiche della risorsa. Il valore predefinito è true. | N | true | Booleano |
| BackupSolutionList | Usare questo parametro per filtrare l'output della funzione per un determinato set di soluzioni di backup usate nell'ambiente Azure. Ad esempio, se si specifica Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM come valore di questo parametro, la funzione restituisce solo i record correlati agli elementi di cui è stato eseguito il backup usando il backup di macchine virtuali di Azure, SQL nel backup di macchine virtuali di Azure o DPM in Backup di Azure. Per impostazione predefinita, il valore di questo parametro è '*', che rende la funzione restituisce record relativi a tutte le soluzioni di backup supportate dai report di backup (i valori supportati sono "Backup di macchine virtuali di Azure", "SQL in Backup delle macchine virtuali di Azure", "SAP HANA in Backup delle macchine virtuali di Azure", "Archiviazione di Azure (File di Azure) Backup", "Backup di Azure Agent", "DPM", " Backup di Azure Server", "Database di Azure per PostgreSQL Server Backup", "Backup BLOB di Azure", "Backup dischi di Azure" o una combinazione delimitata da virgole di uno di questi valori). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Usare questo parametro per cercare un determinato gruppo di fatturazione in base al nome. Per impostazione predefinita, il valore è "*", che esegue la ricerca della funzione per tutti i gruppi di fatturazione. | N | "testvm" | String |
| AggregationType | Usare questo parametro per specificare la granularità temporale in corrispondenza della quale recuperare i dati. Se il valore di questo parametro è "Daily", la funzione restituisce un record per ogni gruppo di fatturazione al giorno, consentendo di analizzare le tendenze giornaliere del consumo di archiviazione e delle dimensioni front-end. Se il valore di questo parametro è "Weekly", la funzione restituisce un record per ogni istanza di backup alla settimana, consentendo di analizzare le tendenze settimanali. Analogamente, è possibile specificare "Mensile" per analizzare le tendenze mensili. Il valore predefinito è "Daily". Se si visualizzano dati in intervalli di tempo più grandi, è consigliabile usare "Settimanale" o "Mensile" per migliorare le prestazioni delle query e semplificare l'analisi delle tendenze. | N | "Settimanale" | String |
Campi restituiti
| Nome campo | Descrizione | Tipo di dati |
|---|---|---|
| UniqueId | Chiave primaria che indica l'ID univoco del gruppo di fatturazione | String |
| FriendlyName | Nome descrittivo del gruppo di fatturazione | String |
| Nome | Nome del gruppo di fatturazione | String |
| Type | Tipo di gruppo di fatturazione. Ad esempio, ProtectedContainer o BackupItem | String |
| SourceSizeInMBs | Dimensioni front-end del gruppo di fatturazione in MB | Double |
| VaultStore_Archiviazione ConsumptionInMBs | Totale spazio di archiviazione cloud utilizzato dal gruppo di fatturazione nel livello standard dell'insieme di credenziali | Double |
| BackupSolution | Soluzione di backup a cui è associato il gruppo di fatturazione. Ad esempio, Backup di macchine virtuali di Azure, SQL in Backup di macchine virtuali di Azure e così via. | String |
| VaultResourceId | ID di Azure Resource Manager (ARM) dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultUniqueId | Chiave esterna che fa riferimento all'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultName | Nome dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultTags | Tag dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultSubscriptionId | ID sottoscrizione dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultLocation | Posizione dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultStore_Archiviazione ReplicationType | Archiviazione tipo di replica dell'insieme di credenziali associato al gruppo di fatturazione | String |
| VaultType | Tipo dell'insieme di credenziali, ad esempio "Microsoft.RecoveryServices/vaults" o "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Timestamp del record | Data/Ora |
| ExtendedProperties | Proprietà aggiuntive del gruppo di fatturazione | Dinamico |
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=DataTransferredInMBsTutti 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=DataTransferredInMBsTendenza 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