Funkcje systemowe w dziennikach usługi Azure Monitor
W tym artykule opisano sposób pisania zapytań niestandardowych w dziennikach usługi Azure Monitor przy użyciu funkcji systemowych.
Usługa Azure Backup udostępnia zestaw funkcji nazywanych funkcjami systemowymi lub funkcjami rozwiązania, które są domyślnie dostępne w obszarach roboczych usługi Log Analytics (LA).
Te funkcje działają na danych w nieprzetworzonych tabelach usługi Azure Backup w la i zwracają sformatowane dane, które ułatwiają pobieranie informacji o wszystkich jednostkach związanych z kopiami zapasowymi przy użyciu prostych zapytań. Użytkownicy mogą przekazywać parametry do tych funkcji, aby filtrować dane zwracane przez te funkcje.
Zalecamy używanie funkcji systemowych do wykonywania zapytań dotyczących danych kopii zapasowej w obszarach roboczych la na potrzeby tworzenia niestandardowych raportów, ponieważ zapewniają one szereg korzyści, jak opisano w poniższej sekcji.
Zalety korzystania z funkcji systemowych
Prostsze zapytania: użycie funkcji pomaga zmniejszyć liczbę sprzężeń wymaganych w zapytaniach. Domyślnie funkcje zwracają schematy "spłaszczone", które zawierają wszystkie informacje dotyczące jednostki (wystąpienie kopii zapasowej, zadanie, magazyn itd.) są odpytywane. Jeśli na przykład musisz uzyskać listę pomyślnych zadań tworzenia kopii zapasowej według nazwy elementu kopii zapasowej i skojarzonego z nim kontenera, proste wywołanie funkcji _AzureBackup_getJobs() da wszystkie te informacje dla każdego zadania. Z drugiej strony wykonywanie zapytań dotyczących nieprzetworzonych tabel wymagałoby wykonania wielu sprzężeń między tabelami AddonAzureBackupJobs i CoreAzureBackupUp .
Bezproblemowe przejście ze starszego zdarzenia diagnostycznego: korzystanie z funkcji systemowych ułatwia bezproblemowe przejście ze starszego zdarzenia diagnostycznego (AzureBackupReport w trybie AzureDiagnostics) do zdarzeń specyficznych dla zasobów. Wszystkie funkcje systemowe udostępniane przez usługę Azure Backup umożliwiają określenie parametru, który umożliwia wybranie, czy funkcja powinna wykonywać zapytania dotyczące danych tylko z tabel specyficznych dla zasobów, czy wysyłać zapytania o dane zarówno ze starszej tabeli, jak i tabel specyficznych dla zasobów (z deduplikacją rekordów).
- Jeśli pomyślnie przeprowadzono migrację do tabel specyficznych dla zasobów, możesz wykluczyć starszą tabelę z zapytań dotyczących funkcji.
- Jeśli jesteś obecnie w trakcie migracji i masz pewne dane w starszych tabelach, które są wymagane do analizy, możesz dołączyć starszą tabelę. Po zakończeniu przejścia i nie potrzebujesz już danych ze starszej tabeli, możesz zaktualizować wartość parametru przekazanego do funkcji w zapytaniach, aby wykluczyć starszą tabelę.
- Jeśli nadal używasz tylko starszej tabeli, funkcje będą nadal działać, jeśli zdecydujesz się dołączyć starszą tabelę za pomocą tego samego parametru. Zaleca się jednak, aby najwcześniej przełączyć się do tabel specyficznych dla zasobów.
Zmniejsza możliwość przerywania zapytań niestandardowych: jeśli usługa Azure Backup wprowadza ulepszenia schematu bazowych tabel la w celu uwzględnienia przyszłych scenariuszy raportowania, definicja funkcji zostanie również zaktualizowana w celu uwzględnienia zmian schematu. W związku z tym, jeśli używasz funkcji systemowych do tworzenia zapytań niestandardowych, zapytania nie będą przerywane, nawet jeśli istnieją zmiany w bazowym schemacie tabel.
Uwaga
Funkcje systemowe są obsługiwane przez firmę Microsoft, a ich definicje nie mogą być edytowane przez użytkowników. Jeśli potrzebujesz funkcji edytowalnych, możesz utworzyć zapisane funkcje w la.
Typy funkcji systemowych oferowanych przez usługę Azure Backup
Podstawowe funkcje: są to funkcje, które ułatwiają wykonywanie zapytań względem dowolnych kluczowych jednostek usługi Azure Backup, takich jak wystąpienia kopii zapasowych, magazyny, zasady, zadania i jednostki rozliczeniowe. Na przykład funkcja _AzureBackup_getBackupInstances zwraca listę wszystkich wystąpień kopii zapasowych, które istnieją w danym środowisku od ostatniego ukończonego dnia (w formacie UTC). Parametry i zwrócony schemat dla każdej z tych podstawowych funkcji są podsumowywane poniżej w tym artykule.
Funkcje trendu: są to funkcje, które zwracają historyczne rekordy dla jednostek powiązanych z kopiami zapasowymi (na przykład wystąpień kopii zapasowych, grup rozliczeniowych) i umożliwiają uzyskiwanie informacji o trendach dziennych, tygodniowych i miesięcznych dotyczących kluczowych metryk (na przykład liczba, wykorzystany magazyn) odnoszących się do tych jednostek. Parametry i zwrócony schemat dla każdej z tych funkcji trendu są podsumowywane poniżej w tym artykule.
Uwaga
Obecnie funkcje systemowe zwracają dane do ostatniego ukończonego dnia (w formacie UTC). Dane dla bieżącego częściowego dnia nie są zwracane. Jeśli więc chcesz pobrać rekordy dla bieżącego dnia, musisz użyć nieprzetworzonych tabel la.
Lista funkcji systemowych
Podstawowe funkcje
_AzureBackup_GetVaults()
Ta funkcja zwraca listę wszystkich magazynów usługi Recovery Services w środowisku platformy Azure skojarzonych z obszarem roboczym la.
Parametry
| Nazwa parametru | Opis | Wymagane? | Przykładowa wartość | Typ danych |
|---|---|---|---|---|
| RangeStart | Użyj tego parametru wraz z parametrem RangeEnd tylko wtedy, gdy musisz pobrać wszystkie rekordy związane z magazynem w okresie od RangeStart do RangeEnd. Domyślnie wartości RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdego magazynu. | N | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Użyj tego parametru wraz z parametrem RangeStart tylko wtedy, gdy musisz pobrać wszystkie rekordy związane z magazynem w okresie od RangeStart do RangeEnd. Domyślnie wartości RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdego magazynu. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu subskrypcji, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy identyfikatorów subskrypcji jako parametru tej funkcji pomaga pobrać tylko te magazyny, które znajdują się w określonych subskrypcjach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich subskrypcjach. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu regionów, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy regionów jako parametru dla tej funkcji pomaga pobrać tylko te magazyny, które znajdują się w określonych regionach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich regionach. | N | eastus,westus |
String |
| VaultList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu magazynów. Określenie rozdzielanej przecinkami listy nazw magazynów jako parametru tej funkcji ułatwia pobieranie rekordów odnoszących się tylko do określonych magazynów. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich magazynach. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do rekordów odnoszących się do określonego typu magazynu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zarówno magazyny usługi Recovery Services, jak i magazyny usługi Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Użyj tego parametru, aby wybrać, czy wysyłać zapytania dotyczące danych w starszej tabeli AzureDiagnostics, czy nie. Jeśli wartość tego parametru jest fałsz, funkcja wykonuje zapytania dotyczące danych zarówno z tabeli AzureDiagnostics, jak i tabel specyficznych dla zasobu. Jeśli wartość tego parametru ma wartość true, funkcja wysyła zapytania do danych tylko z tabel specyficznych dla zasobu. Domyślna wartość to true. | N | prawda | Wartość logiczna |
Zwrócone pola
| Nazwa pola | Opis | Typ danych |
|---|---|---|
| UniqueId | Klucz podstawowy oznaczający unikatowy identyfikator magazynu | String |
| Id | Identyfikator usługi Azure Resource Manager (ARM) magazynu | String |
| Nazwisko | Nazwa magazynu | String |
| SubscriptionId | Identyfikator subskrypcji, w której istnieje magazyn | String |
| Lokalizacja | Lokalizacja, w której istnieje magazyn | String |
| VaultStore_StorageReplicationType | Typ replikacji magazynu skojarzony z magazynem | String |
| Tagi | Tagi magazynu | String |
| TimeGenerated | Sygnatura czasowa rekordu | DateTime |
| Typ | Typ magazynu, na przykład "Microsoft.RecoveryServices/vaults" lub "Microsoft.DataProtection/backupVaults" | String |
_AzureBackup_GetPolicies()
Ta funkcja zwraca listę zasad kopii zapasowych, które są używane w środowisku platformy Azure wraz ze szczegółowymi informacjami na temat poszczególnych zasad, takich jak typ źródła danych, typ replikacji magazynu itd.
Parametry
| Nazwa parametru | Opis | Wymagane? | Przykładowa wartość | Typ danych |
|---|---|---|---|---|
| RangeStart | Użyj tego parametru wraz z parametrem RangeStart tylko wtedy, gdy musisz pobrać wszystkie rekordy związane z zasadami w okresie od RangeStart do RangeEnd. Domyślnie wartości RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdej zasady. | N | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Użyj tego parametru wraz z parametrem RangeStart tylko wtedy, gdy musisz pobrać wszystkie rekordy związane z zasadami w okresie od RangeStart do RangeEnd. Domyślnie wartości RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdej zasady. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu subskrypcji, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy identyfikatorów subskrypcji jako parametru tej funkcji pomaga pobrać tylko te zasady, które znajdują się w określonych subskrypcjach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich subskrypcjach. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu regionów, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy regionów jako parametru dla tej funkcji pomaga pobrać tylko te zasady, które znajdują się w określonych regionach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich regionach. | N | eastus,westus |
String |
| VaultList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu magazynów. Określenie rozdzielanej przecinkami listy nazw magazynów jako parametru tej funkcji ułatwia pobieranie rekordów zasad odnoszących się tylko do określonych magazynów. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy zasad we wszystkich magazynach. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do rekordów odnoszących się do określonego typu magazynu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zarówno magazyny usługi Recovery Services, jak i magazyny usługi Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Użyj tego parametru, aby wybrać, czy wysyłać zapytania dotyczące danych w starszej tabeli AzureDiagnostics, czy nie. Jeśli wartość tego parametru jest fałsz, funkcja wykonuje zapytania dotyczące danych zarówno z tabeli AzureDiagnostics, jak i tabel specyficznych dla zasobu. Jeśli wartość tego parametru ma wartość true, funkcja wysyła zapytania do danych tylko z tabel specyficznych dla zasobu. Domyślna wartość to true. | N | prawda | Wartość logiczna |
| BackupSolutionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu rozwiązań do tworzenia kopii zapasowych używanych w środowisku platformy Azure. Jeśli na przykład określisz Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM wartość tego parametru, funkcja zwraca tylko rekordy powiązane z elementami kopii zapasowych przy użyciu kopii zapasowej maszyny wirtualnej platformy Azure, bazy danych SQL w kopii zapasowej maszyny wirtualnej platformy Azure lub programu DPM do usługi Azure Backup. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja zwraca rekordy odnoszące się do wszystkich rozwiązań kopii zapasowych obsługiwanych przez raporty kopii zapasowej (obsługiwane wartości to "Kopia zapasowa maszyny wirtualnej platformy Azure", "SQL w usłudze Azure VM Backup", "SAP HANA w usłudze Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup", "Azure Blob Backup", "Azure Disk Backup" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
Zwrócone pola
| Nazwa pola | Opis | **Typ danych ** |
|---|---|---|
| UniqueId | Klucz podstawowy oznaczający unikatowy identyfikator zasad | String |
| Id | Identyfikator zasad usługi Azure Resource Manager (ARM) | String |
| Nazwisko | Nazwa zasad | String |
| Strefa czasowa | Strefa czasowa, w której zdefiniowano zasady | String |
| Rozwiązanie do tworzenia kopii zapasowych | Rozwiązanie do tworzenia kopii zapasowych skojarzone z zasadami. Na przykład kopia zapasowa maszyny wirtualnej platformy Azure, sql w usłudze Azure VM Backup itd. | String |
| TimeGenerated | Sygnatura czasowa rekordu | Datetime |
| VaultUniqueId | Klucz obcy odwołujący się do magazynu skojarzonego z zasadami | String |
| VaultResourceId | Identyfikator usługi Azure Resource Manager (ARM) magazynu skojarzonego z zasadami | String |
| VaultName | Nazwa magazynu skojarzonego z zasadami | String |
| Tagi magazynu | Tagi magazynu skojarzonego z zasadami | String |
| VaultLocation | Lokalizacja magazynu skojarzonego z zasadami | String |
| VaultSubscriptionId | Identyfikator subskrypcji magazynu skojarzonego z zasadami | String |
| VaultStore_StorageReplicationType | Typ replikacji magazynu skojarzonego z zasadami | String |
| VaultType | Typ magazynu, na przykład "Microsoft.RecoveryServices/vaults" lub "Microsoft.DataProtection/backupVaults" | String |
| Właściwości rozszerzone | Dodatkowe właściwości zasad | Dynamiczny |
_AzureBackup_GetJobs()
Ta funkcja zwraca listę wszystkich zadań związanych z tworzeniem kopii zapasowej i przywracaniem, które zostały wyzwolone w określonym zakresie czasu, wraz ze szczegółowymi informacjami o każdym zadaniu, takimi jak stan zadania, czas trwania zadania, transferowane dane itd.
Parametry
| Nazwa parametru | Opis | Wymagane? | Przykładowa wartość | **Typ danych ** |
|---|---|---|---|---|
| RangeStart | Użyj tego parametru wraz z parametrem RangeEnd, aby pobrać listę wszystkich zadań uruchomionych w okresie od RangeStart do RangeEnd. | Y | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Użyj tego parametru wraz z parametrem RangeStart, aby pobrać listę wszystkich zadań uruchomionych w okresie od RangeStart do RangeEnd. | Y | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu subskrypcji, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy identyfikatorów subskrypcji jako parametru tej funkcji ułatwia pobranie tylko tych zadań skojarzonych z magazynami w określonych subskrypcjach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich subskrypcjach. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu regionów, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy regionów jako parametru dla tej funkcji ułatwia pobranie tylko tych zadań skojarzonych z magazynami w określonych regionach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich regionach. | N | eastus,westus |
String |
| VaultList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu magazynów. Określenie rozdzielanej przecinkami listy nazw magazynów jako parametru tej funkcji ułatwia pobieranie zadań odnoszących się tylko do określonych magazynów. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zadania we wszystkich magazynach. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do rekordów odnoszących się do określonego typu magazynu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zarówno magazyny usługi Recovery Services, jak i magazyny usługi Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Użyj tego parametru, aby wybrać, czy wysyłać zapytania dotyczące danych w starszej tabeli AzureDiagnostics, czy nie. Jeśli wartość tego parametru jest fałsz, funkcja wykonuje zapytania dotyczące danych zarówno z tabeli AzureDiagnostics, jak i tabel specyficznych dla zasobu. Jeśli wartość tego parametru ma wartość true, funkcja wysyła zapytania do danych tylko z tabel specyficznych dla zasobu. Domyślna wartość to true. | N | prawda | Wartość logiczna |
| BackupSolutionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu rozwiązań do tworzenia kopii zapasowych używanych w środowisku platformy Azure. Jeśli na przykład określisz Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM wartość tego parametru, funkcja zwraca tylko rekordy powiązane z elementami kopii zapasowych przy użyciu kopii zapasowej maszyny wirtualnej platformy Azure, bazy danych SQL w kopii zapasowej maszyny wirtualnej platformy Azure lub programu DPM do usługi Azure Backup. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja zwraca rekordy odnoszące się do wszystkich rozwiązań kopii zapasowych obsługiwanych przez raporty kopii zapasowej (obsługiwane wartości to "Kopia zapasowa maszyny wirtualnej platformy Azure", "SQL w usłudze Azure VM Backup", "SAP HANA w usłudze Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup", "Azure Blob Backup", "Azure Disk Backup" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| JobOperationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego typu zadania. Na przykład operacje tworzenia kopii zapasowej lub przywracania. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zadania tworzenia kopii zapasowej i przywracania. | N | "Kopia zapasowa" | String |
| JobStatusList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji pod kątem określonego stanu zadania. Na przykład Ukończono, Niepowodzenie itd. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje wszystkie zadania niezależnie od stanu. | N | Failed,CompletedWithWarnings |
String |
| JobFailureCodeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego kodu błędu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje wszystkie zadania niezależnie od kodu błędu. | N | "Sukces" | String |
| DatasourceSetName | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do określonego zasobu nadrzędnego. Aby na przykład zwrócić sql w wystąpieniach kopii zapasowej maszyny wirtualnej platformy Azure należących do maszyny wirtualnej "testvm", określ parametr testvm jako wartość tego parametru. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich wystąpieniach kopii zapasowych. | N | "testvm" | String |
| BackupInstanceName | Użyj tego parametru, aby wyszukać zadania w określonym wystąpieniu kopii zapasowej według nazwy. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich wystąpieniach kopii zapasowych. | N | "testvm" | String |
| ExcludeLog | Użyj tego parametru, aby wykluczyć zadania dziennika z zwracania przez funkcję (pomaga w wydajności zapytań). Domyślnie wartość tego parametru ma wartość true, co sprawia, że funkcja wyklucza zadania dziennika. | N | prawda | Wartość logiczna |
Zwrócone pola
| Nazwa pola | Opis | **Typ danych ** |
|---|---|---|
| UniqueId | Klucz podstawowy oznaczający unikatowy identyfikator zadania | String |
| Kategoria operacji | Kategoria wykonywanej operacji. Na przykład Kopia zapasowa, Przywracanie | String |
| Operacja | Szczegóły wykonywanej operacji. Na przykład dziennik (dla kopii zapasowej dziennika) | String |
| Stan | Stan zadania. Na przykład Ukończono, Niepowodzenie, CompletedWithWarnings | String |
| ErrorTitle | Kod błędu zadania | String |
| StartTime | Data i godzina rozpoczęcia zadania | DateTime |
| DurationInSecs | Czas trwania zadania w sekundach | Liczba rzeczywista |
| DataTransferredInMBs | Dane przesyłane przez zadanie w mb/s. Obecnie to pole jest obsługiwane tylko w przypadku obciążeń magazynu usługi Recovery Services | Liczba rzeczywista |
| RestoreJobRPDateTime | Data i godzina utworzenia punktu odzyskiwania, który jest odzyskiwany. Obecnie to pole jest obsługiwane tylko w przypadku obciążeń magazynu usługi Recovery Services | DateTime |
| RestoreJobRPLocation | Lokalizacja, w której przechowywany był punkt odzyskiwania, który jest odzyskiwany | String |
| BackupInstanceUniqueId | Klucz obcy odwołujący się do wystąpienia kopii zapasowej skojarzonego z zadaniem | String |
| BackupInstanceId | Identyfikator usługi Azure Resource Manager (ARM) wystąpienia kopii zapasowej skojarzonego z zadaniem | String |
| BackupInstanceFriendlyName | Nazwa wystąpienia kopii zapasowej skojarzonego z zadaniem | String |
| DatasourceResourceId | Identyfikator usługi Azure Resource Manager (ARM) bazowego źródła danych skojarzonego z zadaniem. Na przykład identyfikator usługi Azure Resource Manager (ARM) maszyny wirtualnej | String |
| DatasourceFriendlyName | Przyjazna nazwa bazowego źródła danych skojarzonego z zadaniem | String |
| Typ źródła danych | Typ źródła danych skojarzonego z zadaniem. Na przykład "Microsoft.Compute/virtualMachines" | String |
| Tworzenie kopii zapasowych | Rozwiązanie do tworzenia kopii zapasowej skojarzone z zadaniem. Na przykład kopia zapasowa maszyny wirtualnej platformy Azure, sql w usłudze Azure VM Backup itd. | String |
| DatasourceSetResourceId | Identyfikator usługi Azure Resource Manager (ARM) zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku źródła danych sql na maszynie wirtualnej platformy Azure to pole będzie zawierać identyfikator usługi Azure Resource Manager (ARM) maszyny wirtualnej, w której istnieje baza danych SQL | String |
| Typ źródła danych | Typ zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku platformy SAP HANA w źródle danych maszyny wirtualnej platformy Azure to pole Microsoft.Compute/virtualMachines, ponieważ zasób nadrzędny jest maszyną wirtualną platformy Azure | String |
| VaultResourceId | Identyfikator usługi Azure Resource Manager (ARM) magazynu skojarzonego z zadaniem | String |
| VaultUniqueId | Klucz obcy odwołujący się do magazynu skojarzonego z zadaniem | String |
| VaultName | Nazwa magazynu skojarzonego z zadaniem | String |
| Tagi magazynu | Tagi magazynu skojarzonego z zadaniem | String |
| VaultSubscriptionId | Identyfikator subskrypcji magazynu skojarzonego z zadaniem | String |
| VaultLocation | Lokalizacja magazynu skojarzonego z zadaniem | String |
| VaultStore_StorageReplicationType | Typ replikacji magazynu skojarzonego z zadaniem | String |
| VaultType | Typ magazynu, na przykład "Microsoft.RecoveryServices/vaults" lub "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Sygnatura czasowa rekordu | DateTime |
_AzureBackup_GetBackupInstances()
Ta funkcja zwraca listę wystąpień kopii zapasowych skojarzonych z magazynami usługi Recovery Services wraz ze szczegółowymi informacjami o każdym wystąpieniu kopii zapasowej, takimi jak użycie magazynu w chmurze, skojarzone zasady itd.
Parametry
| Nazwa parametru | Opis | Wymagane? | Przykładowa wartość | **Typ danych ** |
|---|---|---|---|---|
| RangeStart | Użyj tego parametru wraz z parametrem RangeEnd tylko wtedy, gdy musisz pobrać wszystkie rekordy związane z wystąpieniem kopii zapasowej w okresie od RangeStart do RangeEnd. Domyślnie wartości RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdego wystąpienia kopii zapasowej. | N | "2021-03-03 00:00:00" | DataTime |
| RangeEnd | Użyj tego parametru wraz z parametrem RangeStart tylko wtedy, gdy musisz pobrać wszystkie rekordy związane z wystąpieniem kopii zapasowej w okresie od RangeStart do RangeEnd. Domyślnie wartości RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdego wystąpienia kopii zapasowej. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu subskrypcji, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy identyfikatorów subskrypcji jako parametru tej funkcji ułatwia pobranie tylko tych wystąpień kopii zapasowych, które znajdują się w określonych subskrypcjach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich subskrypcjach. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu regionów, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy regionów jako parametru dla tej funkcji pomaga pobrać tylko te wystąpienia kopii zapasowych, które znajdują się w określonych regionach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich regionach. | N | eastus,westus |
String |
| VaultList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu magazynów. Określenie rozdzielanej przecinkami listy nazw magazynów jako parametru tej funkcji ułatwia pobieranie rekordów wystąpień kopii zapasowych odnoszących się tylko do określonych magazynów. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy wystąpień kopii zapasowych we wszystkich magazynach. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do rekordów odnoszących się do określonego typu magazynu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zarówno magazyny usługi Recovery Services, jak i magazyny usługi Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Użyj tego parametru, aby wybrać, czy wysyłać zapytania dotyczące danych w starszej tabeli AzureDiagnostics, czy nie. Jeśli wartość tego parametru jest fałsz, funkcja wykonuje zapytania dotyczące danych zarówno z tabeli AzureDiagnostics, jak i tabel specyficznych dla zasobu. Jeśli wartość tego parametru ma wartość true, funkcja wysyła zapytania do danych tylko z tabel specyficznych dla zasobu. Domyślna wartość to true. | N | prawda | Wartość logiczna |
| BackupSolutionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu rozwiązań do tworzenia kopii zapasowych używanych w środowisku platformy Azure. Jeśli na przykład określisz Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM wartość tego parametru, funkcja zwraca tylko rekordy powiązane z elementami kopii zapasowych przy użyciu kopii zapasowej maszyny wirtualnej platformy Azure, bazy danych SQL w kopii zapasowej maszyny wirtualnej platformy Azure lub programu DPM do usługi Azure Backup. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja zwraca rekordy odnoszące się do wszystkich rozwiązań kopii zapasowych obsługiwanych przez raporty kopii zapasowej (obsługiwane wartości to "Kopia zapasowa maszyny wirtualnej platformy Azure", "SQL w usłudze Azure VM Backup", "SAP HANA w usłudze Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup", "Azure Blob Backup", "Azure Disk Backup" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Użyj tego parametru, aby wybrać, czy uwzględnić tylko te wystąpienia kopii zapasowej, które są aktywnie chronione, czy też uwzględnić te wystąpienia, dla których ochrona została zatrzymana, a wystąpienia, dla których oczekuje początkowa kopia zapasowa. W przypadku obciążeń magazynu usługi Recovery Services obsługiwane wartości to "Protected", "ProtectionStopped", "InitialBackupPending" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości. W przypadku obciążeń magazynu kopii zapasowych obsługiwane wartości to "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje wszystkie wystąpienia kopii zapasowej niezależnie od szczegółów ochrony. | N | "Chronione" | String |
| DatasourceSetName | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do określonego zasobu nadrzędnego. Aby na przykład zwrócić sql w wystąpieniach kopii zapasowej maszyny wirtualnej platformy Azure należących do maszyny wirtualnej "testvm", określ parametr testvm jako wartość tego parametru. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich wystąpieniach kopii zapasowych. | N | "testvm" | String |
| BackupInstanceName | Użyj tego parametru, aby wyszukać określone wystąpienie kopii zapasowej według nazwy. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje wszystkie wystąpienia kopii zapasowej. | N | "testvm" | String |
| DisplayAllFields | Użyj tego parametru, aby wybrać, czy pobierać tylko podzbiór pól zwracanych przez funkcję. Jeśli wartość tego parametru jest fałszywa, funkcja eliminuje informacje związane z magazynem i punktem przechowywania z danych wyjściowych funkcji. Jest to przydatne, jeśli używasz tej funkcji jako pośredniego kroku w większym zapytaniu i musisz zoptymalizować wydajność zapytania, eliminując kolumny, które nie są wymagane do analizy. Domyślnie wartość tego parametru jest prawdziwa, co sprawia, że funkcja zwraca wszystkie pola odnoszące się do wystąpienia kopii zapasowej. | N | prawda | Wartość logiczna |
Zwrócone pola
| Nazwa pola | Opis | Typ danych |
|---|---|---|
| UniqueId | Klucz podstawowy oznaczający unikatowy identyfikator wystąpienia kopii zapasowej | String |
| Id | Identyfikator usługi Azure Resource Manager (ARM) wystąpienia kopii zapasowej | String |
| FriendlyName | Przyjazna nazwa wystąpienia kopii zapasowej | String |
| ProtectionInfo | Informacje o ustawieniach ochrony wystąpienia kopii zapasowej. Na przykład ochrona jest skonfigurowana, ochrona zatrzymana, oczekiwanie na początkową kopię zapasową | String |
| LatestRecoveryPoint | Data i godzina najnowszego punktu odzyskiwania skojarzonego z wystąpieniem kopii zapasowej. Obecnie to pole jest obsługiwane tylko w przypadku obciążeń magazynu usługi Recovery Services. | DateTime |
| Najstarszy punktrecoveryPoint | Data i godzina najstarszego punktu odzyskiwania skojarzonego z wystąpieniem kopii zapasowej. Obecnie to pole jest obsługiwane tylko w przypadku obciążeń magazynu usługi Recovery Services. | DateTime |
| SourceSizeInMBs | Rozmiar frontonu wystąpienia kopii zapasowej w mb/s | Liczba rzeczywista |
| VaultStore_StorageConsumptionInMBs | Łączna ilość miejsca do magazynowania w chmurze zużywanego przez wystąpienie kopii zapasowej w warstwie Standardowa magazynu | Liczba rzeczywista |
| DataSourceFriendlyName | Przyjazna nazwa źródła danych odpowiadającego wystąpieniu kopii zapasowej | String |
| Tworzenie kopii zapasowych | Rozwiązanie do tworzenia kopii zapasowych skojarzone z wystąpieniem kopii zapasowej. Na przykład kopia zapasowa maszyny wirtualnej platformy Azure, sql w usłudze Azure VM Backup itd. | String |
| Typ źródła danych | Typ źródła danych odpowiadającego wystąpieniu kopii zapasowej. Na przykład "Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | Identyfikator usługi Azure Resource Manager (ARM) bazowego źródła danych odpowiadającego wystąpieniu kopii zapasowej. Na przykład identyfikator usługi Azure Resource Manager (ARM) maszyny wirtualnej | String |
| DatasourceSetFriendlyName | Przyjazna nazwa zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku usługi SQL w źródle danych maszyny wirtualnej platformy Azure to pole będzie zawierać nazwę maszyny wirtualnej, w której istnieje baza danych SQL Database | String |
| DatasourceSetFriendlyName | Przyjazna nazwa zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku usługi SQL w źródle danych maszyny wirtualnej platformy Azure to pole będzie zawierać nazwę maszyny wirtualnej, w której istnieje baza danych SQL Database | String |
| DatasourceSetResourceId | Identyfikator usługi Azure Resource Manager (ARM) zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku źródła danych sql na maszynie wirtualnej platformy Azure to pole będzie zawierać identyfikator usługi Azure Resource Manager (ARM) maszyny wirtualnej, w której istnieje baza danych SQL | String |
| Typ źródła danych | Typ zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku platformy SAP HANA w źródle danych maszyny wirtualnej platformy Azure to pole Microsoft.Compute/virtualMachines, ponieważ zasób nadrzędny jest maszyną wirtualną platformy Azure | String |
| PolicyName | Nazwa zasad skojarzonych z wystąpieniem kopii zapasowej | String |
| PolicyUniqueId | Klucz obcy odwołujący się do zasad skojarzonych z wystąpieniem kopii zapasowej | String |
| IdentZasady | Identyfikator usługi Azure Resource Manager (ARM) zasad skojarzonych z wystąpieniem kopii zapasowej | String |
| VaultResourceId | Identyfikator usługi Azure Resource Manager (ARM) magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultUniqueId | Klucz obcy odwołujący się do magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultName | Nazwa magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| Tagi magazynu | Tagi magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultSubscriptionId | Identyfikator subskrypcji magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultLocation | Lokalizacja magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultStore_StorageReplicationType | Typ replikacji magazynu skojarzony z wystąpieniem kopii zapasowej | String |
| VaultType | Typ magazynu, czyli "Microsoft.RecoveryServices/vaults" lub "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Sygnatura czasowa rekordu | DateTime |
_AzureBackup_GetBillingGroups()
Ta funkcja zwraca listę wszystkich jednostek rozliczeniowych związanych z kopiami zapasowymi (grup rozliczeniowych) wraz z informacjami dotyczącymi kluczowych składników rozliczeń, takich jak rozmiar frontonu i łączny magazyn w chmurze.
Parametry
| Nazwa parametru | Opis | Wymagane? | Przykładowa wartość | Typ daty |
|---|---|---|---|---|
| RangeStart | Użyj tego parametru wraz z parametrem RangeEnd tylko wtedy, gdy musisz pobrać wszystkie rekordy powiązane z grupami rozliczeniowymi w okresie od RangeStart do RangeEnd. Domyślnie wartość RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdej grupy rozliczeniowej. | N | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Użyj tego parametru wraz z parametrem RangeStart tylko wtedy, gdy musisz pobrać wszystkie rekordy powiązane z grupami rozliczeniowymi w okresie od RangeStart do RangeEnd. Domyślnie wartość RangeStart i RangeEnd mają wartość null, co spowoduje, że funkcja pobierze tylko najnowszy rekord dla każdej grupy rozliczeniowej. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu subskrypcji, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy identyfikatorów subskrypcji jako parametru tej funkcji ułatwia pobranie tylko tych grup rozliczeniowych, które znajdują się w określonych subskrypcjach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich subskrypcjach. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu regionów, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy regionów jako parametru dla tej funkcji pomaga pobrać tylko te grupy rozliczeniowe, które znajdują się w określonych regionach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich regionach. | N | eastus,westus |
String |
| VaultList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu magazynów. Określenie rozdzielanej przecinkami listy nazw magazynów jako parametru tej funkcji ułatwia pobieranie rekordów wystąpień kopii zapasowych odnoszących się tylko do określonych magazynów. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy grup rozliczeniowych we wszystkich magazynach. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do rekordów odnoszących się do określonego typu magazynu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zarówno magazyny usługi Recovery Services, jak i magazyny usługi Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Użyj tego parametru, aby wybrać, czy wysyłać zapytania dotyczące danych w starszej tabeli AzureDiagnostics, czy nie. Jeśli wartość tego parametru jest fałsz, funkcja wykonuje zapytania dotyczące danych zarówno z tabeli AzureDiagnostics, jak i tabel specyficznych dla zasobu. Jeśli wartość tego parametru ma wartość true, funkcja wysyła zapytania do danych tylko z tabel specyficznych dla zasobu. Domyślna wartość to true. | N | prawda | Wartość logiczna |
| BackupSolutionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu rozwiązań do tworzenia kopii zapasowych używanych w środowisku platformy Azure. Jeśli na przykład określisz Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM wartość tego parametru, funkcja zwraca tylko rekordy powiązane z elementami kopii zapasowych przy użyciu kopii zapasowej maszyny wirtualnej platformy Azure, bazy danych SQL w kopii zapasowej maszyny wirtualnej platformy Azure lub programu DPM do usługi Azure Backup. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja zwraca rekordy odnoszące się do wszystkich rozwiązań kopii zapasowych obsługiwanych przez raporty kopii zapasowej (obsługiwane wartości to "Kopia zapasowa maszyny wirtualnej platformy Azure", "SQL w usłudze Azure VM Backup", "SAP HANA w usłudze Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup", "Azure Blob Backup", "Azure Disk Backup" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| Nazwa grupy rozliczeniowej | Użyj tego parametru, aby wyszukać określoną grupę rozliczeń według nazwy. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje wszystkie grupy rozliczeniowe. | N | "testvm" | String |
Zwrócone pola
| Nazwa pola | Opis | Typ danych |
|---|---|---|
| UniqueId | Klucz podstawowy oznaczający unikatowy identyfikator grupy rozliczeniowej | String |
| FriendlyName | Przyjazna nazwa grupy rozliczeniowej | String |
| Nazwisko | Nazwa grupy rozliczeniowej | String |
| Typ | Typ grupy rozliczeniowej. Na przykład ProtectedContainer lub BackupItem | String |
| SourceSizeInMBs | Rozmiar frontonu grupy rozliczeniowej w mb/s | Liczba rzeczywista |
| VaultStore_StorageConsumptionInMBs | Łączna ilość miejsca do magazynowania w chmurze zużywana przez grupę rozliczeń w warstwie Standardowa magazynu | Liczba rzeczywista |
| Tworzenie kopii zapasowych | Rozwiązanie do tworzenia kopii zapasowych skojarzone z grupą rozliczeń. Na przykład kopia zapasowa maszyny wirtualnej platformy Azure, sql w usłudze Azure VM Backup itd. | String |
| VaultResourceId | Identyfikator usługi Azure Resource Manager (ARM) magazynu skojarzonego z grupą rozliczeń | String |
| VaultUniqueId | Klucz obcy odwołujący się do magazynu skojarzonego z grupą rozliczeń | String |
| VaultName | Nazwa magazynu skojarzonego z grupą rozliczeń | String |
| Tagi magazynu | Tagi magazynu skojarzonego z grupą rozliczeń | String |
| VaultSubscriptionId | Identyfikator subskrypcji magazynu skojarzonego z grupą rozliczeń | String |
| VaultLocation | Lokalizacja magazynu skojarzonego z grupą rozliczeń | String |
| VaultStore_StorageReplicationType | Typ replikacji magazynu skojarzonego z grupą rozliczeń | String |
| VaultType | Typ magazynu, na przykład "Microsoft.RecoveryServices/vaults" lub "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Sygnatura czasowa rekordu | DateTime |
| Właściwości rozszerzone | Dodatkowe właściwości grupy rozliczeniowej | Dynamiczny |
Funkcje trendu
_AzureBackup_GetBackupInstancesTrends()
Ta funkcja zwraca historyczne rekordy dla każdego wystąpienia kopii zapasowej, co pozwala wyświetlać kluczowe trendy dzienne, tygodniowe i miesięczne związane z liczbą wystąpień kopii zapasowych i zużyciem magazynu na wielu poziomach szczegółowości.
Parametry
| Nazwa parametru | Opis | Wymagane? | Przykładowa wartość | Typ danych |
|---|---|---|---|---|
| RangeStart | Użyj tego parametru wraz z parametrem RangeEnd, aby pobrać wszystkie rekordy powiązane z wystąpieniem kopii zapasowej w okresie od RangeStart do RangeEnd. | Y | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Użyj tego parametru wraz z parametrem RangeStart, aby pobrać wszystkie rekordy powiązane z wystąpieniem kopii zapasowej w okresie od RangeStart do RangeEnd. | Y | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu subskrypcji, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy identyfikatorów subskrypcji jako parametru tej funkcji ułatwia pobranie tylko tych wystąpień kopii zapasowych, które znajdują się w określonych subskrypcjach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich subskrypcjach. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu regionów, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy regionów jako parametru dla tej funkcji pomaga pobrać tylko te wystąpienia kopii zapasowych, które znajdują się w określonych regionach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich regionach. | N | eastus,westus |
String |
| VaultList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu magazynów. Określenie rozdzielanej przecinkami listy nazw magazynów jako parametru tej funkcji ułatwia pobieranie rekordów wystąpień kopii zapasowych odnoszących się tylko do określonych magazynów. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy wystąpień kopii zapasowych we wszystkich magazynach. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do rekordów odnoszących się do określonego typu magazynu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zarówno magazyny usługi Recovery Services, jak i magazyny usługi Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Użyj tego parametru, aby wybrać, czy wysyłać zapytania dotyczące danych w starszej tabeli AzureDiagnostics, czy nie. Jeśli wartość tego parametru jest fałsz, funkcja wykonuje zapytania dotyczące danych zarówno z tabeli AzureDiagnostics, jak i tabel specyficznych dla zasobu. Jeśli wartość tego parametru ma wartość true, funkcja wysyła zapytania do danych tylko z tabel specyficznych dla zasobu. Domyślna wartość to true. | N | prawda | Wartość logiczna |
| BackupSolutionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu rozwiązań do tworzenia kopii zapasowych używanych w środowisku platformy Azure. Jeśli na przykład określisz Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM wartość tego parametru, funkcja zwraca tylko rekordy powiązane z elementami kopii zapasowych przy użyciu kopii zapasowej maszyny wirtualnej platformy Azure, bazy danych SQL w kopii zapasowej maszyny wirtualnej platformy Azure lub programu DPM do usługi Azure Backup. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja zwraca rekordy odnoszące się do wszystkich rozwiązań kopii zapasowych obsługiwanych przez raporty kopii zapasowej (obsługiwane wartości to "Kopia zapasowa maszyny wirtualnej platformy Azure", "SQL w usłudze Azure VM Backup", "SAP HANA w usłudze Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup", "Azure Blob Backup", "Azure Disk Backup" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Użyj tego parametru, aby wybrać, czy uwzględnić tylko te wystąpienia kopii zapasowej, które są aktywnie chronione, czy też uwzględnić te wystąpienia, dla których ochrona została zatrzymana, a wystąpienia, dla których oczekuje początkowa kopia zapasowa. W przypadku obciążeń magazynu usługi Recovery Services obsługiwane wartości to "Protected", "ProtectionStopped", "InitialBackupPending" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości. W przypadku obciążeń magazynu kopii zapasowych obsługiwane wartości to "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje wszystkie wystąpienia kopii zapasowej niezależnie od szczegółów ochrony. | N | "Chronione" | String |
| DatasourceSetName | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do określonego zasobu nadrzędnego. Aby na przykład zwrócić sql w wystąpieniach kopii zapasowej maszyny wirtualnej platformy Azure należących do maszyny wirtualnej "testvm", określ parametr testvm jako wartość tego parametru. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich wystąpieniach kopii zapasowych. | N | "testvm" | String |
| BackupInstanceName | Użyj tego parametru, aby wyszukać określone wystąpienie kopii zapasowej według nazwy. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje wszystkie wystąpienia kopii zapasowej. | N | "testvm" | String |
| DisplayAllFields | Użyj tego parametru, aby wybrać, czy pobierać tylko podzbiór pól zwracanych przez funkcję. Jeśli wartość tego parametru jest fałszywa, funkcja eliminuje informacje związane z magazynem i punktem przechowywania z danych wyjściowych funkcji. Jest to przydatne, jeśli używasz tej funkcji jako pośredniego kroku w większym zapytaniu i musisz zoptymalizować wydajność zapytania, eliminując kolumny, które nie są wymagane do analizy. Domyślnie wartość tego parametru jest prawdziwa, co sprawia, że funkcja zwraca wszystkie pola odnoszące się do wystąpienia kopii zapasowej. | N | prawda | Wartość logiczna |
| Typ agregacji | Użyj tego parametru, aby określić stopień szczegółowości czasu pobierania danych. Jeśli wartość tego parametru to "Daily", funkcja zwraca rekord na wystąpienie kopii zapasowej dziennie, umożliwiając analizowanie codziennych trendów zużycia magazynu i liczby wystąpień kopii zapasowych. Jeśli wartość tego parametru to "Weekly", funkcja zwraca rekord na wystąpienie kopii zapasowej tygodniowo, co umożliwia analizowanie trendów tygodniowych. Podobnie możesz określić "Co miesiąc", aby analizować miesięczne trendy. Wartość domyślna to "Daily". Jeśli wyświetlasz dane w większych zakresach czasu, zaleca się użycie opcji "Co tydzień" lub "Co miesiąc", aby uzyskać lepszą wydajność zapytań i łatwość analizy trendów. | N | "Co tydzień" | String |
Zwrócone pola
| Nazwa pola | Opis | Typ danych |
|---|---|---|
| UniqueId | Klucz podstawowy oznaczający unikatowy identyfikator wystąpienia kopii zapasowej | String |
| Id | Identyfikator usługi Azure Resource Manager (ARM) wystąpienia kopii zapasowej | String |
| FriendlyName | Przyjazna nazwa wystąpienia kopii zapasowej | String |
| ProtectionInfo | Informacje o ustawieniach ochrony wystąpienia kopii zapasowej. Na przykład ochrona jest skonfigurowana, ochrona zatrzymana, oczekiwanie na początkową kopię zapasową | String |
| LatestRecoveryPoint | Data i godzina najnowszego punktu odzyskiwania skojarzonego z wystąpieniem kopii zapasowej. Obecnie to pole jest obsługiwane tylko w przypadku obciążeń magazynu usługi Recovery Services | DateTime |
| Najstarszy punktrecoveryPoint | Data i godzina najstarszego punktu odzyskiwania skojarzonego z wystąpieniem kopii zapasowej | Obecnie to pole jest obsługiwane tylko w przypadku obciążeń magazynu usługi Recovery Services |
| SourceSizeInMBs | Rozmiar frontonu wystąpienia kopii zapasowej w mb/s | Liczba rzeczywista |
| VaultStore_StorageConsumptionInMBs | Łączna ilość miejsca do magazynowania w chmurze zużywanego przez wystąpienie kopii zapasowej w warstwie Standardowa magazynu | Liczba rzeczywista |
| DataSourceFriendlyName | Przyjazna nazwa źródła danych odpowiadającego wystąpieniu kopii zapasowej | String |
| Tworzenie kopii zapasowych | Rozwiązanie do tworzenia kopii zapasowych skojarzone z wystąpieniem kopii zapasowej. Na przykład kopia zapasowa maszyny wirtualnej platformy Azure, sql w usłudze Azure VM Backup itd. | String |
| Typ źródła danych | Typ źródła danych odpowiadającego wystąpieniu kopii zapasowej. Na przykład "Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | Identyfikator usługi Azure Resource Manager (ARM) bazowego źródła danych odpowiadającego wystąpieniu kopii zapasowej. Na przykład identyfikator usługi Azure Resource Manager (ARM) maszyny wirtualnej | String |
| DatasourceSetFriendlyName | Przyjazna nazwa zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku usługi SQL w źródle danych maszyny wirtualnej platformy Azure to pole będzie zawierać nazwę maszyny wirtualnej, w której istnieje baza danych SQL Database | String |
| DatasourceSetResourceId | Identyfikator usługi Azure Resource Manager (ARM) zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku źródła danych sql na maszynie wirtualnej platformy Azure to pole będzie zawierać identyfikator usługi Azure Resource Manager (ARM) maszyny wirtualnej, w której istnieje baza danych SQL | String |
| Typ źródła danych | Typ zasobu nadrzędnego źródła danych (wszędzie tam, gdzie ma to zastosowanie). Na przykład w przypadku platformy SAP HANA w źródle danych maszyny wirtualnej platformy Azure to pole Microsoft.Compute/virtualMachines, ponieważ zasób nadrzędny jest maszyną wirtualną platformy Azure | String |
| PolicyName | Nazwa zasad skojarzonych z wystąpieniem kopii zapasowej | String |
| PolicyUniqueId | Klucz obcy odwołujący się do zasad skojarzonych z wystąpieniem kopii zapasowej | String |
| IdentZasady | Identyfikator usługi Azure Resource Manager (ARM) zasad skojarzonych z wystąpieniem kopii zapasowej | String |
| VaultResourceId | Identyfikator usługi Azure Resource Manager (ARM) magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultUniqueId | Klucz obcy odwołujący się do magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultName | Nazwa magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| Tagi magazynu | Tagi magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultSubscriptionId | Identyfikator subskrypcji magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultLocation | Lokalizacja magazynu skojarzonego z wystąpieniem kopii zapasowej | String |
| VaultStore_StorageReplicationType | Typ replikacji magazynu skojarzony z wystąpieniem kopii zapasowej | String |
| VaultType | Typ magazynu, na przykład "Microsoft.RecoveryServices/vaults" lub "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Sygnatura czasowa rekordu | DateTime |
_AzureBackup_GetBillingGroupsTrends()
Ta funkcja zwraca historyczne rekordy dla każdej jednostki rozliczeniowej, co pozwala wyświetlać kluczowe trendy dzienne, tygodniowe i miesięczne związane z rozmiarem i zużyciem magazynu frontonu na wielu poziomach szczegółowości.
Parametry
| Nazwa parametru | Opis | Wymagane? | Przykładowa wartość | Typ danych |
|---|---|---|---|---|
| RangeStart | Użyj tego parametru wraz z parametrem RangeEnd, aby pobrać wszystkie rekordy powiązane z grupami rozliczeniowymi w okresie od RangeStart do RangeEnd. | Y | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Użyj tego parametru wraz z parametrem RangeStart, aby pobrać wszystkie rekordy powiązane z grupami rozliczeniowymi w okresie od RangeStart do RangeEnd. | Y | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu subskrypcji, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy identyfikatorów subskrypcji jako parametru tej funkcji ułatwia pobranie tylko tych grup rozliczeniowych, które znajdują się w określonych subskrypcjach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich subskrypcjach. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu regionów, w których istnieją dane kopii zapasowej. Określenie rozdzielanej przecinkami listy regionów jako parametru dla tej funkcji pomaga pobrać tylko te grupy rozliczeniowe, które znajdują się w określonych regionach. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy we wszystkich regionach. | N | eastus,westus |
String |
| VaultList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu magazynów. Określenie rozdzielanej przecinkami listy nazw magazynów jako parametru tej funkcji ułatwia pobieranie rekordów wystąpień kopii zapasowych odnoszących się tylko do określonych magazynów. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje rekordy grup rozliczeniowych we wszystkich magazynach. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji do rekordów odnoszących się do określonego typu magazynu. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja wyszukuje zarówno magazyny usługi Recovery Services, jak i magazyny usługi Backup. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Użyj tego parametru, aby wybrać, czy wysyłać zapytania dotyczące danych w starszej tabeli AzureDiagnostics, czy nie. Jeśli wartość tego parametru jest fałsz, funkcja wykonuje zapytania dotyczące danych zarówno z tabeli AzureDiagnostics, jak i tabel specyficznych dla zasobu. Jeśli wartość tego parametru ma wartość true, funkcja wysyła zapytania do danych tylko z tabel specyficznych dla zasobu. Domyślna wartość to true. | N | prawda | Wartość logiczna |
| BackupSolutionList | Użyj tego parametru, aby filtrować dane wyjściowe funkcji dla określonego zestawu rozwiązań do tworzenia kopii zapasowych używanych w środowisku platformy Azure. Jeśli na przykład określisz Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM wartość tego parametru, funkcja zwraca tylko rekordy powiązane z elementami kopii zapasowych przy użyciu kopii zapasowej maszyny wirtualnej platformy Azure, bazy danych SQL w kopii zapasowej maszyny wirtualnej platformy Azure lub programu DPM do usługi Azure Backup. Domyślnie wartość tego parametru to "*", co sprawia, że funkcja zwraca rekordy odnoszące się do wszystkich rozwiązań kopii zapasowych obsługiwanych przez raporty kopii zapasowej (obsługiwane wartości to "Kopia zapasowa maszyny wirtualnej platformy Azure", "SQL w usłudze Azure VM Backup", "SAP HANA w usłudze Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup", "Azure Blob Backup", "Azure Disk Backup" lub rozdzielona przecinkami kombinacja dowolnej z tych wartości). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| Nazwa grupy rozliczeniowej | Użyj tego parametru, aby wyszukać określoną grupę rozliczeń według nazwy. Domyślnie wartość to "*", co sprawia, że funkcja wyszukuje wszystkie grupy rozliczeniowe. | N | "testvm" | String |
| Typ agregacji | Użyj tego parametru, aby określić stopień szczegółowości czasu pobierania danych. Jeśli wartość tego parametru to "Daily", funkcja zwraca rekord na grupę rozliczeń dziennie, umożliwiając analizowanie codziennych trendów zużycia magazynu i rozmiaru frontonu. Jeśli wartość tego parametru to "Weekly", funkcja zwraca rekord na wystąpienie kopii zapasowej tygodniowo, co umożliwia analizowanie trendów tygodniowych. Podobnie możesz określić "Co miesiąc", aby analizować miesięczne trendy. Wartość domyślna to "Daily". Jeśli wyświetlasz dane w większych zakresach czasu, zaleca się użycie opcji "Co tydzień" lub "Co miesiąc", aby uzyskać lepszą wydajność zapytań i łatwość analizy trendów. | N | "Co tydzień" | String |
Zwrócone pola
| Nazwa pola | Opis | Typ danych |
|---|---|---|
| UniqueId | Klucz podstawowy oznaczający unikatowy identyfikator grupy rozliczeniowej | String |
| FriendlyName | Przyjazna nazwa grupy rozliczeniowej | String |
| Nazwisko | Nazwa grupy rozliczeniowej | String |
| Typ | Typ grupy rozliczeniowej. Na przykład ProtectedContainer lub BackupItem | String |
| SourceSizeInMBs | Rozmiar frontonu grupy rozliczeniowej w mb/s | Liczba rzeczywista |
| VaultStore_StorageConsumptionInMBs | Łączna ilość miejsca do magazynowania w chmurze zużywana przez grupę rozliczeń w warstwie Standardowa magazynu | Liczba rzeczywista |
| Tworzenie kopii zapasowych | Rozwiązanie do tworzenia kopii zapasowych skojarzone z grupą rozliczeń. Na przykład kopia zapasowa maszyny wirtualnej platformy Azure, sql w usłudze Azure VM Backup itd. | String |
| VaultResourceId | Identyfikator usługi Azure Resource Manager (ARM) magazynu skojarzonego z grupą rozliczeń | String |
| VaultUniqueId | Klucz obcy odwołujący się do magazynu skojarzonego z grupą rozliczeń | String |
| VaultName | Nazwa magazynu skojarzonego z grupą rozliczeń | String |
| Tagi magazynu | Tagi magazynu skojarzonego z grupą rozliczeń | String |
| VaultSubscriptionId | Identyfikator subskrypcji magazynu skojarzonego z grupą rozliczeń | String |
| VaultLocation | Lokalizacja magazynu skojarzonego z grupą rozliczeń | String |
| VaultStore_StorageReplicationType | Typ replikacji magazynu skojarzonego z grupą rozliczeń | String |
| VaultType | Typ magazynu, na przykład "Microsoft.RecoveryServices/vaults" lub "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Sygnatura czasowa rekordu | DateTime |
| Właściwości rozszerzone | Dodatkowe właściwości grupy rozliczeniowej | Dynamiczny |
Przykładowe zapytania
Poniżej przedstawiono kilka przykładowych zapytań, które ułatwiają rozpoczęcie korzystania z funkcji systemowych.
Wszystkie nieudane zadania tworzenia kopii zapasowej maszyny wirtualnej platformy Azure w danym zakresie czasu
_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=DataTransferredInMBsWszystkie zadania tworzenia kopii zapasowej dziennika SQL w danym zakresie czasu
_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=DataTransferredInMBsTygodniowy trend używanego magazynu kopii zapasowych dla maszyny wirtualnej "testvm"
_AzureBackup_GetBackupInstancesTrends("2021-01-01", "2021-03-06","*","*","*","*",false,"*","*","*","*",true, "Weekly") //call function with RangeStart and RangeEnd parameters set, AggregationType parameter as Weekly, and other parameters with default value | where BackupSolution == "Azure Virtual Machine Backup" | where FriendlyName == "testvm" | project TimeGenerated, VaultStore_StorageConsumptionInMBs | render timechart