Systemfunktionen für Azure Monitor-Protokolle
In diesem Artikel erfahren Sie, wie Sie benutzerdefinierte Abfragen für Azure Monitor-Protokolle unter Verwendung von Systemfunktionen schreiben.
Azure Backup bietet eine Reihe von Funktionen, so genannte Systemfunktionen oder Lösungsfunktionen, die standardmäßig in den Arbeitsbereichen von Log Analytics (LA) verfügbar sind.
Diese Funktionen verarbeiten Daten in den Rohtabellen von Azure Backup in Log Analytics und geben formatierte Daten zurück, mit denen Sie mit einfachen Abfragen problemlos Informationen aus all Ihren auf die Sicherung bezogenen Entitäten abrufen können. Benutzer können Parameter an diese Funktionen übergeben, um die von diesen Funktionen zurückgegebenen Daten zu filtern.
Es empfiehlt sich, Systemfunktionen für die Abfrage Ihrer Sicherungsdaten in Log Analytics-Arbeitsbereichen für die Erstellung von benutzerdefinierten Berichten zu verwenden, da sie, wie im folgenden Abschnitt beschrieben, eine Reihe von Vorteilen bieten.
Vorteile der Verwendung von Systemfunktionen
Einfachere Abfragen: Mithilfe von Funktionen können Sie die Anzahl der benötigten Joins in Ihren Abfragen reduzieren. Standardmäßig geben die Funktionen vereinfachte Schemas zurück, die alle Informationen zu der abgefragten Entität (Sicherungsinstanz, Auftrag, Tresor usw.) enthalten. Wenn Sie beispielsweise eine Liste erfolgreicher Sicherungsaufträge nach Sicherungselementname und zugehörigem Container benötigen, erhalten Sie durch einen einfachen Aufruf der Funktion _AzureBackup_getJobs() alle diese Informationen für jeden Auftrag. Bei einer direkten Abfrage der Rohtabellen müssten Sie hingegen mehrere Joins zwischen den Tabellen AddonAzureBackupJobs und CoreAzureBackup durchführen.
Reibungsloserer Übergang vom Diagnoseereignis einer Vorgängerversion: Die Verwendung von Systemfunktionen hilft Ihnen bei einem reibungslosen Übergang vom Diagnoseereignis einer Vorgängerversion („AzureBackupReport“ im AzureDiagnostics-Modus) zu den ressourcenspezifischen Ereignissen. Bei allen von Azure Backup bereitgestellten Systemfunktionen können Sie einen Parameter angeben, mit dem Sie wählen können, ob die Funktion nur Daten aus den ressourcenspezifischen Tabellen abfragen soll oder Daten sowohl aus der Tabelle der Vorgängerversion als auch aus den ressourcenspezifischen Tabellen abfragen soll (mit Deduplizierung der Datensätze).
- Wenn Sie erfolgreich zu den ressourcenspezifischen Tabellen migriert haben, können Sie wählen, ob die Tabelle der Vorgängerversion von der Abfrage durch die Funktion ausgeschlossen werden soll.
- Wenn Sie gerade eine Migration durchführen und sich einige Daten, die Sie für die Analyse benötigen, in der Tabelle der Vorgängerversion befinden, können Sie die Tabelle der Vorgängerversion einbeziehen. Wenn der Übergang abgeschlossen ist und Sie die Daten aus der Tabelle der Vorgängerversion nicht mehr benötigen, können Sie den Wert des an die Funktion übergebenen Parameters in Ihren Abfragen aktualisieren, um die Tabelle der Vorgängerversion auszuschließen.
- Wenn Sie weiterhin nur die Tabelle der Vorgängerversion verwenden, funktionieren die Funktionen trotzdem, auch wenn Sie die Tabelle der Vorgängerversion über den gleichen Parameter einbeziehen. Es wird jedoch empfohlen, frühestmöglich auf die ressourcenspezifischen Tabellen umzusteigen.
Reduzieren die Möglichkeit, dass benutzerdefinierte Abfragen abbrechen: Wenn Azure Backup Verbesserungen am Schema der zugrunde liegenden LA-Tabellen einführt, um zukünftige Berichtsszenarien zu ermöglichen, wird die Definition der Funktionen ebenfalls aktualisiert, um die Schemaänderungen zu berücksichtigen. Wenn Sie also Systemfunktionen zum Erstellen von benutzerdefinierten Abfragen verwenden, funktionieren Ihre Abfragen weiterhin, selbst wenn sich das zugrunde liegenden Schema der Tabellen ändert.
Hinweis
Die Systemfunktionen werden von Microsoft verwaltet, und ihre Definitionen können von den Benutzern nicht bearbeitet werden. Wenn Sie bearbeitbare Funktionen benötigen, können Sie gespeicherte Funktionen in LA erstellen.
Von Azure Backup bereitgestellte Systemfunktionstypen
Kernfunktionen: Dies sind Funktionen, mit denen Sie alle wichtigen Azure Backup-Entitäten abfragen können, z. B. Sicherungsinstanzen, Tresore, Richtlinien, Aufträge und Abrechnungsentitäten. Die Funktion _AzureBackup_getBackupInstances gibt z. B. eine Liste aller in Ihrer Umgebung vorhanden Sicherungsinstanzen zum letzten Abschlusstag (in UTC) zurück. Die Parameter und das zurückgegebene Schema für jede dieser Kernfunktionen werden im Folgenden in diesem Artikel zusammengefasst.
Trendfunktionen: Dies sind Funktionen, die Verlaufsdatensätze für Ihre sicherungsbezogenen Entitäten (z. B. Sicherungsinstanzen, Abrechnungsgruppen) zurückgeben und es Ihnen ermöglichen, tägliche, wöchentliche und monatliche Trendinformationen zu wichtigen Metriken (z. B. Anzahl, verbrauchter Speicherplatz) in Bezug auf diese Entitäten abzurufen. Die Parameter und das zurückgegebene Schema für jede dieser Trendfunktionen werden im Folgenden in diesem Artikel zusammengefasst.
Hinweis
Derzeit geben die Systemfunktionen Daten bis zum letzten Abschlusstag (in UTC) zurück. Daten für den aktuellen Teiltag werden nicht zurückgegeben. Wenn Sie also Datensätze für den aktuellen Tag abrufen möchten, müssen Sie die LA-Rohtabellen verwenden.
Liste der Systemfunktionen
Kernfunktionen
_AzureBackup_GetVaults()
Diese Funktion gibt die Liste aller Recovery Services-Tresore in ihrer Azure-Umgebung zurück, die dem LA-Arbeitsbereich zugeordnet sind.
Parameter
| Parametername | Beschreibung | Erforderlich? | Beispielwert | Datentyp |
|---|---|---|---|---|
| RangeStart | Verwenden Sie diesen Parameter zusammen mit dem RangeEnd-Parameter nur, wenn Sie alle tresorbezogenen Datensätze im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jeden Tresor abruft. | N | „2021-03-03 00:00:00“ | Datetime |
| RangeEnd | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter nur, wenn Sie alle tresorbezogenen Datensätze im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jeden Tresor abruft. | N | „2021-03-10 00:00:00“ | Datetime |
| VaultSubscriptionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Abonnements zu filtern, für die Sicherungsdaten vorhanden sind. Durch Angabe einer kommagetrennten Liste von Abonnement-IDs als Parameter für diese Funktion können Sie nur die Tresore abrufen, die sich in den angegebenen Abonnements befinden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Abonnements sucht. | N | „00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111“ | String |
| VaultLocationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Regionen zu filtern, für die Sicherungsdaten vorhanden sind. Durch Angabe einer kommagetrennten Liste von Regionen als Parameter für diese Funktion können Sie nur die Tresore abrufen, die sich in den angegebenen Regionen befinden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Regionen sucht. | N | eastus,westus |
String |
| VaultList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Tresoren zu filtern. Durch Angabe einer kommagetrennten Liste von Tresornamen als Parameter für diese Funktion können Sie Datensätze abrufen, die nur zu den angegebenen Tresoren gehören. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Tresoren sucht. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf Datensätze eines bestimmten Tresortyps zu filtern. Standardmäßig ist der Wert dieses Parameters „*“, wodurch die Funktion sowohl nach Recovery Services-Tresoren als auch nach Sicherungstresoren sucht. | N | „Microsoft.RecoveryServices/vaults“ | String |
| ExcludeLegacyEvent | Verwenden Sie diesen Parameter, um auszuwählen, ob Daten in der AzureDiagnostics-Tabelle der Vorgängerversion abgefragt werden sollen oder nicht. Wenn der Wert dieses Parameters „false“ lautet, fragt die Funktion Daten aus der AzureDiagnostics-Tabelle und den ressourcenspezifischen Tabellen ab. Wenn der Wert dieses Parameters „true“ lautet, fragt die Funktion nur Daten aus den ressourcenspezifischen Tabellen ab. Der Standardwert ist true. | N | true | Boolean |
Zurückgegebene Felder
| Feldname | Beschreibung | Datentyp |
|---|---|---|
| UniqueId | Primärschlüssel, der die eindeutige ID des Tresors bezeichnet | String |
| Id | Azure Resource Manager-ID (ARM) des Tresors | Zeichenfolge |
| Name | Name des Tresors | String |
| SubscriptionId | ID des Abonnements, in dem sich der Tresor befindet | String |
| Location | Speicherort, an dem sich der Tresor befindet | String |
| VaultStore_StorageReplicationType | Speicherreplikationstyp, der dem Tresor zugeordnet ist | String |
| Tags | Tags des Tresors | String |
| TimeGenerated | Zeitstempel des Datensatzes | Datetime |
| Type | Typ des Tresors, z. B. „Microsoft.RecoveryServices/vaults“ oder „Microsoft.DataProtection/backupVaults“ | String |
_AzureBackup_GetPolicies()
Diese Funktion gibt die Liste der Sicherungsrichtlinien zurück, die in ihrer Azure-Umgebung verwendet werden, sowie ausführliche Informationen zu den einzelnen Richtlinien, wie z. B. Datenquellentyp, Speicherreplikationstyp usw.
Parameter
| Parametername | Beschreibung | Erforderlich? | Beispielwert | Datentyp |
|---|---|---|---|---|
| RangeStart | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter nur, wenn Sie alle richtlinienbezogenen Datensätze im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jede Richtlinie abruft. | N | „2021-03-03 00:00:00“ | Datetime |
| RangeEnd | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter nur, wenn Sie alle richtlinienbezogenen Datensätze im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jede Richtlinie abruft. | N | „2021-03-10 00:00:00“ | Datetime |
| VaultSubscriptionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Abonnements zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Abonnement-IDs als Parameter für diese Funktion können Sie nur die Richtlinien abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Abonnements sucht. | N | „00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111“ | String |
| VaultLocationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Regionen zu filtern, für die Sicherungsdaten vorhanden sind. Durch Angabe einer kommagetrennten Liste von Regionen als Parameter für diese Funktion können Sie nur die Richtlinien abrufen, die sich in den angegebenen Regionen befinden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Regionen sucht. | N | eastus,westus |
String |
| VaultList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Tresoren zu filtern. Durch Angabe einer kommagetrennten Liste von Tresornamen als Parameter für diese Funktion können Sie Datensätze von Richtlinien abrufen, die nur zu den angegebenen Tresoren gehören. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen von Richtlinien in allen Tresoren sucht. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf Datensätze eines bestimmten Tresortyps zu filtern. Standardmäßig ist der Wert dieses Parameters „*“, wodurch die Funktion sowohl nach Recovery Services-Tresoren als auch nach Sicherungstresoren sucht. | N | „Microsoft.RecoveryServices/vaults“ | String |
| ExcludeLegacyEvent | Verwenden Sie diesen Parameter, um auszuwählen, ob Daten in der AzureDiagnostics-Tabelle der Vorgängerversion abgefragt werden sollen oder nicht. Wenn der Wert dieses Parameters „false“ lautet, fragt die Funktion Daten aus der AzureDiagnostics-Tabelle und den ressourcenspezifischen Tabellen ab. Wenn der Wert dieses Parameters „true“ lautet, fragt die Funktion nur Daten aus den ressourcenspezifischen Tabellen ab. Der Standardwert ist true. | N | true | Boolean |
| BackupSolutionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Sicherungslösungen zu filtern, die in ihrer Azure-Umgebung verwendet werden. Wenn Sie zum Beispiel Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM als Wert dieses Parameters angeben, gibt die Funktion nur Datensätze zurück, die sich auf Elemente beziehen, die mit Sicherung von Azure-VMs, SQL in Azure-VM-Sicherung oder DPM nach Azure Backup gesichert wurden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion Datensätze zurückgibt, die zu allen von Sicherungsberichten unterstützten Sicherungslösungen gehören (unterstützte Werte sind „Sicherung von Azure-VMs“, „SQL in Azure-VM-Sicherung“, „SAP HANA in Azure-VM-Sicherung“, „Azure Storage (Azure Files)-Sicherung“, „Azure Backup-Agent“, „DPM“, „Azure Backup Server“, „Azure Database for PostgreSQL Server-Sicherung“, „Azure Blob-Sicherung“, „Azure Disk-Sicherung“ oder eine durch Komma getrennte Kombination dieser Werte). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
Zurückgegebene Felder
| Feldname | Beschreibung | **Datentyp ** |
|---|---|---|
| UniqueId | Primärschlüssel, der die eindeutige ID der Richtlinie bezeichnet | String |
| Id | Azure Resource Manager-ID (ARM) der Richtlinie | Zeichenfolge |
| Name | Name der Richtlinie | String |
| TimeZone | Zeitzone, in der die Richtlinie definiert ist | String |
| Sicherungslösung | Sicherungslösung, der die Richtlinie zugeordnet ist. Beispielsweise „Azure-VM-Sicherung, SQL“ in „Azure-VM-Sicherung“ usw. | String |
| TimeGenerated | Zeitstempel des Datensatzes | Datetime |
| VaultUniqueId | Fremdschlüssel, der auf den der Richtlinie zugeordneten Tresor verweist | String |
| VaultResourceId | Azure Resource Manager-ID (ARM) des der Richtlinie zugeordneten Tresors | String |
| VaultName | Name des der Richtlinie zugeordneten Tresors | String |
| VaultTags | Tags des der Richtlinie zugeordneten Tresors | String |
| VaultLocation | Speicherort des der Richtlinie zugeordneten Tresors | String |
| VaultSubscriptionId | Abonnement-ID des der Richtlinie zugeordneten Tresors | String |
| VaultStore_StorageReplicationType | Speicherreplikationstyp des Tresors, der der Richtlinie zugeordnet ist | String |
| VaultType | Typ des Tresors, z. B. „Microsoft.RecoveryServices/vaults“ oder „Microsoft.DataProtection/backupVaults“ | String |
| ExtendedProperties | Zusätzliche Eigenschaften der Richtlinie | Dynamisch |
_AzureBackup_GetJobs()
Diese Funktion gibt eine Liste aller Aufträge im Zusammenhang mit Sicherungen und Wiederherstellungen zurück, die in einem bestimmten Zeitraum ausgelöst wurden, zusammen mit ausführlichen Informationen zu jedem Auftrag, z. B. Auftragsstatus, Auftragsdauer, übertragene Daten usw.
Parameter
| Parametername | Beschreibung | Erforderlich? | Beispielwert | **Datentyp ** |
|---|---|---|---|---|
| RangeStart | Verwenden Sie diesen Parameter zusammen mit dem RangeEnd-Parameter, um die Liste aller Aufträge abzurufen, die im Zeitraum von „RangeStart“ bis „RangeEnd“ gestartet wurden. | J | „2021-03-03 00:00:00“ | Datetime |
| RangeEnd | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter, um die Liste aller Aufträge abzurufen, die im Zeitraum von „RangeStart“ bis „RangeEnd“ gestartet wurden. | J | „2021-03-10 00:00:00“ | Datetime |
| VaultSubscriptionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Abonnements zu filtern, für die Sicherungsdaten vorhanden sind. Durch Angabe einer kommagetrennten Liste von Abonnement-IDs als Parameter für diese Funktion können Sie nur die Aufträge abrufen, die Tresoren in den angegebenen Abonnements zugeordnet sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Abonnements sucht. | N | „00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111“ | String |
| VaultLocationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Regionen zu filtern, für die Sicherungsdaten vorhanden sind. Durch Angabe einer kommagetrennten Liste von Regionen als Parameter für diese Funktion können Sie nur die Aufträge abrufen, die Tresoren in den angegebenen Abonnements zugeordnet sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Regionen sucht. | N | eastus,westus |
String |
| VaultList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Tresoren zu filtern. Durch Angabe einer kommagetrennten Liste von Tresornamen als Parameter für diese Funktion können Sie Aufträge abrufen, die nur zu den angegebenen Tresoren gehören. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Aufträgen in allen Tresoren sucht. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf Datensätze eines bestimmten Tresortyps zu filtern. Standardmäßig ist der Wert dieses Parameters „*“, wodurch die Funktion sowohl nach Recovery Services-Tresoren als auch nach Sicherungstresoren sucht. | N | „Microsoft.RecoveryServices/vaults“ | String |
| ExcludeLegacyEvent | Verwenden Sie diesen Parameter, um auszuwählen, ob Daten in der AzureDiagnostics-Tabelle der Vorgängerversion abgefragt werden sollen oder nicht. Wenn der Wert dieses Parameters „false“ lautet, fragt die Funktion Daten aus der AzureDiagnostics-Tabelle und den ressourcenspezifischen Tabellen ab. Wenn der Wert dieses Parameters „true“ lautet, fragt die Funktion nur Daten aus den ressourcenspezifischen Tabellen ab. Der Standardwert ist true. | N | true | Boolean |
| BackupSolutionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Sicherungslösungen zu filtern, die in ihrer Azure-Umgebung verwendet werden. Wenn Sie zum Beispiel Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM als Wert dieses Parameters angeben, gibt die Funktion nur Datensätze zurück, die sich auf Elemente beziehen, die mit Sicherung von Azure-VMs, SQL in Azure-VM-Sicherung oder DPM nach Azure Backup gesichert wurden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion Datensätze zurückgibt, die zu allen von Sicherungsberichten unterstützten Sicherungslösungen gehören (unterstützte Werte sind „Sicherung von Azure-VMs“, „SQL in Azure-VM-Sicherung“, „SAP HANA in Azure-VM-Sicherung“, „Azure Storage (Azure Files)-Sicherung“, „Azure Backup-Agent“, „DPM“, „Azure Backup Server“, „Azure Database for PostgreSQL Server-Sicherung“, „Azure Blob-Sicherung“, „Azure Disk-Sicherung“ oder eine durch Komma getrennte Kombination dieser Werte). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| JobOperationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Auftragstyp zu filtern. Beispiele wären etwa die Sicherungs- oder Wiederherstellungsvorgänge. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Sicherungs- und Wiederherstellungsaufträgen sucht. | N | „Backup“ | String |
| JobStatusList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Auftragsstatus zu filtern. Beispiel: „Completed“ (Abgeschlossen), „Failed“ (Fehler) usw. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach allen Aufträgen sucht, unabhängig von ihrem Status. | N | Failed,CompletedWithWarnings |
String |
| JobFailureCodeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Fehlercode zu filtern. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach allen Aufträgen sucht, unabhängig von ihrem Fehlercode. | N | „Success“ | String |
| DatasourceSetName | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf eine bestimmte übergeordnete Ressource zu filtern. Um zum Beispiel SQL in Azure VM-Sicherungsinstanzen zurückzugeben, die zum virtuellen Computer „testvm“ gehören, geben Sie testvm als Wert dieses Parameters an. Standardmäßig lautet der Wert „*“, wodurch die Funktion nach Datensätzen in allen Sicherungsinstanzen sucht. | N | „testvm“ | String |
| BackupInstanceName | Verwenden Sie diesen Parameter, um anhand des Namens nach Aufträgen in einer bestimmten Sicherungsinstanz zu suchen. Standardmäßig lautet der Wert „*“, wodurch die Funktion nach Datensätzen in allen Sicherungsinstanzen sucht. | N | „testvm“ | String |
| ExcludeLog | Verwenden Sie diesen Parameter, um Protokollaufträge von der Rückgabe durch die Funktion auszuschließen (verbessert die Abfrageleistung). Standardmäßig lautet der Wert dieses Parameters „true“, wodurch die Funktion Protokollaufträge ausschließt. | N | true | Boolean |
Zurückgegebene Felder
| Feldname | Beschreibung | **Datentyp ** |
|---|---|---|
| UniqueId | Primärschlüssel, der die eindeutige ID des Auftrags bezeichnet | String |
| OperationCategory | Kategorie des ausgeführten Vorgangs. Beispiel: „Backup“, „Restore“ | String |
| Vorgang | Details des ausgeführten Vorgangs. Beispiel: „Log“ (für Protokollsicherung) | String |
| Status | Status des Auftrags. Beispiel: „Completed“, „Failed“, „CompletedWithWarnings“ | String |
| ErrorTitle | Fehlercode des Auftrags | String |
| StartTime | Datum und Uhrzeit, zu dem der Auftrag gestartet wurde | Datetime |
| DurationInSecs | Dauer des Auftrags in Sekunden | Double |
| DataTransferredInMBs | Vom Auftrag übertragene Daten in MB. Derzeit wird dieses Feld nur für Recovery Services-Tresorworkloads unterstützt. | Double |
| RestoreJobRPDateTime | Datum und Uhrzeit der Erstellung des Wiederherstellungspunkts, der wiederhergestellt wird. Derzeit wird dieses Feld nur für Recovery Services-Tresorworkloads unterstützt. | Datetime |
| RestoreJobRPLocation | Speicherort des Wiederherstellungspunkts, der wiederhergestellt wird | String |
| BackupInstanceUniqueId | Fremdschlüssel, der auf die dem Auftrag zugeordnete Sicherungsinstanz verweist | String |
| BackupInstanceId | Azure Resource Manager-ID (ARM) der dem Auftrag zugeordneten Sicherungsinstanz | String |
| BackupInstanceFriendlyName | Name der dem Auftrag zugeordnete Sicherungsinstanz | String |
| DatasourceResourceId | Azure Resource Manager-ID (ARM) der dem Auftrag zugeordneten zugrunde liegenden Datenquelle. Beispiel: Azure Resource Manager-ID (ARM) der VM | String |
| DatasourceFriendlyName | Anzeigename der Datenquelle, die dem Auftrag zugeordnet ist | String |
| DatasourceType | Typ der Datenquelle, die dem Auftrag zugeordnet ist. Beispiel: „Microsoft.Compute/virtualMachines“ | String |
| BackupSolution | Sicherungslösung, der dem Auftrag zugeordnet ist. Beispielsweise „Azure-VM-Sicherung, SQL“ in „Azure-VM-Sicherung“ usw. | String |
| DatasourceSetResourceId | Azure Resource Manager-ID (ARM) der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SQL in Azure-VM-Datenquelle enthält dieses Feld beispielsweise die Azure Resource Manager-ID (ARM) der VM, in der sich die SQL-Datenbank befindet | String |
| DatasourceSetType | Typ der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SAP HANA in Azure VM-Datenquelle lautet dieses Feld beispielsweise „Microsoft.Compute/virtualMachines“, da die übergeordnete Ressource eine Azure-VM ist | String |
| VaultResourceId | Azure Resource Manager-ID (ARM) des dem Auftrag zugeordneten Tresors | String |
| VaultUniqueId | Fremdschlüssel, der auf den dem Auftrag zugeordneten Tresor verweist | String |
| VaultName | Name des dem Auftrag zugeordneten Tresors | String |
| VaultTags | Tag des dem Auftrag zugeordneten Tresors | String |
| VaultSubscriptionId | Abonnement-ID des dem Auftrag zugeordneten Tresors | String |
| VaultLocation | Speicherort des dem Auftrag zugeordneten Tresors | String |
| VaultStore_StorageReplicationType | Speicherreplikationstyp des Tresors, der dem Auftrag zugeordnet ist | String |
| VaultType | Typ des Tresors, z. B. „Microsoft.RecoveryServices/vaults“ oder „Microsoft.DataProtection/backupVaults“ | String |
| TimeGenerated | Zeitstempel des Datensatzes | Datetime |
_AzureBackup_GetBackupInstances()
Diese Funktion gibt die Liste der Sicherungsinstanzen zurück, die ihren Recovery Services-Tresoren zugeordnet sind, zusammen mit ausführlichen Informationen zu jeder Sicherungsinstanz, z. B. Cloudspeicherverbrauch, zugehörige Richtlinie usw.
Parameter
| Parametername | Beschreibung | Erforderlich? | Beispielwert | **Datentyp ** |
|---|---|---|---|---|
| RangeStart | Verwenden Sie diesen Parameter zusammen mit dem RangeEnd-Parameter nur, wenn Sie alle Datensätze im Zusammenhang mit Sicherungsinstanzen im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jede Sicherungsinstanz abruft. | N | „2021-03-03 00:00:00“ | DataTime |
| RangeEnd | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter nur, wenn Sie alle Datensätze im Zusammenhang mit Sicherungsinstanzen im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jede Sicherungsinstanz abruft. | N | „2021-03-10 00:00:00“ | Datetime |
| VaultSubscriptionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Abonnements zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Abonnement-IDs als Parameter für diese Funktion können Sie nur die Sicherungsinstanzen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Abonnements sucht. | N | „00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111“ | String |
| VaultLocationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Regionen zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Regionen als Parameter für diese Funktion können Sie nur die Sicherungsinstanzen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Regionen sucht. | N | eastus,westus |
String |
| VaultList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Tresoren zu filtern. Durch Angabe einer kommagetrennten Liste von Tresornamen als Parameter für diese Funktion können Sie Datensätze von Sicherungsinstanzen abrufen, die nur zu den angegebenen Tresoren gehören. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen von Sicherungsinstanzen in allen Tresoren sucht. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf Datensätze eines bestimmten Tresortyps zu filtern. Standardmäßig ist der Wert dieses Parameters „*“, wodurch die Funktion sowohl nach Recovery Services-Tresoren als auch nach Sicherungstresoren sucht. | N | „Microsoft.RecoveryServices/vaults“ | String |
| ExcludeLegacyEvent | Verwenden Sie diesen Parameter, um auszuwählen, ob Daten in der AzureDiagnostics-Tabelle der Vorgängerversion abgefragt werden sollen oder nicht. Wenn der Wert dieses Parameters „false“ lautet, fragt die Funktion Daten aus der AzureDiagnostics-Tabelle und den ressourcenspezifischen Tabellen ab. Wenn der Wert dieses Parameters „true“ lautet, fragt die Funktion nur Daten aus den ressourcenspezifischen Tabellen ab. Der Standardwert ist true. | N | true | Boolean |
| BackupSolutionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Sicherungslösungen zu filtern, die in ihrer Azure-Umgebung verwendet werden. Wenn Sie zum Beispiel Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM als Wert dieses Parameters angeben, gibt die Funktion nur Datensätze zurück, die sich auf Elemente beziehen, die mit Sicherung von Azure-VMs, SQL in Azure-VM-Sicherung oder DPM nach Azure Backup gesichert wurden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion Datensätze zurückgibt, die zu allen von Sicherungsberichten unterstützten Sicherungslösungen gehören (unterstützte Werte sind „Sicherung von Azure-VMs“, „SQL in Azure-VM-Sicherung“, „SAP HANA in Azure-VM-Sicherung“, „Azure Storage (Azure Files)-Sicherung“, „Azure Backup-Agent“, „DPM“, „Azure Backup Server“, „Azure Database for PostgreSQL Server-Sicherung“, „Azure Blob-Sicherung“, „Azure Disk-Sicherung“ oder eine durch Komma getrennte Kombination dieser Werte). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Verwenden Sie diesen Parameter, um auszuwählen, ob nur die aktiv geschützten Sicherungsinstanzen berücksichtigt werden sollen, oder ob auch die Instanzen eingeschlossen werden sollen, für die der Schutz beendet wurde, und die Instanzen, für die die anfängliche Sicherung aussteht. Für Recovery Services-Tresorworkloads sind unterstützte Werte „Protected“, „ProtectionStopped“, „InitialBackupPending“ oder eine kommagetrennte Kombination dieser Werte. Für Sicherungstresor-Workloads werden „Protected“, „ConfiguringProtection“, „ConfiguringProtectionFailed“, „UpdatingProtection“, „ProtectionError“, „ProtectionStopped“ oder eine durch Kommas getrennte Kombination dieser Werte unterstützt. Standardmäßig lautet der Wert „*“, wodurch die Funktion nach allen Sicherungsinstanzen sucht, unabhängig von den Schutzdetails. | N | „Protected“ | String |
| DatasourceSetName | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf eine bestimmte übergeordnete Ressource zu filtern. Um zum Beispiel SQL in Azure VM-Sicherungsinstanzen zurückzugeben, die zum virtuellen Computer „testvm“ gehören, geben Sie testvm als Wert dieses Parameters an. Standardmäßig lautet der Wert „*“, wodurch die Funktion nach Datensätzen in allen Sicherungsinstanzen sucht. | N | „testvm“ | String |
| BackupInstanceName | Verwenden Sie diesen Parameter, um anhand des Namens nach einer bestimmten Sicherungsinstanz zu suchen. Standardmäßig lautet der Wert „*“, sodass die Funktion nach allen Sicherungsinstanzen sucht. | N | „testvm“ | String |
| DisplayAllFields | Verwenden Sie diesen Parameter, um auszuwählen, ob nur eine Teilmenge der von der Funktion zurückgegebenen Felder abgerufen werden soll. Wenn der Wert dieses Parameters „false“ lautet, entfernt die Funktion Informationen, die sich auf Speicher und Aufbewahrungspunkt beziehen, aus der Ausgabe der Funktion. Dies ist nützlich, wenn Sie diese Funktion als Zwischenschritt in einer größeren Abfrage verwenden und die Leistung der Abfrage optimieren müssen, indem Sie Spalten eliminieren, die Sie für die Analyse nicht benötigen. Standardmäßig lautet der Wert dieses Parameters „true“, wodurch die Funktion alle Felder zurückgibt, die sich auf die Sicherungsinstanz beziehen. | N | true | Boolean |
Zurückgegebene Felder
| Feldname | Beschreibung | Datentyp |
|---|---|---|
| UniqueId | Primärschlüssel, der die eindeutige ID der Sicherungsinstanz bezeichnet | String |
| Id | Azure Resource Manager-ID (ARM) der Sicherungsinstanz | String |
| FriendlyName | Anzeigename der Sicherungsinstanz | String |
| ProtectionInfo | Informationen zu den Schutzeinstellungen der Sicherungsinstanz. Zum Beispiel, „Schutz konfiguriert“, „Schutz beendet“, „Erste Sicherung ausstehend“ | String |
| LatestRecoveryPoint | Datum und Uhrzeit des letzten der Sicherungsinstanz zugeordneten Wiederherstellungspunkts. Derzeit wird dieses Feld nur für Recovery Services-Tresorworkloads unterstützt. | Datetime |
| OldestRecoveryPoint | Datum und Uhrzeit des ältesten der Sicherungsinstanz zugeordneten Wiederherstellungspunkts Derzeit wird dieses Feld nur für Recovery Services-Tresorworkloads unterstützt. | Datetime |
| SourceSizeInMBs | Front-End-Größe der Sicherungsinstanz in MB | Double |
| VaultStore_StorageConsumptionInMBs | Gesamter, von der Sicherungsinstanz in der Vault-Standard-Ebene belegter Cloudspeicher | Double |
| DataSourceFriendlyName | Anzeigename der Datenquelle, die der Sicherungsinstanz entspricht | String |
| BackupSolution | Sicherungslösung, der die Sicherungsinstanz zugeordnet ist. Beispielsweise „Azure-VM-Sicherung, SQL“ in „Azure-VM-Sicherung“ usw. | String |
| DatasourceType | Typ der Datenquelle, die der Sicherungsinstanz entspricht. Beispiel: „Microsoft.Compute/virtualMachines“ | String |
| DatasourceResourceId | Azure Resource Manager-ID (ARM) der zugrunde liegenden Datenquelle, die der Sicherungsinstanz entspricht. Beispiel: Azure Resource Manager-ID (ARM) der VM | String |
| DatasourceSetFriendlyName | Anzeigename der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SQL in Azure-VM-Datenquelle enthält dieses Feld beispielsweise der Name der VM, in der sich die SQL-Datenbank befindet | String |
| DatasourceSetFriendlyName | Anzeigename der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SQL in Azure-VM-Datenquelle enthält dieses Feld beispielsweise der Name der VM, in der sich die SQL-Datenbank befindet | String |
| DatasourceSetResourceId | Azure Resource Manager-ID (ARM) der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SQL in Azure-VM-Datenquelle enthält dieses Feld beispielsweise die Azure Resource Manager-ID (ARM) der VM, in der sich die SQL-Datenbank befindet | String |
| DatasourceSetType | Typ der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SAP HANA in Azure VM-Datenquelle lautet dieses Feld beispielsweise „Microsoft.Compute/virtualMachines“, da die übergeordnete Ressource eine Azure-VM ist | String |
| PolicyName | Name der der Sicherungsinstanz zugeordneten Richtlinie | String |
| PolicyUniqueId | Fremdschlüssel, der auf die der Sicherungsinstanz zugeordnete Richtlinie verweist | String |
| PolicyId | Azure Resource Manager-ID (ARM) der der Sicherungsinstanz zugeordneten Richtlinie | String |
| VaultResourceId | Azure Resource Manager-ID (ARM) des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultUniqueId | Fremdschlüssel, der auf den der Sicherungsinstanz zugeordneten Tresor verweist | String |
| VaultName | Name des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultTags | Tag des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultSubscriptionId | Abonnement-ID des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultLocation | Speicherort des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultStore_StorageReplicationType | Speicherreplikationstyp des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultType | Typ des Tresors, d. h. „Microsoft.RecoveryServices/vaults“ oder „Microsoft.DataProtection/backupVaults“ | String |
| TimeGenerated | Zeitstempel des Datensatzes | Datetime |
_AzureBackup_GetBillingGroups()
Diese Funktion gibt eine Liste aller sicherungsbezogenen Abrechnungsentitäten (Abrechnungsgruppen) zusammen mit Informationen zu wichtigen Abrechnungskomponenten wie der Front-End-Größe und dem gesamten Cloudspeicher zurück.
Parameter
| Parametername | Beschreibung | Erforderlich? | Beispielwert | Datumstyp |
|---|---|---|---|---|
| RangeStart | Verwenden Sie diesen Parameter zusammen mit dem RangeEnd-Parameter nur, wenn Sie alle Datensätze im Zusammenhang mit Abrechnungsgruppen im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jede Abrechnungsgruppe abruft. | N | „2021-03-03 00:00:00“ | Datetime |
| RangeEnd | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter nur, wenn Sie alle Datensätze im Zusammenhang mit Abrechnungsgruppen im Zeitraum von „RangeStart“ bis „RangeEnd“ abrufen müssen. Standardmäßig weisen „RangeStart“ und „RangeEnd“ den Wert „Null“ auf, wodurch die Funktion nur den letzten Datensatz für jede Abrechnungsgruppe abruft. | N | „2021-03-10 00:00:00“ | Datetime |
| VaultSubscriptionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Abonnements zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Abonnement-IDs als Parameter für diese Funktion können Sie nur die Abrechnungsgruppen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Abonnements sucht. | N | „00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111“ | String |
| VaultLocationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Regionen zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Regionen als Parameter für diese Funktion können Sie nur die Abrechnungsgruppen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Regionen sucht. | N | eastus,westus |
String |
| VaultList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Tresoren zu filtern. Durch Angabe einer kommagetrennten Liste von Tresornamen als Parameter für diese Funktion können Sie Datensätze von Sicherungsinstanzen abrufen, die nur zu den angegebenen Tresoren gehören. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen von Abrechnungsgruppen in allen Tresoren sucht. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf Datensätze eines bestimmten Tresortyps zu filtern. Standardmäßig ist der Wert dieses Parameters „*“, wodurch die Funktion sowohl nach Recovery Services-Tresoren als auch nach Sicherungstresoren sucht. | N | „Microsoft.RecoveryServices/vaults“ | String |
| ExcludeLegacyEvent | Verwenden Sie diesen Parameter, um auszuwählen, ob Daten in der AzureDiagnostics-Tabelle der Vorgängerversion abgefragt werden sollen oder nicht. Wenn der Wert dieses Parameters „false“ lautet, fragt die Funktion Daten aus der AzureDiagnostics-Tabelle und den ressourcenspezifischen Tabellen ab. Wenn der Wert dieses Parameters „true“ lautet, fragt die Funktion nur Daten aus den ressourcenspezifischen Tabellen ab. Der Standardwert ist true. | N | true | Boolean |
| BackupSolutionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Sicherungslösungen zu filtern, die in ihrer Azure-Umgebung verwendet werden. Wenn Sie zum Beispiel Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM als Wert dieses Parameters angeben, gibt die Funktion nur Datensätze zurück, die sich auf Elemente beziehen, die mit Sicherung von Azure-VMs, SQL in Azure-VM-Sicherung oder DPM nach Azure Backup gesichert wurden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion Datensätze zurückgibt, die zu allen von Sicherungsberichten unterstützten Sicherungslösungen gehören (unterstützte Werte sind „Sicherung von Azure-VMs“, „SQL in Azure-VM-Sicherung“, „SAP HANA in Azure-VM-Sicherung“, „Azure Storage (Azure Files)-Sicherung“, „Azure Backup-Agent“, „DPM“, „Azure Backup Server“, „Azure Database for PostgreSQL Server-Sicherung“, „Azure Blob-Sicherung“, „Azure Disk-Sicherung“ oder eine durch Komma getrennte Kombination dieser Werte). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Verwenden Sie diesen Parameter, um nach einer bestimmten Abrechnungsgruppe anhand ihres Namens zu suchen. Standardmäßig lautet der Wert „*“, sodass die Funktion nach allen Abrechnungsgruppen sucht. | N | „testvm“ | String |
Zurückgegebene Felder
| Feldname | Beschreibung | Datentyp |
|---|---|---|
| UniqueId | Primärschlüssel, der die eindeutige ID der Abrechnungsgruppe bezeichnet | String |
| FriendlyName | Anzeigename der Abrechnungsgruppe | Zeichenfolge |
| Name | Name der Abrechnungsgruppe | String |
| Typ | Typ der Abrechnungsgruppe. Beispielsweise „ProtectedContainer“ oder „BackupItem“ | String |
| SourceSizeInMBs | Front-End-Größe der Abrechnungsgruppe in MB | Double |
| VaultStore_StorageConsumptionInMBs | Gesamter, von der Abrechnungsgruppe in der Vault-Standard-Ebene belegter Cloudspeicher | Double |
| BackupSolution | Sicherungslösung, der die Abrechnungsgruppe zugeordnet ist. Beispielsweise „Azure-VM-Sicherung, SQL“ in „Azure-VM-Sicherung“ usw. | String |
| VaultResourceId | Azure Resource Manager-ID (ARM) des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultUniqueId | Fremdschlüssel, der auf den der Abrechnungsgruppe zugeordneten Tresor verweist | String |
| VaultName | Name des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultTags | Tags des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultSubscriptionId | Abonnement-ID des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultLocation | Speicherort des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultStore_StorageReplicationType | Speicherreplikationstyp des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultType | Typ des Tresors, z. B. „Microsoft.RecoveryServices/vaults“ oder „Microsoft.DataProtection/backupVaults“ | String |
| TimeGenerated | Zeitstempel des Datensatzes | Datetime |
| ExtendedProperties | Zusätzliche Eigenschaften der Abrechnungsgruppe | Dynamisch |
Trendfunktionen
_AzureBackup_GetBackupInstancesTrends()
Diese Funktion gibt Verlaufsdatensätze für jede Sicherungsinstanz zurück, was Ihnen ermöglicht, wichtige tägliche, wöchentliche und monatliche Trends in Bezug auf die Anzahl der Sicherungsinstanzen und den Speicherverbrauch auf mehreren Granularitätsebenen anzeigen zu können.
Parameter
| Parametername | Beschreibung | Erforderlich? | Beispielwert | Datentyp |
|---|---|---|---|---|
| RangeStart | Verwenden Sie diesen Parameter zusammen mit dem RangeEnd-Parameter zum Abrufen aller Datensätze im Zusammenhang mit Sicherungsinstanzen im Zeitraum von „RangeStart“ bis „RangeEnd“. | J | „2021-03-03 00:00:00“ | Datetime |
| RangeEnd | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter zum Abrufen aller Datensätze im Zusammenhang mit Sicherungsinstanzen im Zeitraum von „RangeStart“ bis „RangeEnd“. | J | „2021-03-10 00:00:00“ | Datetime |
| VaultSubscriptionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Abonnements zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Abonnement-IDs als Parameter für diese Funktion können Sie nur die Sicherungsinstanzen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Abonnements sucht. | N | „00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111“ | String |
| VaultLocationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Regionen zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Regionen als Parameter für diese Funktion können Sie nur die Sicherungsinstanzen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Regionen sucht. | N | eastus,westus |
String |
| VaultList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Tresoren zu filtern. Durch Angabe einer kommagetrennten Liste von Tresornamen als Parameter für diese Funktion können Sie Datensätze von Sicherungsinstanzen abrufen, die nur zu den angegebenen Tresoren gehören. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen von Sicherungsinstanzen in allen Tresoren sucht. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf Datensätze eines bestimmten Tresortyps zu filtern. Standardmäßig ist der Wert dieses Parameters „*“, wodurch die Funktion sowohl nach Recovery Services-Tresoren als auch nach Sicherungstresoren sucht. | N | „Microsoft.RecoveryServices/vaults“ | String |
| ExcludeLegacyEvent | Verwenden Sie diesen Parameter, um auszuwählen, ob Daten in der AzureDiagnostics-Tabelle der Vorgängerversion abgefragt werden sollen oder nicht. Wenn der Wert dieses Parameters „false“ lautet, fragt die Funktion Daten aus der AzureDiagnostics-Tabelle und den ressourcenspezifischen Tabellen ab. Wenn der Wert dieses Parameters „true“ lautet, fragt die Funktion nur Daten aus den ressourcenspezifischen Tabellen ab. Der Standardwert ist true. | N | true | Boolean |
| BackupSolutionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Sicherungslösungen zu filtern, die in ihrer Azure-Umgebung verwendet werden. Wenn Sie zum Beispiel Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM als Wert dieses Parameters angeben, gibt die Funktion nur Datensätze zurück, die sich auf Elemente beziehen, die mit Sicherung von Azure-VMs, SQL in Azure-VM-Sicherung oder DPM nach Azure Backup gesichert wurden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion Datensätze zurückgibt, die zu allen von Sicherungsberichten unterstützten Sicherungslösungen gehören (unterstützte Werte sind „Sicherung von Azure-VMs“, „SQL in Azure-VM-Sicherung“, „SAP HANA in Azure-VM-Sicherung“, „Azure Storage (Azure Files)-Sicherung“, „Azure Backup-Agent“, „DPM“, „Azure Backup Server“, „Azure Database for PostgreSQL Server-Sicherung“, „Azure Blob-Sicherung“, „Azure Disk-Sicherung“ oder eine durch Komma getrennte Kombination dieser Werte). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Verwenden Sie diesen Parameter, um auszuwählen, ob nur die aktiv geschützten Sicherungsinstanzen berücksichtigt werden sollen, oder ob auch die Instanzen eingeschlossen werden sollen, für die der Schutz beendet wurde, und die Instanzen, für die die anfängliche Sicherung aussteht. Für Recovery Services-Tresorworkloads sind unterstützte Werte „Protected“, „ProtectionStopped“, „InitialBackupPending“ oder eine kommagetrennte Kombination dieser Werte. Für Sicherungstresor-Workloads werden „Protected“, „ConfiguringProtection“, „ConfiguringProtectionFailed“, „UpdatingProtection“, „ProtectionError“, „ProtectionStopped“ oder eine durch Kommas getrennte Kombination dieser Werte unterstützt. Standardmäßig lautet der Wert „*“, wodurch die Funktion nach allen Sicherungsinstanzen sucht, unabhängig von den Schutzdetails. | N | „Protected“ | String |
| DatasourceSetName | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf eine bestimmte übergeordnete Ressource zu filtern. Um zum Beispiel SQL in Azure VM-Sicherungsinstanzen zurückzugeben, die zum virtuellen Computer „testvm“ gehören, geben Sie testvm als Wert dieses Parameters an. Standardmäßig lautet der Wert „*“, wodurch die Funktion nach Datensätzen in allen Sicherungsinstanzen sucht. | N | „testvm“ | String |
| BackupInstanceName | Verwenden Sie diesen Parameter, um anhand des Namens nach einer bestimmten Sicherungsinstanz zu suchen. Standardmäßig lautet der Wert „*“, sodass die Funktion nach allen Sicherungsinstanzen sucht. | N | „testvm“ | String |
| DisplayAllFields | Verwenden Sie diesen Parameter, um auszuwählen, ob nur eine Teilmenge der von der Funktion zurückgegebenen Felder abgerufen werden soll. Wenn der Wert dieses Parameters „false“ lautet, entfernt die Funktion Informationen, die sich auf Speicher und Aufbewahrungspunkt beziehen, aus der Ausgabe der Funktion. Dies ist nützlich, wenn Sie diese Funktion als Zwischenschritt in einer größeren Abfrage verwenden und die Leistung der Abfrage optimieren müssen, indem Sie Spalten eliminieren, die Sie für die Analyse nicht benötigen. Standardmäßig lautet der Wert dieses Parameters „true“, wodurch die Funktion alle Felder zurückgibt, die sich auf die Sicherungsinstanz beziehen. | N | true | Boolean |
| AggregationType | Verwenden Sie diesen Parameter, um die zeitliche Granularität anzugeben, mit der Daten abgerufen werden sollen. Wenn der Wert dieses Parameters „Täglich“ lautet, gibt die Funktion einen Datensatz pro Sicherungsinstanz pro Tag zurück, sodass Sie die täglichen Trends des Speicherverbrauchs und der Front-End-Größe analysieren können. Wenn der Wert dieses Parameters „Wöchentlich“ lautet, gibt die Funktion einen Datensatz pro Sicherungsinstanz pro Woche zurück, sodass Sie wöchentliche Trends analysieren können. Entsprechend können Sie „Monatlich“ angeben, um monatliche Trends zu analysieren. Standardwert ist „Täglich“. Wenn Sie Daten über größere Zeiträume betrachten, empfiehlt es sich, „Wöchentlich“ oder „Monatlich“ zu verwenden, um die Abfrageleistung zu verbessern und die Trendanalyse zu erleichtern. | N | „Wöchentlich“ | String |
Zurückgegebene Felder
| Feldname | Beschreibung | Datentyp |
|---|---|---|
| UniqueId | Primärschlüssel, der die eindeutige ID der Sicherungsinstanz bezeichnet | String |
| Id | Azure Resource Manager-ID (ARM) der Sicherungsinstanz | String |
| FriendlyName | Anzeigename der Sicherungsinstanz | String |
| ProtectionInfo | Informationen zu den Schutzeinstellungen der Sicherungsinstanz. Zum Beispiel, „Schutz konfiguriert“, „Schutz beendet“, „Erste Sicherung ausstehend“ | String |
| LatestRecoveryPoint | Datum und Uhrzeit des letzten der Sicherungsinstanz zugeordneten Wiederherstellungspunkts. Derzeit wird dieses Feld nur für Recovery Services-Tresorworkloads unterstützt. | Datetime |
| OldestRecoveryPoint | Datum und Uhrzeit des ältesten der Sicherungsinstanz zugeordneten Wiederherstellungspunkts | Derzeit wird dieses Feld nur für Recovery Services-Tresorworkloads unterstützt. |
| SourceSizeInMBs | Front-End-Größe der Sicherungsinstanz in MB | Double |
| VaultStore_StorageConsumptionInMBs | Gesamter, von der Sicherungsinstanz in der Vault-Standard-Ebene belegter Cloudspeicher | Double |
| DataSourceFriendlyName | Anzeigename der Datenquelle, die der Sicherungsinstanz entspricht | String |
| BackupSolution | Sicherungslösung, der die Sicherungsinstanz zugeordnet ist. Beispielsweise „Azure-VM-Sicherung, SQL“ in „Azure-VM-Sicherung“ usw. | String |
| DatasourceType | Typ der Datenquelle, die der Sicherungsinstanz entspricht. Beispiel: „Microsoft.Compute/virtualMachines“ | String |
| DatasourceResourceId | Azure Resource Manager-ID (ARM) der zugrunde liegenden Datenquelle, die der Sicherungsinstanz entspricht. Beispiel: Azure Resource Manager-ID (ARM) der VM | String |
| DatasourceSetFriendlyName | Anzeigename der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SQL in Azure-VM-Datenquelle enthält dieses Feld beispielsweise der Name der VM, in der sich die SQL-Datenbank befindet | String |
| DatasourceSetResourceId | Azure Resource Manager-ID (ARM) der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SQL in Azure-VM-Datenquelle enthält dieses Feld beispielsweise die Azure Resource Manager-ID (ARM) der VM, in der sich die SQL-Datenbank befindet | String |
| DatasourceSetType | Typ der übergeordneten Ressource der Datenquelle (wo zutreffend). Für eine SAP HANA in Azure VM-Datenquelle lautet dieses Feld beispielsweise „Microsoft.Compute/virtualMachines“, da die übergeordnete Ressource eine Azure-VM ist | String |
| PolicyName | Name der der Sicherungsinstanz zugeordneten Richtlinie | String |
| PolicyUniqueId | Fremdschlüssel, der auf die der Sicherungsinstanz zugeordnete Richtlinie verweist | String |
| PolicyId | Azure Resource Manager-ID (ARM) der der Sicherungsinstanz zugeordneten Richtlinie | String |
| VaultResourceId | Azure Resource Manager-ID (ARM) des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultUniqueId | Fremdschlüssel, der auf den der Sicherungsinstanz zugeordneten Tresor verweist | String |
| VaultName | Name des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultTags | Tag des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultSubscriptionId | Abonnement-ID des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultLocation | Speicherort des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultStore_StorageReplicationType | Speicherreplikationstyp des der Sicherungsinstanz zugeordneten Tresors | String |
| VaultType | Typ des Tresors, z. B. „Microsoft.RecoveryServices/vaults“ oder „Microsoft.DataProtection/backupVaults“ | String |
| TimeGenerated | Zeitstempel des Datensatzes | Datetime |
_AzureBackup_GetBillingGroupsTrends()
Diese Funktion gibt Verlaufsdatensätze für jede Abrechnungsentität zurück, was Ihnen ermöglicht, wichtige tägliche, wöchentliche und monatliche Trends in Bezug auf die Front-End-Größe und den Speicherverbrauch auf mehreren Granularitätsebenen anzeigen können.
Parameter
| Parametername | Beschreibung | Erforderlich? | Beispielwert | Datentyp |
|---|---|---|---|---|
| RangeStart | Verwenden Sie diesen Parameter zusammen mit dem RangeEnd-Parameter zum Abrufen aller Datensätze im Zusammenhang mit Abrechnungsgruppen im Zeitraum von „RangeStart“ bis „RangeEnd“. | J | „2021-03-03 00:00:00“ | Datetime |
| RangeEnd | Verwenden Sie diesen Parameter zusammen mit dem RangeStart-Parameter zum Abrufen aller Datensätze im Zusammenhang mit Abrechnungsgruppen im Zeitraum von „RangeStart“ bis „RangeEnd“. | J | „2021-03-10 00:00:00“ | Datetime |
| VaultSubscriptionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Abonnements zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Abonnement-IDs als Parameter für diese Funktion können Sie nur die Abrechnungsgruppen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Abonnements sucht. | N | „00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111“ | String |
| VaultLocationList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Regionen zu filtern, für die Sicherungsdaten vorhanden sind. Durch die Angabe einer durch Trennzeichen getrennten Liste von Regionen als Parameter für diese Funktion können Sie nur die Abrechnungsgruppen abrufen, die in den angegebenen Abonnements enthalten sind. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen in allen Regionen sucht. | N | eastus,westus |
String |
| VaultList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Tresoren zu filtern. Durch Angabe einer kommagetrennten Liste von Tresornamen als Parameter für diese Funktion können Sie Datensätze von Sicherungsinstanzen abrufen, die nur zu den angegebenen Tresoren gehören. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion nach Datensätzen von Abrechnungsgruppen in allen Tresoren sucht. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion auf Datensätze eines bestimmten Tresortyps zu filtern. Standardmäßig ist der Wert dieses Parameters „*“, wodurch die Funktion sowohl nach Recovery Services-Tresoren als auch nach Sicherungstresoren sucht. | N | „Microsoft.RecoveryServices/vaults“ | String |
| ExcludeLegacyEvent | Verwenden Sie diesen Parameter, um auszuwählen, ob Daten in der AzureDiagnostics-Tabelle der Vorgängerversion abgefragt werden sollen oder nicht. Wenn der Wert dieses Parameters „false“ lautet, fragt die Funktion Daten aus der AzureDiagnostics-Tabelle und den ressourcenspezifischen Tabellen ab. Wenn der Wert dieses Parameters „true“ lautet, fragt die Funktion nur Daten aus den ressourcenspezifischen Tabellen ab. Der Standardwert ist true. | N | true | Boolean |
| BackupSolutionList | Verwenden Sie diesen Parameter, um die Ausgabe der Funktion für einen bestimmten Satz von Sicherungslösungen zu filtern, die in ihrer Azure-Umgebung verwendet werden. Wenn Sie zum Beispiel Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM als Wert dieses Parameters angeben, gibt die Funktion nur Datensätze zurück, die sich auf Elemente beziehen, die mit Sicherung von Azure-VMs, SQL in Azure-VM-Sicherung oder DPM nach Azure Backup gesichert wurden. Standardmäßig lautet der Wert dieses Parameters „*“, wodurch die Funktion Datensätze zurückgibt, die zu allen von Sicherungsberichten unterstützten Sicherungslösungen gehören (unterstützte Werte sind „Sicherung von Azure-VMs“, „SQL in Azure-VM-Sicherung“, „SAP HANA in Azure-VM-Sicherung“, „Azure Storage (Azure Files)-Sicherung“, „Azure Backup-Agent“, „DPM“, „Azure Backup Server“, „Azure Database for PostgreSQL Server-Sicherung“, „Azure Blob-Sicherung“, „Azure Disk-Sicherung“ oder eine durch Komma getrennte Kombination dieser Werte). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Verwenden Sie diesen Parameter, um nach einer bestimmten Abrechnungsgruppe anhand ihres Namens zu suchen. Standardmäßig lautet der Wert „*“, sodass die Funktion nach allen Abrechnungsgruppen sucht. | N | „testvm“ | String |
| AggregationType | Verwenden Sie diesen Parameter, um die zeitliche Granularität anzugeben, mit der Daten abgerufen werden sollen. Wenn der Wert dieses Parameters „Täglich“ lautet, gibt die Funktion einen Datensatz pro Abrechnungsgruppe pro Tag zurück, sodass Sie die täglichen Trends des Speicherverbrauchs und der Front-End-Größe analysieren können. Wenn der Wert dieses Parameters „Wöchentlich“ lautet, gibt die Funktion einen Datensatz pro Sicherungsinstanz pro Woche zurück, sodass Sie wöchentliche Trends analysieren können. Entsprechend können Sie „Monatlich“ angeben, um monatliche Trends zu analysieren. Standardwert ist „Täglich“. Wenn Sie Daten über größere Zeiträume betrachten, empfiehlt es sich, „Wöchentlich“ oder „Monatlich“ zu verwenden, um die Abfrageleistung zu verbessern und die Trendanalyse zu erleichtern. | N | „Wöchentlich“ | String |
Zurückgegebene Felder
| Feldname | Beschreibung | Datentyp |
|---|---|---|
| UniqueId | Primärschlüssel, der die eindeutige ID der Abrechnungsgruppe bezeichnet | String |
| FriendlyName | Anzeigename der Abrechnungsgruppe | Zeichenfolge |
| Name | Name der Abrechnungsgruppe | String |
| Typ | Typ der Abrechnungsgruppe. Beispielsweise „ProtectedContainer“ oder „BackupItem“ | String |
| SourceSizeInMBs | Front-End-Größe der Abrechnungsgruppe in MB | Double |
| VaultStore_StorageConsumptionInMBs | Gesamter, von der Abrechnungsgruppe in der Vault-Standard-Ebene belegter Cloudspeicher | Double |
| BackupSolution | Sicherungslösung, der die Abrechnungsgruppe zugeordnet ist. Beispielsweise „Azure-VM-Sicherung, SQL“ in „Azure-VM-Sicherung“ usw. | String |
| VaultResourceId | Azure Resource Manager-ID (ARM) des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultUniqueId | Fremdschlüssel, der auf den der Abrechnungsgruppe zugeordneten Tresor verweist | String |
| VaultName | Name des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultTags | Tags des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultSubscriptionId | Abonnement-ID des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultLocation | Speicherort des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultStore_StorageReplicationType | Speicherreplikationstyp des der Abrechnungsgruppe zugeordneten Tresors | String |
| VaultType | Typ des Tresors, z. B. „Microsoft.RecoveryServices/vaults“ oder „Microsoft.DataProtection/backupVaults“ | String |
| TimeGenerated | Zeitstempel des Datensatzes | Datetime |
| ExtendedProperties | Zusätzliche Eigenschaften der Abrechnungsgruppe | Dynamisch |
Beispielabfragen
Im Folgenden finden Sie einige Beispielabfragen, die Ihnen beim Einstieg in die Verwendung von Systemfunktionen helfen.
Alle fehlgeschlagenen Azure-VM-Sicherungsaufträge in einem bestimmten Zeitraum
_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=DataTransferredInMBsAlle SQL-Protokollsicherungsaufträge in einem bestimmten Zeitraum
_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=DataTransferredInMBsWöchentlicher Trend des für den virtuellen Computer „testvm“ verbrauchten Sicherungsspeichers
_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