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.

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.

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

Campos devolvidos

_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

Campos devolvidos

_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

Campos devolvidos

_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

Campos devolvidos

_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

Campos devolvidos

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

Campos devolvidos

_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

Campos devolvidos

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=DataTransferredInMBs
  

• Todos 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=DataTransferredInMBs
  

• Tendê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 
  

Próximos passos

Saiba mais sobre relatórios de backup