Guia de início rápido: criar alertas com o Azure Resource Graph e o Log Analytics

Não é necessário criar uma máquina virtual para o exemplo que usa a tabela do Gráfico de Recursos do Azure.

Para obter informações de log, quando você conecta sua máquina virtual ao espaço de trabalho do Log Analytics, o Agente do Azure Monitor é instalado na máquina virtual. Se você não tiver uma máquina virtual, poderá criar uma para este exemplo. Para evitar custos desnecessários, exclua a máquina virtual quando terminar o exemplo.

As instruções a seguir são configurações básicas para uma máquina virtual Linux. As etapas detalhadas sobre como criar uma máquina virtual estão fora do escopo deste artigo. Sua organização pode exigir configurações de segurança ou de rede diferentes para máquinas virtuais.

1. No Azure, crie uma máquina virtual Ubuntu Linux.

2. Selecione Criar.

3. Em Criar uma máquina virtual, você pode aceitar as configurações padrão com as seguintes exceções:

   Noções básicas

   • Grupo de recursos: demo-arg-alert-rg
   • nome da máquina virtual: insira um nome de máquina virtual como demovm01.
   • Opções de disponibilidade: Não é necessária redundância de infraestrutura
   • Tamanho: Standard_B1s
   • Conta de administrador: tem de criar credenciais, mas, neste exemplo, não precisa de iniciar sessão:
     • Tipo de autenticação: chave pública SSH
     • Nome de usuário: Criar um nome de usuário
     • Fonte de chave pública SSH: Gerar novo par de chaves
     • Nome do par de chaves: Aceitar nome padrão
   • Portas de entrada públicas: Nenhuma

   Discos

   • Verifique se a opção Excluir com VM está selecionada.

   Rede

   • IP público: Nenhum
   • Selecione Excluir NIC quando a VM for excluída.

   Gestão

   • Selecione Ativar desligamento automático.
   • Selecione uma hora de encerramento no seu fuso horário.
   • Adicione seu endereço de e-mail se quiser uma notificação de desligamento.

   Monitoramento, Avançado e Tags

   • Não são necessárias alterações para este exemplo.

4. Selecione Rever + criar e, em seguida, Criar.

   Você será solicitado a Gerar novo par de chaves. Selecione Transferir chave privada e criar recurso. Quando terminar de usar a máquina virtual, exclua o arquivo de chave privada do computador.

5. Selecione Ir para recurso depois que a máquina virtual for implantada.

Configure uma regra de coleta de dados para monitorar a máquina virtual.

1. No campo de pesquisa do Azure, insira regras de coleta de dados e selecione Regras de coleta de dados.
2. Selecione Criar:
   • Nome da regra: insira um nome como demo-data-collection-rule.
   • Subscrição: selecione a sua subscrição.
   • Grupo de recursos: Selecione demo-arg-alert-rg.
   • Região: Oeste dos EUA 3.
   • Tipo de plataforma: Selecione Tudo.
3. Selecione Next: Recursos:
   • Selecione Adicionar recursos.
   • Subscrição: selecione a sua subscrição.
   • Escopo: selecione seu grupo de recursos e o nome da máquina virtual.
   • Selecione Aplicar.
4. Selecione Seguinte: Recolher e entregar:
   • Selecione Adicionar origem de dados.
   • Tipo de fonte de dados: Selecione Contadores de Desempenho.
   • Selecione Próximo: Destino e Adicionar destino:
   • Tipo de destino: Azure Monitor Logs.
   • Subscrição: selecione a sua subscrição.
   • Conta ou namespace: selecione seu espaço de trabalho do Log Analytics, demo-arg-alert-workspace.
   • Selecione Adicionar origem de dados.
   • Selecione Rever + criar e, em seguida , Criar.
   • Selecione Ir para recurso quando a implantação estiver concluída.

Verifique se o monitoramento está configurado para a máquina virtual:

1. Vá para sua regra de coleta de dados e revise a Configuração:
   • Fontes de Dados: mostra os Contadores de Desempenho da fonte de dados e os Logs do Azure Monitor de destino.
   • Recursos: mostra a máquina virtual, o grupo de recursos e a assinatura.
2. Vá para o espaço de trabalho demo-arg-alert-workspace do Log Analytics. Selecione Configurações>Agentes>Servidores Linux e seu computador Linux está conectado ao agente Linux do Azure Monitor. Pode levar alguns minutos para que o agente seja exibido.
3. Vá para sua máquina virtual e selecione Configurações>Extensões + aplicativos e verifique se o AzureMonitorLinuxAgentprovisionamento mostra foi bem-sucedido.

No espaço de trabalho do Log Analytics, crie uma consulta do Azure Resource Graph para obter uma contagem dos seus recursos do Azure. Este exemplo usa a tabela Azure Resource Graph Resources .

1. Selecione Logs no lado esquerdo da página do espaço de trabalho do Log Analytics. Feche a janela Consultas , se exibida.

2. Use o seguinte código na nova consulta:

   arg("").Resources
   | count
   

   Os nomes das tabelas no Log Analytics precisam ser maiúsculas e minúsculas com a primeira letra de cada palavra em maiúsculas, como Resources ou ResourceContainers. Você também pode usar minúsculas como resources ou resourcecontainers.

   

3. Selecione Executar.

   Os Resultados exibem a Contagem de recursos em sua assinatura do Azure. Anote esse número porque você precisa dele para a condição da regra de alerta. Quando você executa manualmente a consulta, a contagem é baseada na identidade do usuário e um alerta disparado usa uma identidade gerenciada. É possível que a contagem varie entre uma execução manual ou um alerta disparado.

4. Remova a contagem da consulta.

   arg("").Resources
   

No espaço de trabalho do Log Analytics, crie uma consulta do Azure Resource Graph para obter as últimas informações de pulsação da sua máquina virtual. Este exemplo usa a tabela do Azure Resource Graph Resources e os dados do Log Analytics da tabela Azure Monitor Logs Heartbeat .

1. Vá para o espaço de trabalho demo-arg-alert-workspace do Log Analytics.

2. Selecione Logs no lado esquerdo da página do espaço de trabalho do Log Analytics. Feche a janela Consultas , se exibida.

3. Use o seguinte código na nova consulta:

   arg("").Resources
   | where type == 'microsoft.compute/virtualmachines'
   | project ResourceId = id, name, PowerState = tostring(properties.extended.instanceView.powerState.code)
   | join (Heartbeat
     | where TimeGenerated > ago(15m)
     | summarize lastHeartBeat = max(TimeGenerated) by ResourceId)
     on ResourceId
   | project lastHeartBeat, PowerState, name, ResourceId
   

   Os nomes das tabelas no Log Analytics precisam ser maiúsculas e minúsculas com a primeira letra de cada palavra em maiúsculas, como Resources ou ResourceContainers. Você também pode usar minúsculas como resources ou resourcecontainers.

   Você pode usar outros períodos de tempo para o TimeGenerated. Por exemplo, em vez de minutos como 15m horas de uso como 12h, 24h, 48h.

   

4. Selecione Executar.

   A consulta deve retornar a última pulsação, o estado de energia, o nome e a ID do recurso da máquina virtual. Se nenhum resultado for exibido, continue para as próximas etapas. As novas configurações podem levar 30 minutos para que os dados de monitoramento fiquem disponíveis para a consulta e os alertas.

No espaço de trabalho do Log Analytics, selecione Nova regra de alerta. A consulta do espaço de trabalho do Log Analytics é copiada para a regra de alerta. Criar uma regra de alerta tem várias guias que precisam ser atualizadas para criar o alerta.

Âmbito

Verifique se o escopo assume como padrão o espaço de trabalho do Log Analytics chamado demo-arg-alert-workspace.

Somente se o escopo não estiver definido como padrão, execute as seguintes etapas:

1. Vá para a guia Escopo e selecione Selecionar escopo.
2. Na parte inferior da tela Recursos selecionados , remova o escopo atual.
3. Selecione a opção Selecionar escopo.
4. Expanda o demo-arg-alert-rg na lista de recursos e selecione demo-arg-alert-workspace.
5. Selecione Aplicar.
6. Selecione Next: Condição.

Condição

O formulário tem vários campos a preencher:

• Nome do sinal: Pesquisa de log personalizada
• Consulta de pesquisa: Exibe o código de consulta
  • Se você alterou o escopo, precisará adicionar a consulta na seção Criar consulta .

Medição

• Medida: Linhas da tabela
• Tipo de agregação: Contagem
• Granularidade da agregação: 5 minutos

Lógica de alerta

• Operador: Maior que
• Valor do limite: use um número menor que o número retornado da contagem de recursos.
  • Por exemplo, se a contagem de recursos foi 50, use 45. Esse valor dispara o alerta para disparar quando ele avalia seus recursos porque seu número de recursos é maior do que o valor limite.
• Frequência da avaliação: 5 minutos

Selecione Next: Actions.

Ações

Selecione Criar grupo de ações:

• Subscrição: selecione a sua subscrição do Azure.
• Grupo de recursos: demo-arg-alert-rg
• Região: Global permite que o serviço de grupos de ação selecione o local.
• Nome do grupo de ação: demo-arg-alert-action-group
• Nome para exibição: demo-action (limite de 12 caracteres)

Selecione Next: Notificações:

• Tipo de notificação: Selecione E-mail / SMS mensagem / Push / Voz.
• Nome: email-alert
• Marque a caixa de seleção E-mail e digite seu endereço de e-mail.
• Selecione OK.

Selecione Rever + criar, verifique se o resumo está correto e selecione Criar. Você retornará à guia Ações da página Criar uma regra de alerta. O nome do grupo de ações mostra o grupo de ações que você criou. Você recebe uma notificação por e-mail para confirmar que foi adicionado ao grupo de ação.

Selecione Next: Details.

Detalhes

Use as seguintes informações na guia Detalhes :

• Subscrição: selecione a sua subscrição do Azure.
• Grupo de recursos: demo-arg-alert-rg
• Gravidade: Aceite o valor padrão 3 - Informativo.
• Nome da regra de alerta: demo-arg-alert-rule
• Descrição da regra de alerta: Alerta de email para contagem de recursos do Azure
• Região: West US 3
• Identidade: Selecione Identidade gerenciada atribuída ao sistema.

Selecione Rever + criar, verifique se o resumo está correto e selecione Criar. Você retornará à página Logs do seu espaço de trabalho do Log Analytics.

Atribuir função

Atribua o Log Analytics Reader à identidade gerenciada atribuída pelo sistema para que ele tenha permissões disparando alertas que enviam notificações por e-mail.

1. Selecione Alertas de monitoramento> no espaço de trabalho do Log Analytics. Selecione OK se lhe for pedido que as edições não guardadas serão descartadas.
2. Selecione Regras de alerta.
3. Selecione demo-arg-alert-rule.
4. Selecione Configurações>>
   • Estado: Ativado
   • ID do objeto: mostra o GUID do seu aplicativo corporativo (entidade de serviço) no Microsoft Entra ID.
   • Permissão: Selecione atribuições de função do Azure:
     • Verifique se a sua subscrição está selecionada.
     • Selecione Adicionar atribuição de função:
     • Âmbito: Subscrição
     • Assinatura: selecione o nome da sua assinatura do Azure.
     • Função: Log Analytics Reader
5. Selecione Guardar.

Leva alguns minutos para que o Log Analytics Reader seja exibido na página de atribuições de função do Azure. Selecione Atualizar para atualizar a página.

Use o botão Voltar do navegador para retornar à Identidade e selecione Visão geral para retornar à regra de alerta. Selecione o link para seu grupo de recursos chamado demo-arg-alert-rg.

Embora fora do escopo deste artigo, se você estiver consultando um cluster do Azure Data Explorer, deverá adicionar a função Leitor à identidade gerenciada atribuída ao sistema. Para obter mais informações, no final deste artigo, selecione o link Atribuições de função para clusters do Azure Data Explorer.

No espaço de trabalho do Log Analytics, selecione Nova regra de alerta. A consulta do espaço de trabalho do Log Analytics é copiada para a regra de alerta. A regra Criar um alerta tem várias guias que precisam ser atualizadas.

Âmbito

Verifique se o escopo assume como padrão o espaço de trabalho do Log Analytics chamado demo-arg-alert-workspace.

Somente se o escopo não estiver definido como padrão, execute as seguintes etapas:

1. Vá para a guia Escopo e selecione Selecionar escopo.
2. Na parte inferior da tela Recursos selecionados , exclua o escopo atual.
3. Expanda o demo-arg-alert-rg na lista de recursos e selecione demo-arg-alert-workspace.
4. Selecione Aplicar.
5. Selecione Next: Condição.

Condição

O formulário tem vários campos a preencher:

• Nome do sinal: Pesquisa de log personalizada
• Consulta de pesquisa: Exibe o código de consulta
  • Se você alterou o escopo, precisará adicionar a consulta na seção Criar consulta .

Medição

• Medida: Linhas da tabela
• Tipo de agregação: Contagem
• Granularidade da agregação: 5 minutos

Lógica de alerta

• Operador: Menos de
• Valor limite: 2
• Frequência da avaliação: 5 minutos

Selecione Next: Actions.

Ações

Selecione Criar grupo de ações:

• Subscrição: selecione a sua subscrição do Azure.
• Grupo de recursos: demo-arg-alert-rg
• Região: Global permite que o serviço de grupos de ação selecione o local.
• Nome do grupo de ação: demo-arg-la-alert-action-group
• Nome para exibição: demo-argla (limite é de 12 caracteres)

Selecione Next: Notificações:

• Tipo de notificação: Selecione Email/SMS message/Push/Voice
• Nome: email-alert-arg-la
• Marque a caixa de seleção E-mail e digite seu endereço de e-mail
• Selecione Ok

Selecione Rever + criar, verifique se o resumo está correto e selecione Criar. Você retornará à guia Ações da página Criar uma regra de alerta. O nome do grupo de ações mostra o grupo de ações que você criou. Você recebe uma notificação por e-mail para confirmar que foi adicionado ao grupo de ação.

Selecione Next: Details.

Detalhes

Use as seguintes informações na guia Detalhes :

• Subscrição: selecione a sua subscrição do Azure.
• Grupo de recursos: demo-arg-alert-rg
• Gravidade: Selecione 2 - Aviso.
• Nome da regra de alerta: demo-arg-la-alert-rule
• Descrição da regra de alerta: Alerta de email para consulta ARG-LA da máquina virtual do Azure
• Região: West US 3
• Identidade: Selecione Identidade gerenciada atribuída ao sistema

Selecione Rever + criar, verifique se o resumo está correto e selecione Criar. Você retornará à página Logs do seu espaço de trabalho do Log Analytics.

Atribuir função

Atribua o Log Analytics Reader à identidade gerenciada atribuída pelo sistema para que ele tenha permissões disparando alertas que enviam notificações por e-mail.

1. Selecione Alertas de monitoramento> no espaço de trabalho do Log Analytics. Selecione OK se lhe for pedido que as edições não guardadas serão descartadas.
2. Selecione Regras de alerta.
3. Selecione demo-arg-la-alert-rule.
4. Selecione Configurações>>
   • Estado: Ativado
   • ID do objeto: mostra o GUID do seu aplicativo corporativo (entidade de serviço) no Microsoft Entra ID.
   • Permissão: selecione atribuições de função do Azure
     • Verifique se a sua subscrição está selecionada
     • Selecione Adicionar atribuição de função:
     • Âmbito: Subscrição
     • Assinatura: selecione o nome da sua assinatura do Azure
     • Função: Log Analytics Reader
5. Selecione Guardar.

Leva alguns minutos para que o Log Analytics Reader seja exibido na página de atribuições de função do Azure. Selecione Atualizar para atualizar a página.

Use o botão Voltar do navegador para retornar à Identidade e selecione Visão geral para retornar à regra de alerta. Selecione o link para seu grupo de recursos chamado demo-arg-alert-rg.

Embora fora do escopo deste artigo, para um cluster do Azure Data Explorer, adicione a função Leitor à identidade gerenciada atribuída ao sistema. Para obter mais informações, no final deste artigo, selecione o link Atribuições de função para clusters do Azure Data Explorer.

Depois que a função for atribuída à sua regra de alerta, você começará a receber emails para mensagens de alerta. A regra foi criada para enviar alertas a cada cinco minutos e leva alguns minutos para receber o primeiro alerta.

Você também pode exibir os alertas no portal do Azure:

1. Vá para o grupo de recursos demo-arg-alert-rg.

2. Selecione demo-arg-alert-workspace na sua lista de recursos.

3. Selecione Monitoramento>de alertas.

4. É apresentada uma lista de alertas.

   

Depois que a função for atribuída à sua regra de alerta, você começará a receber emails para mensagens de alerta. A regra foi criada para enviar alertas a cada cinco minutos e leva alguns minutos para receber o primeiro alerta.

Você também pode exibir os alertas no portal do Azure:

1. Vá para o grupo de recursos demo-arg-alert-rg.

2. Selecione a sua máquina virtual.

3. Selecione Monitoramento>de alertas.

4. É apresentada uma lista de alertas.

   

Para uma nova configuração, pode levar 30 minutos para que as informações de log fiquem disponíveis e criem alertas. Durante esse tempo, você pode notar que a regra de alerta da máquina virtual exibe alertas nos alertas de monitoramento do espaço de trabalho. Quando as informações de log da máquina virtual ficam disponíveis, os alertas são exibidos nos alertas de monitoramento da máquina virtual.