Freigeben über


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=DataTransferredInMBs
    
  • Alle 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=DataTransferredInMBs
    
  • Wö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 
    

Nächste Schritte

Weitere Informationen zu Azure Backup-Berichten