Funções do sistema nos Logs do Azure Monitor
Este artigo descreve como escrever consultas personalizadas nos Logs do Azure Monitor usando funções do sistema.
O Backup do Azure fornece um conjunto de funções, chamadas funções do sistema ou funções de solução, que estão disponíveis por padrão em seus espaços de trabalho do Log Analytics (LA).
Essas funções operam em dados nas tabelas brutas do Backup do Azure em LA e retornam dados formatados que ajudam você a recuperar facilmente informações de todas as suas entidades relacionadas ao backup, usando consultas simples. Os usuários podem passar parâmetros para essas funções para filtrar os dados que são retornados por essas funções.
Recomendamos que você use funções do sistema para consultar seus dados de backup em espaços de trabalho LA para criar relatórios personalizados, pois eles fornecem uma série de benefícios, conforme detalhado na seção abaixo.
Benefícios do uso de funções do sistema
Consultas mais simples: o uso de funções ajuda a reduzir o número de junções necessárias em suas consultas. Por padrão, as funções retornam esquemas 'nivelados' que incorporam todas as informações pertencentes à entidade (instância de backup, trabalho, cofre e assim por diante) que está sendo consultada. Por exemplo, se você precisar obter uma lista de trabalhos de backup bem-sucedidos por nome de item de backup e seu contêiner associado, uma simples chamada para a função _AzureBackup_getJobs() fornecerá todas essas informações para cada trabalho. Por outro lado, consultar as tabelas brutas diretamente exigiria que você executasse várias junções entre as tabelas AddonAzureBackupJobs e CoreAzureBackup .
Transição mais suave do evento de diagnóstico herdado: o uso de funções do sistema ajuda a fazer a transição suave do evento de diagnóstico herdado (AzureBackupReport no modo AzureDiagnostics) para os eventos específicos do recurso. Todas as funções do sistema fornecidas pelo Backup do Azure permitem especificar um parâmetro que permite escolher se a função deve consultar dados somente das tabelas específicas de recursos ou consultar dados da tabela herdada e das tabelas específicas de recursos (com desduplicação de registros).
- Se você tiver migrado com êxito para as tabelas específicas de recursos, poderá optar por excluir a tabela herdada de ser consultada pela função.
- Se você estiver atualmente no processo de migração e tiver alguns dados nas tabelas herdadas necessárias para análise, poderá optar por incluir a tabela herdada. Quando a transição estiver concluída e você não precisar mais de dados da tabela herdada, poderá atualizar o valor do parâmetro passado para a função em suas consultas, para excluir a tabela herdada.
- Se você ainda estiver usando apenas a tabela herdada, as funções ainda funcionarão se você optar por incluir a tabela herdada por meio do mesmo parâmetro. No entanto, recomenda-se alternar para as tabelas específicas de recursos o mais cedo possível.
Reduz a possibilidade de quebra de consultas personalizadas: se o Backup do Azure introduzir melhorias no esquema das tabelas de LA subjacentes para acomodar cenários de relatórios futuros, a definição das funções também será atualizada para levar em conta as alterações de esquema. Assim, se você usar funções do sistema para criar consultas personalizadas, suas consultas não serão quebradas, mesmo se houver alterações no esquema subjacente das tabelas.
Nota
As funções do sistema são mantidas pela Microsoft e suas definições não podem ser editadas pelos usuários. Se você precisar de funções editáveis, você pode criar funções salvas em LA.
Tipos de funções do sistema oferecidas pelo Backup do Azure
Funções principais: são funções que ajudam você a consultar qualquer uma das principais entidades do Backup do Azure, como instâncias de backup, cofres, políticas, trabalhos e entidades de cobrança. Por exemplo, a função _AzureBackup_getBackupInstances retorna uma lista de todas as instâncias de backup existentes em seu ambiente a partir do último dia concluído (em UTC). Os parâmetros e o esquema retornado para cada uma dessas funções principais são resumidos abaixo neste artigo.
Funções de tendência: são funções que retornam registros históricos para suas entidades relacionadas ao backup (por exemplo, instâncias de backup, grupos de cobrança) e permitem que você obtenha informações de tendência diárias, semanais e mensais sobre as principais métricas (por exemplo, Contagem, Armazenamento consumido) pertencentes a essas entidades. Os parâmetros e o esquema retornado para cada uma dessas funções de tendência são resumidos abaixo neste artigo.
Nota
Atualmente, as funções do sistema retornam dados até o último dia concluído (em UTC). Os dados do dia parcial atual não são retornados. Portanto, se você estiver procurando recuperar registros para o dia atual, precisará usar as tabelas de LA brutas.
Lista de funções do sistema
Funções principais
_AzureBackup_GetVaults()
Essa função retorna a lista de todos os cofres dos Serviços de Recuperação em seu ambiente do Azure associados ao espaço de trabalho LA.
Parâmetros
| Nome do parâmetro | Descrição | Necessário? | Valor de exemplo | Tipo de dados |
|---|---|---|---|---|
| RangeStart | Use esse parâmetro junto com o parâmetro RangeEnd somente se precisar buscar todos os registros relacionados ao vault no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada cofre. | N | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Use esse parâmetro junto com o parâmetro RangeStart somente se precisar buscar todos os registros relacionados ao vault no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada cofre. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de assinaturas onde existem dados de backup. Especificar uma lista separada por vírgulas de IDs de assinatura como um parâmetro para essa função ajuda você a recuperar apenas os cofres que estão nas assinaturas especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as assinaturas. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de regiões onde existem dados de backup. Especificar uma lista de regiões separadas por vírgulas como um parâmetro para essa função ajuda a recuperar apenas os cofres que estão nas regiões especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as regiões. | N | eastus,westus |
String |
| VaultList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de cofres. Especificar uma lista separada por vírgulas de nomes de cofres como um parâmetro para essa função ajuda a recuperar registros pertencentes apenas aos cofres especificados. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todos os cofres. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Use este parâmetro para filtrar a saída da função para registros pertencentes a um tipo de cofre específico. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure os cofres dos Serviços de Recuperação e os cofres de backup. | N | "Microsoft.RecoveryServices/cofres" | String |
| ExcludeLegacyEvent | Use esse parâmetro para escolher se deseja consultar dados na tabela AzureDiagnostics herdada ou não. Se o valor desse parâmetro for false, a função consultará dados da tabela AzureDiagnostics e das tabelas específicas do recurso. Se o valor desse parâmetro for true, a função consultará dados somente das tabelas específicas do recurso. O valor predefinido é verdadeiro. | N | verdadeiro | Boolean |
Campos devolvidos
| Nome do campo | Descrição | Tipo de dados |
|---|---|---|
| UniqueId | Chave primária que indica ID exclusivo do cofre | String |
| Id | ID do Azure Resource Manager (ARM) do cofre | String |
| Nome | Nome do cofre | String |
| SubscriptionId | ID da subscrição na qual o cofre existe | String |
| Location | Local em que o cofre existe | String |
| VaultStore_StorageReplicationType | Tipo de replicação de armazenamento associado ao vault | String |
| Etiquetas | Tags do cofre | String |
| TimeGenerated | Carimbo de data/hora do registo | DateTime |
| Type | Tipo de cofre, por exemplo, "Microsoft.RecoveryServices/vaults" ou "Microsoft.DataProtection/backupVaults" | String |
_AzureBackup_GetPolicies()
Essa função retorna a lista de políticas de backup que estão sendo usadas em seu ambiente do Azure, juntamente com informações detalhadas sobre cada política, como o tipo de fonte de dados, o tipo de replicação de armazenamento e assim por diante.
Parâmetros
| Nome do parâmetro | Descrição | Necessário? | Valor de exemplo | Tipo de dados |
|---|---|---|---|---|
| RangeStart | Use esse parâmetro junto com o parâmetro RangeStart somente se precisar buscar todos os registros relacionados à política no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada política. | N | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Use esse parâmetro junto com o parâmetro RangeStart somente se precisar buscar todos os registros relacionados à política no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada política. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de assinaturas onde existem dados de backup. Especificar uma lista separada por vírgulas de IDs de assinatura como um parâmetro para essa função ajuda você a recuperar apenas as políticas que estão nas assinaturas especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as assinaturas. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de regiões onde existem dados de backup. Especificar uma lista de regiões separadas por vírgulas como um parâmetro para essa função ajuda a recuperar apenas as políticas que estão nas regiões especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as regiões. | N | eastus,westus |
String |
| VaultList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de cofres. Especificar uma lista separada por vírgulas de nomes de cofres como um parâmetro para essa função ajuda a recuperar registros de políticas pertencentes apenas aos cofres especificados. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros de políticas em todos os cofres. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Use este parâmetro para filtrar a saída da função para registros pertencentes a um tipo de cofre específico. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure os cofres dos Serviços de Recuperação e os cofres de backup. | N | "Microsoft.RecoveryServices/cofres" | String |
| ExcludeLegacyEvent | Use esse parâmetro para escolher se deseja consultar dados na tabela AzureDiagnostics herdada ou não. Se o valor desse parâmetro for false, a função consultará dados da tabela AzureDiagnostics e das tabelas específicas do recurso. Se o valor desse parâmetro for true, a função consultará dados somente das tabelas específicas do recurso. O valor predefinido é verdadeiro. | N | verdadeiro | Boolean |
| BackupSolutionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de soluções de backup usadas em seu ambiente do Azure. Por exemplo, se você especificar Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM como o valor desse parâmetro, a função retornará somente registros relacionados a itens cujo backup foi feito usando o backup da Máquina Virtual do Azure, o backup do SQL na VM do Azure ou o backup do DPM para o Azure. Por padrão, o valor desse parâmetro é '*', o que faz com que a função retorne registros pertencentes a todas as soluções de backup suportadas pelos Relatórios de Backup (os valores suportados são "Backup de Máquina Virtual do Azure", "SQL no Backup de VM do Azure", "SAP HANA no Backup de VM do Azure", "Backup do Armazenamento do Azure (Arquivos do Azure)", "Agente de Backup do Azure", "DPM", "Servidor de Backup do Azure", "Banco de Dados do Azure para Backup do Servidor PostgreSQL", "Backup de Blob do Azure", "Backup de Disco do Azure" ou uma combinação separada por vírgulas de qualquer um desses valores). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
Campos devolvidos
| Nome do campo | Descrição | **Tipo de dados ** |
|---|---|---|
| UniqueId | Chave primária que indica ID exclusivo da política | String |
| Id | ID do Azure Resource Manager (ARM) da política | String |
| Nome | Nome da política | String |
| TimeZone | Fuso horário no qual a política é definida | String |
| Solução de backup | Solução de backup à qual a política está associada. Por exemplo, Backup de VM do Azure, SQL no Backup de VM do Azure e assim por diante. | String |
| TimeGenerated | Carimbo de data/hora do registo | Datetime |
| VaultUniqueId | Chave estrangeira que se refere ao cofre associado à política | String |
| VaultResourceId | ID do Azure Resource Manager (ARM) do cofre associado à política | String |
| Nome do cofre | Nome do cofre associado à política | String |
| VaultTags | Tags do cofre associadas à política | String |
| Localização do cofre | Localização do cofre associado à política | String |
| VaultSubscriptionId | ID de subscrição do cofre associado à política | String |
| VaultStore_StorageReplicationType | Tipo de replicação de armazenamento do cofre associado à política | String |
| Tipo de cofre | Tipo de cofre, por exemplo, "Microsoft.RecoveryServices/vaults" ou "Microsoft.DataProtection/backupVaults" | String |
| ExtendedProperties | Propriedades adicionais da política | Dinâmica |
_AzureBackup_GetJobs()
Essa função retorna uma lista de todos os trabalhos relacionados a backup e restauração que foram acionados em um intervalo de tempo especificado, juntamente com informações detalhadas sobre cada trabalho, como status do trabalho, duração do trabalho, dados transferidos e assim por diante.
Parâmetros
| Nome do parâmetro | Descrição | Necessário? | Valor de exemplo | **Tipo de dados ** |
|---|---|---|---|---|
| RangeStart | Use esse parâmetro junto com o parâmetro RangeEnd para recuperar a lista de todos os trabalhos iniciados no período de tempo de RangeStart a RangeEnd. | Y | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Use esse parâmetro junto com o parâmetro RangeStart para recuperar a lista de todos os trabalhos iniciados no período de tempo de RangeStart a RangeEnd. | Y | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de assinaturas onde existem dados de backup. Especificar uma lista separada por vírgulas de IDs de assinatura como um parâmetro para essa função ajuda você a recuperar apenas os trabalhos associados a cofres nas assinaturas especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as assinaturas. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de regiões onde existem dados de backup. Especificar uma lista de regiões separadas por vírgulas como um parâmetro para essa função ajuda a recuperar apenas os trabalhos associados a cofres nas regiões especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as regiões. | N | eastus,westus |
String |
| VaultList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de cofres. Especificar uma lista separada por vírgulas de nomes de cofres como um parâmetro para essa função ajuda a recuperar trabalhos pertencentes apenas aos cofres especificados. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure trabalhos em todos os cofres. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Use este parâmetro para filtrar a saída da função para registros pertencentes a um tipo de cofre específico. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure os cofres dos Serviços de Recuperação e os cofres de backup. | N | "Microsoft.RecoveryServices/cofres" | String |
| ExcludeLegacyEvent | Use esse parâmetro para escolher se deseja consultar dados na tabela AzureDiagnostics herdada ou não. Se o valor desse parâmetro for false, a função consultará dados da tabela AzureDiagnostics e das tabelas específicas do recurso. Se o valor desse parâmetro for true, a função consultará dados somente das tabelas específicas do recurso. O valor predefinido é verdadeiro. | N | verdadeiro | Boolean |
| BackupSolutionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de soluções de backup usadas em seu ambiente do Azure. Por exemplo, se você especificar Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM como o valor desse parâmetro, a função retornará somente registros relacionados a itens cujo backup foi feito usando o backup da Máquina Virtual do Azure, o backup do SQL na VM do Azure ou o backup do DPM para o Azure. Por padrão, o valor desse parâmetro é '*', o que faz com que a função retorne registros pertencentes a todas as soluções de backup suportadas pelos Relatórios de Backup (os valores suportados são "Backup de Máquina Virtual do Azure", "SQL no Backup de VM do Azure", "SAP HANA no Backup de VM do Azure", "Backup do Armazenamento do Azure (Arquivos do Azure)", "Agente de Backup do Azure", "DPM", "Servidor de Backup do Azure", "Banco de Dados do Azure para Backup do Servidor PostgreSQL", "Backup de Blob do Azure", "Backup de Disco do Azure" ou uma combinação separada por vírgulas de qualquer um desses valores). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| JobOperationList | Use este parâmetro para filtrar a saída da função para um tipo específico de trabalho. Por exemplo, as operações de backup ou restauração. Por padrão, o valor desse parâmetro é "*", o que faz com que a função procure trabalhos de Backup e Restauração. | N | "Cópia de segurança" | String |
| JobStatusList | Use este parâmetro para filtrar a saída da função para um status de trabalho específico. Por exemplo, Concluído, Reprovado e assim por diante. Por padrão, o valor desse parâmetro é "*", o que faz com que a função procure todos os empregos, independentemente do status. | N | Failed,CompletedWithWarnings |
String |
| JobFailureCodeList | Use este parâmetro para filtrar a saída da função para um código de falha específico. Por padrão, o valor desse parâmetro é "*", o que faz com que a função procure todos os trabalhos, independentemente do código de falha. | N | "Sucesso" | String |
| DatasourceSetName | Use este parâmetro para filtrar a saída da função para um recurso pai específico. Por exemplo, para retornar SQL em instâncias de backup de VM do Azure pertencentes à máquina virtual "testvm", especifique testvm como o valor desse parâmetro. Por padrão, o valor é "*", o que faz com que a função procure registros em todas as instâncias de backup. | N | "Testvm" | String |
| BackupInstanceName | Use esse parâmetro para procurar trabalhos em uma instância de backup específica pelo nome. Por padrão, o valor é "*", o que faz com que a função procure registros em todas as instâncias de backup. | N | "Testvm" | String |
| ExcludeLog | Use esse parâmetro para excluir trabalhos de log de serem retornados pela função (ajuda no desempenho da consulta). Por padrão, o valor desse parâmetro é true, o que faz com que a função exclua trabalhos de log. | N | verdadeiro | Boolean |
Campos devolvidos
| Nome do campo | Descrição | **Tipo de dados ** |
|---|---|---|
| UniqueId | Chave primária que indica ID exclusivo do trabalho | String |
| OperaçãoCategoria | Categoria da operação a ser executada. Por exemplo, Backup, Restore | String |
| Operação | Detalhes da operação que está sendo executada. Por exemplo, Log (para backup de log) | String |
| Status | Situação do trabalho. Por exemplo, Completed, Failed, CompletedWithWarnings | String |
| ErrorTitle | Código de falha do trabalho | String |
| StartTime | Data e hora em que o trabalho começou | DateTime |
| DurationInSecs | Duração do trabalho em segundos | Duplo |
| DataTransferredInMBs | Dados transferidos pelo trabalho em MBs. Atualmente, esse campo só é suportado para cargas de trabalho do cofre dos Serviços de Recuperação | Duplo |
| RestoreJobRPDateTime | A data e a hora em que o ponto de recuperação que está sendo recuperado foi criado. Atualmente, esse campo só é suportado para cargas de trabalho do cofre dos Serviços de Recuperação | DateTime |
| RestoreJobRPLocation | O local onde o ponto de recuperação que está sendo recuperado foi armazenado | String |
| BackupInstanceUniqueId | Chave estrangeira que se refere à instância de backup associada ao trabalho | String |
| BackupInstanceId | ID do Azure Resource Manager (ARM) da instância de backup associada ao trabalho | String |
| BackupInstanceFriendlyName | Nome da instância de backup associada ao trabalho | String |
| DatasourceResourceId | ID do Azure Resource Manager (ARM) da fonte de dados subjacente associada ao trabalho. Por exemplo, a ID do Azure Resource Manager (ARM) da VM | String |
| DatasourceFriendlyName | Nome amigável da fonte de dados subjacente associada ao trabalho | String |
| DatasourceType | Tipo da fonte de dados associada ao trabalho. Por exemplo, "Microsoft.Compute/virtualMachines" | String |
| Solução de backup | Solução de backup à qual o trabalho está associado. Por exemplo, Backup de VM do Azure, SQL no Backup de VM do Azure e assim por diante. | String |
| DatasourceSetResourceId | ID do Azure Resource Manager (ARM) do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SQL na VM do Azure, esse campo conterá a ID do Azure Resource Manager (ARM) da VM na qual o Banco de Dados SQL existe | String |
| DatasourceSetType | Tipo do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SAP HANA na VM do Azure, esse campo será Microsoft.Compute/virtualMachines, já que o recurso pai é uma VM do Azure | String |
| VaultResourceId | ID do Azure Resource Manager (ARM) do cofre associado ao trabalho | String |
| VaultUniqueId | Chave estrangeira que se refere ao cofre associado ao trabalho | String |
| Nome do cofre | Nome do cofre associado ao trabalho | String |
| VaultTags | Tags do cofre associadas ao trabalho | String |
| VaultSubscriptionId | ID de assinatura do cofre associado ao trabalho | String |
| Localização do cofre | Localização do cofre associado ao trabalho | String |
| VaultStore_StorageReplicationType | Tipo de replicação de armazenamento do cofre associado ao trabalho | String |
| Tipo de cofre | Tipo de cofre, por exemplo, "Microsoft.RecoveryServices/vaults" ou "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Carimbo de data/hora do registo | DateTime |
_AzureBackup_GetBackupInstances()
Essa função retorna a lista de instâncias de backup associadas aos cofres dos Serviços de Recuperação, juntamente com informações detalhadas sobre cada instância de backup, como consumo de armazenamento em nuvem, política associada e assim por diante.
Parâmetros
| Nome do parâmetro | Descrição | Necessário? | Valor de exemplo | **Tipo de dados ** |
|---|---|---|---|---|
| RangeStart | Use esse parâmetro junto com o parâmetro RangeEnd somente se precisar buscar todos os registros relacionados à instância de backup no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada instância de backup. | N | "2021-03-03 00:00:00" | DataTime |
| RangeEnd | Use esse parâmetro junto com o parâmetro RangeStart somente se precisar buscar todos os registros relacionados à instância de backup no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada instância de backup. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de assinaturas onde existem dados de backup. Especificar uma lista separada por vírgulas de IDs de assinatura como um parâmetro para essa função ajuda você a recuperar apenas as instâncias de backup que estão nas assinaturas especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as assinaturas. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de regiões onde existem dados de backup. Especificar uma lista de regiões separadas por vírgulas como um parâmetro para essa função ajuda a recuperar apenas as instâncias de backup que estão nas regiões especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as regiões. | N | eastus,westus |
String |
| VaultList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de cofres. Especificar uma lista separada por vírgulas de nomes de cofres como um parâmetro para essa função ajuda a recuperar registros de instâncias de backup pertencentes apenas aos cofres especificados. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros de instâncias de backup em todos os cofres. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Use este parâmetro para filtrar a saída da função para registros pertencentes a um tipo de cofre específico. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure os cofres dos Serviços de Recuperação e os cofres de backup. | N | "Microsoft.RecoveryServices/cofres" | String |
| ExcludeLegacyEvent | Use esse parâmetro para escolher se deseja consultar dados na tabela AzureDiagnostics herdada ou não. Se o valor desse parâmetro for false, a função consultará dados da tabela AzureDiagnostics e das tabelas específicas do recurso. Se o valor desse parâmetro for true, a função consultará dados somente das tabelas específicas do recurso. O valor predefinido é verdadeiro. | N | verdadeiro | Boolean |
| BackupSolutionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de soluções de backup usadas em seu ambiente do Azure. Por exemplo, se você especificar Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM como o valor desse parâmetro, a função retornará somente registros relacionados a itens cujo backup foi feito usando o backup da Máquina Virtual do Azure, o backup do SQL na VM do Azure ou o backup do DPM para o Azure. Por padrão, o valor desse parâmetro é '*', o que faz com que a função retorne registros pertencentes a todas as soluções de backup suportadas pelos Relatórios de Backup (os valores suportados são "Backup de Máquina Virtual do Azure", "SQL no Backup de VM do Azure", "SAP HANA no Backup de VM do Azure", "Backup do Armazenamento do Azure (Arquivos do Azure)", "Agente de Backup do Azure", "DPM", "Servidor de Backup do Azure", "Banco de Dados do Azure para Backup do Servidor PostgreSQL", "Backup de Blob do Azure", "Backup de Disco do Azure" ou uma combinação separada por vírgulas de qualquer um desses valores). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Use esse parâmetro para escolher se deseja incluir apenas as instâncias de backup que estão ativamente protegidas ou também as instâncias para as quais a proteção foi interrompida e as instâncias para as quais o backup inicial está pendente. Para cargas de trabalho do vault de serviços de recuperação, os valores suportados são "Protected", "ProtectionStopped", "InitialBackupPending" ou uma combinação separada por vírgulas de qualquer um desses valores. Para cargas de trabalho do cofre de backup, os valores suportados são "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" ou uma combinação separada por vírgulas de qualquer um desses valores. Por padrão, o valor é "*", o que faz com que a função procure todas as instâncias de backup, independentemente dos detalhes de proteção. | N | "Protegido" | String |
| DatasourceSetName | Use este parâmetro para filtrar a saída da função para um recurso pai específico. Por exemplo, para retornar SQL em instâncias de backup de VM do Azure pertencentes à máquina virtual "testvm", especifique testvm como o valor desse parâmetro. Por padrão, o valor é "*", o que faz com que a função procure registros em todas as instâncias de backup. | N | "Testvm" | String |
| BackupInstanceName | Use esse parâmetro para pesquisar uma instância de backup específica pelo nome. Por padrão, o valor é "*", o que faz com que a função procure todas as instâncias de backup. | N | "Testvm" | String |
| DisplayAllFields | Use esse parâmetro para escolher se deseja recuperar apenas um subconjunto dos campos retornados pela função. Se o valor desse parâmetro for false, a função eliminará informações relacionadas ao armazenamento e ao ponto de retenção da saída da função. Isso é útil se você estiver usando essa função como uma etapa intermediária em uma consulta maior e precisar otimizar o desempenho da consulta eliminando colunas que não são necessárias para análise. Por padrão, o valor desse parâmetro é true, o que faz com que a função retorne todos os campos pertencentes à instância de backup. | N | verdadeiro | Boolean |
Campos devolvidos
| Nome do campo | Descrição | Tipo de dados |
|---|---|---|
| UniqueId | Chave primária que indica ID exclusivo da instância de backup | String |
| Id | ID do Azure Resource Manager (ARM) da instância de backup | String |
| FriendlyName | Nome amigável da instância de backup | String |
| ProtectionInfo | Informações sobre as configurações de proteção da instância de backup. Por exemplo, a proteção está configurada, a proteção interrompida, o backup inicial pendente | String |
| LatestRecoveryPoint | Data e hora do ponto de recuperação mais recente associado à instância de backup. Atualmente, esse campo só é suportado para cargas de trabalho do cofre dos Serviços de Recuperação. | DateTime |
| OldestRecoveryPoint | Data e hora do ponto de recuperação mais antigo associado à instância de backup. Atualmente, esse campo só é suportado para cargas de trabalho do cofre dos Serviços de Recuperação. | DateTime |
| SourceSizeInMBs | Tamanho do front-end da instância de backup em MBs | Duplo |
| VaultStore_StorageConsumptionInMBs | Total de armazenamento na nuvem consumido pela instância de backup na camada padrão do vault | Duplo |
| DataSourceFriendlyName | Nome amigável da fonte de dados correspondente à instância de backup | String |
| Solução de backup | Solução de backup à qual a instância de backup está associada. Por exemplo, Backup de VM do Azure, SQL no Backup de VM do Azure e assim por diante. | String |
| DatasourceType | Tipo da fonte de dados correspondente à instância de backup. Por exemplo, "Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | ID do Azure Resource Manager (ARM) da fonte de dados subjacente correspondente à instância de backup. Por exemplo, a ID do Azure Resource Manager (ARM) da VM | String |
| DatasourceSetFriendlyName | Nome amigável do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SQL na VM do Azure, esse campo conterá o nome da VM na qual o Banco de Dados SQL existe | String |
| DatasourceSetFriendlyName | Nome amigável do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SQL na VM do Azure, esse campo conterá o nome da VM na qual o Banco de Dados SQL existe | String |
| DatasourceSetResourceId | ID do Azure Resource Manager (ARM) do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SQL na VM do Azure, esse campo conterá a ID do Azure Resource Manager (ARM) da VM na qual o Banco de Dados SQL existe | String |
| DatasourceSetType | Tipo do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SAP HANA na VM do Azure, esse campo será Microsoft.Compute/virtualMachines, já que o recurso pai é uma VM do Azure | String |
| PolicyName | Nome da política associada à instância de backup | String |
| PolicyUniqueId | Chave externa que se refere à política associada à instância de backup | String |
| PolicyId | ID do Azure Resource Manager (ARM) da política associada à instância de backup | String |
| VaultResourceId | ID do Azure Resource Manager (ARM) do cofre associado à instância de backup | String |
| VaultUniqueId | Chave estrangeira que se refere ao cofre associado à instância de backup | String |
| Nome do cofre | Nome do cofre associado à instância de backup | String |
| VaultTags | Tags do cofre associadas à instância de backup | String |
| VaultSubscriptionId | ID de assinatura do cofre associado à instância de backup | String |
| Localização do cofre | Localização do cofre associado à instância de backup | String |
| VaultStore_StorageReplicationType | Tipo de replicação de armazenamento do cofre associado à instância de backup | String |
| Tipo de cofre | Tipo de cofre, que é "Microsoft.RecoveryServices/vaults" ou "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Carimbo de data/hora do registo | DateTime |
_AzureBackup_GetBillingGroups()
Essa função retorna uma lista de todas as entidades de faturamento relacionadas ao backup (grupos de faturamento), juntamente com informações sobre os principais componentes de faturamento, como o tamanho do frontend e o armazenamento total na nuvem.
Parâmetros
| Nome do parâmetro | Descrição | Necessário? | Valor de exemplo | Tipo de data |
|---|---|---|---|---|
| RangeStart | Use esse parâmetro junto com o parâmetro RangeEnd somente se precisar buscar todos os registros relacionados ao grupo de faturamento no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada grupo de cobrança. | N | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Use esse parâmetro junto com o parâmetro RangeStart somente se precisar buscar todos os registros relacionados ao grupo de faturamento no período de tempo de RangeStart a RangeEnd. Por padrão, o valor de RangeStart e RangeEnd são nulos, o que fará com que a função recupere apenas o registro mais recente para cada grupo de cobrança. | N | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de assinaturas onde existem dados de backup. Especificar uma lista separada por vírgulas de IDs de assinatura como um parâmetro para essa função ajuda você a recuperar apenas os grupos de cobrança que estão nas assinaturas especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as assinaturas. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de regiões onde existem dados de backup. Especificar uma lista de regiões separadas por vírgulas como um parâmetro para essa função ajuda a recuperar apenas os grupos de faturamento que estão nas regiões especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as regiões. | N | eastus,westus |
String |
| VaultList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de cofres. Especificar uma lista separada por vírgulas de nomes de cofres como um parâmetro para essa função ajuda a recuperar registros de instâncias de backup pertencentes apenas aos cofres especificados. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros de grupos de faturamento em todos os cofres. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Use este parâmetro para filtrar a saída da função para registros pertencentes a um tipo de cofre específico. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure os cofres dos Serviços de Recuperação e os cofres de backup. | N | "Microsoft.RecoveryServices/cofres" | String |
| ExcludeLegacyEvent | Use esse parâmetro para escolher se deseja consultar dados na tabela AzureDiagnostics herdada ou não. Se o valor desse parâmetro for false, a função consultará dados da tabela AzureDiagnostics e das tabelas específicas do recurso. Se o valor desse parâmetro for true, a função consultará dados somente das tabelas específicas do recurso. O valor predefinido é verdadeiro. | N | verdadeiro | Boolean |
| BackupSolutionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de soluções de backup usadas em seu ambiente do Azure. Por exemplo, se você especificar Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM como o valor desse parâmetro, a função retornará somente registros relacionados a itens cujo backup foi feito usando o backup da Máquina Virtual do Azure, o backup do SQL na VM do Azure ou o backup do DPM para o Azure. Por padrão, o valor desse parâmetro é '*', o que faz com que a função retorne registros pertencentes a todas as soluções de backup suportadas pelos Relatórios de Backup (os valores suportados são "Backup de Máquina Virtual do Azure", "SQL no Backup de VM do Azure", "SAP HANA no Backup de VM do Azure", "Backup do Armazenamento do Azure (Arquivos do Azure)", "Agente de Backup do Azure", "DPM", "Servidor de Backup do Azure", "Banco de Dados do Azure para Backup do Servidor PostgreSQL", "Backup de Blob do Azure", "Backup de Disco do Azure" ou uma combinação separada por vírgulas de qualquer um desses valores). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Use esse parâmetro para pesquisar um grupo de faturamento específico pelo nome. Por padrão, o valor é "*", o que faz com que a função pesquise todos os grupos de faturamento. | N | "Testvm" | String |
Campos devolvidos
| Nome do campo | Descrição | Tipo de dados |
|---|---|---|
| UniqueId | Chave primária que indica ID exclusivo do grupo de faturamento | String |
| FriendlyName | Nome amigável do grupo de faturamento | String |
| Nome | Nome do grupo de faturação | String |
| Type | Tipo de grupo de faturamento. Por exemplo, ProtectedContainer ou BackupItem | String |
| SourceSizeInMBs | Tamanho do front-end do grupo de faturamento em MBs | Duplo |
| VaultStore_StorageConsumptionInMBs | Total de armazenamento na nuvem consumido pelo grupo de faturamento na camada padrão do cofre | Duplo |
| Solução de backup | Solução de backup à qual o grupo de cobrança está associado. Por exemplo, Backup de VM do Azure, SQL no Backup de VM do Azure e assim por diante. | String |
| VaultResourceId | ID do Azure Resource Manager (ARM) do cofre associado ao grupo de cobrança | String |
| VaultUniqueId | Chave estrangeira que se refere ao cofre associado ao grupo de faturamento | String |
| Nome do cofre | Nome do cofre associado ao grupo de faturamento | String |
| VaultTags | Tags do cofre associadas ao grupo de faturamento | String |
| VaultSubscriptionId | ID de subscrição do cofre associado ao grupo de faturação | String |
| Localização do cofre | Localização do cofre associado ao grupo de faturação | String |
| VaultStore_StorageReplicationType | Tipo de replicação de armazenamento do cofre associado ao grupo de faturamento | String |
| Tipo de cofre | Tipo de cofre, por exemplo, "Microsoft.RecoveryServices/vaults" ou "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Carimbo de data/hora do registo | DateTime |
| ExtendedProperties | Propriedades adicionais do grupo de faturamento | Dinâmica |
Funções de tendência
_AzureBackup_GetBackupInstancesTrends()
Essa função retorna registros históricos para cada instância de backup, permitindo que você visualize as principais tendências diárias, semanais e mensais relacionadas à contagem de instâncias de backup e ao consumo de armazenamento, em vários níveis de granularidade.
Parâmetros
| Nome do parâmetro | Descrição | Necessário? | Valor de exemplo | Tipo de dados |
|---|---|---|---|---|
| RangeStart | Use esse parâmetro junto com o parâmetro RangeEnd para recuperar todos os registros relacionados à instância de backup no período de tempo de RangeStart a RangeEnd. | Y | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Use esse parâmetro junto com o parâmetro RangeStart para recuperar todos os registros relacionados à instância de backup no período de tempo de RangeStart a RangeEnd. | Y | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de assinaturas onde existem dados de backup. Especificar uma lista separada por vírgulas de IDs de assinatura como um parâmetro para essa função ajuda você a recuperar apenas as instâncias de backup que estão nas assinaturas especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as assinaturas. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de regiões onde existem dados de backup. Especificar uma lista de regiões separadas por vírgulas como um parâmetro para essa função ajuda a recuperar apenas as instâncias de backup que estão nas regiões especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as regiões. | N | eastus,westus |
String |
| VaultList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de cofres. Especificar uma lista separada por vírgulas de nomes de cofres como um parâmetro para essa função ajuda a recuperar registros de instâncias de backup pertencentes apenas aos cofres especificados. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros de instâncias de backup em todos os cofres. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Use este parâmetro para filtrar a saída da função para registros pertencentes a um tipo de cofre específico. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure os cofres dos Serviços de Recuperação e os cofres de backup. | N | "Microsoft.RecoveryServices/cofres" | String |
| ExcludeLegacyEvent | Use esse parâmetro para escolher se deseja consultar dados na tabela AzureDiagnostics herdada ou não. Se o valor desse parâmetro for false, a função consultará dados da tabela AzureDiagnostics e das tabelas específicas do recurso. Se o valor desse parâmetro for true, a função consultará dados somente das tabelas específicas do recurso. O valor predefinido é verdadeiro. | N | verdadeiro | Boolean |
| BackupSolutionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de soluções de backup usadas em seu ambiente do Azure. Por exemplo, se você especificar Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM como o valor desse parâmetro, a função retornará somente registros relacionados a itens cujo backup foi feito usando o backup da Máquina Virtual do Azure, o backup do SQL na VM do Azure ou o backup do DPM para o Azure. Por padrão, o valor desse parâmetro é '*', o que faz com que a função retorne registros pertencentes a todas as soluções de backup suportadas pelos Relatórios de Backup (os valores suportados são "Backup de Máquina Virtual do Azure", "SQL no Backup de VM do Azure", "SAP HANA no Backup de VM do Azure", "Backup do Armazenamento do Azure (Arquivos do Azure)", "Agente de Backup do Azure", "DPM", "Servidor de Backup do Azure", "Banco de Dados do Azure para Backup do Servidor PostgreSQL", "Backup de Blob do Azure", "Backup de Disco do Azure" ou uma combinação separada por vírgulas de qualquer um desses valores). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Use esse parâmetro para escolher se deseja incluir apenas as instâncias de backup que estão ativamente protegidas ou também as instâncias para as quais a proteção foi interrompida e as instâncias para as quais o backup inicial está pendente. Para cargas de trabalho do vault de serviços de recuperação, os valores suportados são "Protected", "ProtectionStopped", "InitialBackupPending" ou uma combinação separada por vírgulas de qualquer um desses valores. Para cargas de trabalho do cofre de backup, os valores suportados são "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" ou uma combinação separada por vírgulas de qualquer um desses valores. Por padrão, o valor é "*", o que faz com que a função procure todas as instâncias de backup, independentemente dos detalhes de proteção. | N | "Protegido" | String |
| DatasourceSetName | Use este parâmetro para filtrar a saída da função para um recurso pai específico. Por exemplo, para retornar SQL em instâncias de backup de VM do Azure pertencentes à máquina virtual "testvm", especifique testvm como o valor desse parâmetro. Por padrão, o valor é "*", o que faz com que a função procure registros em todas as instâncias de backup. | N | "Testvm" | String |
| BackupInstanceName | Use esse parâmetro para pesquisar uma instância de backup específica pelo nome. Por padrão, o valor é "*", o que faz com que a função procure todas as instâncias de backup. | N | "Testvm" | String |
| DisplayAllFields | Use esse parâmetro para escolher se deseja recuperar apenas um subconjunto dos campos retornados pela função. Se o valor desse parâmetro for false, a função eliminará informações relacionadas ao armazenamento e ao ponto de retenção da saída da função. Isso é útil se você estiver usando essa função como uma etapa intermediária em uma consulta maior e precisar otimizar o desempenho da consulta eliminando colunas que não são necessárias para análise. Por padrão, o valor desse parâmetro é true, o que faz com que a função retorne todos os campos pertencentes à instância de backup. | N | verdadeiro | Boolean |
| Tipo de agregação | Use este parâmetro para especificar a granularidade de tempo na qual os dados devem ser recuperados. Se o valor desse parâmetro for "Daily", a função retornará um registro por instância de backup por dia, permitindo que você analise as tendências diárias de consumo de armazenamento e contagem de instâncias de backup. Se o valor desse parâmetro for "Semanal", a função retornará um registro por instância de backup por semana, permitindo que você analise tendências semanais. Da mesma forma, você pode especificar "Mensal" para analisar as tendências mensais. O valor padrão é "Daily". Se você estiver visualizando dados em intervalos de tempo maiores, é recomendável usar "Semanalmente" ou "Mensalmente" para melhorar o desempenho da consulta e facilitar a análise de tendências. | N | "Semanalmente" | String |
Campos devolvidos
| Nome do campo | Descrição | Tipo de dados |
|---|---|---|
| UniqueId | Chave primária que indica ID exclusivo da instância de backup | String |
| Id | ID do Azure Resource Manager (ARM) da instância de backup | String |
| FriendlyName | Nome amigável da instância de backup | String |
| ProtectionInfo | Informações sobre as configurações de proteção da instância de backup. Por exemplo, a proteção está configurada, a proteção interrompida, o backup inicial pendente | String |
| LatestRecoveryPoint | Data e hora do ponto de recuperação mais recente associado à instância de backup. Atualmente, esse campo só é suportado para cargas de trabalho do cofre dos Serviços de Recuperação | DateTime |
| OldestRecoveryPoint | Data e hora do ponto de recuperação mais antigo associado à instância de backup | Atualmente, esse campo só é suportado para cargas de trabalho do cofre dos Serviços de Recuperação |
| SourceSizeInMBs | Tamanho do front-end da instância de backup em MBs | Duplo |
| VaultStore_StorageConsumptionInMBs | Total de armazenamento na nuvem consumido pela instância de backup na camada padrão do vault | Duplo |
| DataSourceFriendlyName | Nome amigável da fonte de dados correspondente à instância de backup | String |
| Solução de backup | Solução de backup à qual a instância de backup está associada. Por exemplo, Backup de VM do Azure, SQL no Backup de VM do Azure e assim por diante. | String |
| DatasourceType | Tipo da fonte de dados correspondente à instância de backup. Por exemplo, "Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | ID do Azure Resource Manager (ARM) da fonte de dados subjacente correspondente à instância de backup. Por exemplo, a ID do Azure Resource Manager (ARM) da VM | String |
| DatasourceSetFriendlyName | Nome amigável do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SQL na VM do Azure, esse campo conterá o nome da VM na qual o Banco de Dados SQL existe | String |
| DatasourceSetResourceId | ID do Azure Resource Manager (ARM) do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SQL na VM do Azure, esse campo conterá a ID do Azure Resource Manager (ARM) da VM na qual o Banco de Dados SQL existe | String |
| DatasourceSetType | Tipo do recurso pai da fonte de dados (quando aplicável). Por exemplo, para uma fonte de dados SAP HANA na VM do Azure, esse campo será Microsoft.Compute/virtualMachines, já que o recurso pai é uma VM do Azure | String |
| PolicyName | Nome da política associada à instância de backup | String |
| PolicyUniqueId | Chave externa que se refere à política associada à instância de backup | String |
| PolicyId | ID do Azure Resource Manager (ARM) da política associada à instância de backup | String |
| VaultResourceId | ID do Azure Resource Manager (ARM) do cofre associado à instância de backup | String |
| VaultUniqueId | Chave estrangeira que se refere ao cofre associado à instância de backup | String |
| Nome do cofre | Nome do cofre associado à instância de backup | String |
| VaultTags | Tags do cofre associadas à instância de backup | String |
| VaultSubscriptionId | ID de assinatura do cofre associado à instância de backup | String |
| Localização do cofre | Localização do cofre associado à instância de backup | String |
| VaultStore_StorageReplicationType | Tipo de replicação de armazenamento do cofre associado à instância de backup | String |
| Tipo de cofre | Tipo de cofre, por exemplo, "Microsoft.RecoveryServices/vaults" ou "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Carimbo de data/hora do registo | DateTime |
_AzureBackup_GetBillingGroupsTrends()
Essa função retorna registros históricos para cada entidade de cobrança, permitindo que você visualize as principais tendências diárias, semanais e mensais relacionadas ao tamanho do frontend e ao consumo de armazenamento, em vários níveis de granularidade.
Parâmetros
| Nome do parâmetro | Descrição | Necessário? | Valor de exemplo | Tipo de dados |
|---|---|---|---|---|
| RangeStart | Use esse parâmetro junto com o parâmetro RangeEnd para recuperar todos os registros relacionados ao grupo de faturamento no período de tempo de RangeStart a RangeEnd. | Y | "2021-03-03 00:00:00" | DateTime |
| RangeEnd | Use esse parâmetro junto com o parâmetro RangeStart para recuperar todos os registros relacionados ao grupo de faturamento no período de tempo de RangeStart a RangeEnd. | Y | "2021-03-10 00:00:00" | DateTime |
| VaultSubscriptionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de assinaturas onde existem dados de backup. Especificar uma lista separada por vírgulas de IDs de assinatura como um parâmetro para essa função ajuda você a recuperar apenas os grupos de cobrança que estão nas assinaturas especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as assinaturas. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de regiões onde existem dados de backup. Especificar uma lista de regiões separadas por vírgulas como um parâmetro para essa função ajuda a recuperar apenas os grupos de faturamento que estão nas regiões especificadas. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros em todas as regiões. | N | eastus,westus |
String |
| VaultList | Use este parâmetro para filtrar a saída da função para um determinado conjunto de cofres. Especificar uma lista separada por vírgulas de nomes de cofres como um parâmetro para essa função ajuda a recuperar registros de instâncias de backup pertencentes apenas aos cofres especificados. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure registros de grupos de faturamento em todos os cofres. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Use este parâmetro para filtrar a saída da função para registros pertencentes a um tipo de cofre específico. Por padrão, o valor desse parâmetro é '*', o que faz com que a função procure os cofres dos Serviços de Recuperação e os cofres de backup. | N | "Microsoft.RecoveryServices/cofres" | String |
| ExcludeLegacyEvent | Use esse parâmetro para escolher se deseja consultar dados na tabela AzureDiagnostics herdada ou não. Se o valor desse parâmetro for false, a função consultará dados da tabela AzureDiagnostics e das tabelas específicas do recurso. Se o valor desse parâmetro for true, a função consultará dados somente das tabelas específicas do recurso. O valor predefinido é verdadeiro. | N | verdadeiro | Boolean |
| BackupSolutionList | Use esse parâmetro para filtrar a saída da função para um determinado conjunto de soluções de backup usadas em seu ambiente do Azure. Por exemplo, se você especificar Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM como o valor desse parâmetro, a função retornará somente registros relacionados a itens cujo backup foi feito usando o backup da Máquina Virtual do Azure, o backup do SQL na VM do Azure ou o backup do DPM para o Azure. Por padrão, o valor desse parâmetro é '*', o que faz com que a função retorne registros pertencentes a todas as soluções de backup suportadas pelos Relatórios de Backup (os valores suportados são "Backup de Máquina Virtual do Azure", "SQL no Backup de VM do Azure", "SAP HANA no Backup de VM do Azure", "Backup do Armazenamento do Azure (Arquivos do Azure)", "Agente de Backup do Azure", "DPM", "Servidor de Backup do Azure", "Banco de Dados do Azure para Backup do Servidor PostgreSQL", "Backup de Blob do Azure", "Backup de Disco do Azure" ou uma combinação separada por vírgulas de qualquer um desses valores). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Use esse parâmetro para pesquisar um grupo de faturamento específico pelo nome. Por padrão, o valor é "*", o que faz com que a função pesquise todos os grupos de faturamento. | N | "Testvm" | String |
| Tipo de agregação | Use este parâmetro para especificar a granularidade de tempo na qual os dados devem ser recuperados. Se o valor desse parâmetro for "Diário", a função retornará um registro por grupo de faturamento por dia, permitindo que você analise as tendências diárias de consumo de armazenamento e tamanho do frontend. Se o valor desse parâmetro for "Semanal", a função retornará um registro por instância de backup por semana, permitindo que você analise tendências semanais. Da mesma forma, você pode especificar "Mensal" para analisar as tendências mensais. O valor padrão é "Daily". Se você estiver visualizando dados em intervalos de tempo maiores, é recomendável usar "Semanalmente" ou "Mensalmente" para melhorar o desempenho da consulta e facilitar a análise de tendências. | N | "Semanalmente" | String |
Campos devolvidos
| Nome do campo | Descrição | Tipo de dados |
|---|---|---|
| UniqueId | Chave primária que indica ID exclusivo do grupo de faturamento | String |
| FriendlyName | Nome amigável do grupo de faturamento | String |
| Nome | Nome do grupo de faturação | String |
| Type | Tipo de grupo de faturamento. Por exemplo, ProtectedContainer ou BackupItem | String |
| SourceSizeInMBs | Tamanho do front-end do grupo de faturamento em MBs | Duplo |
| VaultStore_StorageConsumptionInMBs | Total de armazenamento na nuvem consumido pelo grupo de faturamento na camada padrão do cofre | Duplo |
| Solução de backup | Solução de backup à qual o grupo de cobrança está associado. Por exemplo, Backup de VM do Azure, SQL no Backup de VM do Azure e assim por diante. | String |
| VaultResourceId | ID do Azure Resource Manager (ARM) do cofre associado ao grupo de cobrança | String |
| VaultUniqueId | Chave estrangeira que se refere ao cofre associado ao grupo de faturamento | String |
| Nome do cofre | Nome do cofre associado ao grupo de faturamento | String |
| VaultTags | Tags do cofre associadas ao grupo de faturamento | String |
| VaultSubscriptionId | ID de subscrição do cofre associado ao grupo de faturação | String |
| Localização do cofre | Localização do cofre associado ao grupo de faturação | String |
| VaultStore_StorageReplicationType | Tipo de replicação de armazenamento do cofre associado ao grupo de faturamento | String |
| Tipo de cofre | Tipo de cofre, por exemplo, "Microsoft.RecoveryServices/vaults" ou "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Carimbo de data/hora do registo | DateTime |
| ExtendedProperties | Propriedades adicionais do grupo de faturamento | Dinâmica |
Consultas de Exemplo
Abaixo estão algumas consultas de exemplo para ajudá-lo a começar a usar as funções do sistema.
Todos os trabalhos de backup de VM do Azure com falha em um determinado intervalo de tempo
_AzureBackup_GetJobs("2021-03-05", "2021-03-06") //call function with RangeStart and RangeEnd parameters set, and other parameters with default value | where BackupSolution=="Azure Virtual Machine Backup" and Status=="Failed" | project BackupInstanceFriendlyName, BackupInstanceId, OperationCategory, Status, JobStartDateTime=StartTime, JobDuration=DurationInSecs/3600, ErrorTitle, DataTransferred=DataTransferredInMBsTodos os trabalhos de backup de log SQL em um determinado intervalo de tempo
_AzureBackup_GetJobs("2021-03-05", "2021-03-06","*","*","*","*",true,"*","*","*","*","*","*",false) //call function with RangeStart and RangeEnd parameters set, ExcludeLog parameter as false, and other parameters with default value | where BackupSolution=="SQL in Azure VM Backup" and Operation=="Log" | project BackupInstanceFriendlyName, BackupInstanceId, OperationCategory, Status, JobStartDateTime=StartTime, JobDuration=DurationInSecs/3600, ErrorTitle, DataTransferred=DataTransferredInMBsTendência semanal de armazenamento de backup consumido para VM "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