Criar alertas do Activator a partir de um conjunto de consultas KQL em Inteligência em Tempo Real

Este artigo explica como criar alertas do Fabric Activator a partir de um Conjunto de Consultas KQL. Para obter mais informações, confira O que é o Activator. Você pode usar o Activator em um Conjunto de Consultas KQL para disparar notificações de dois modos:

• quando uma consulta KQL agendada retorna resultados
• quando uma consulta KQL agendada retorna resultados que contêm uma visualização atende a um conjunto definido de condições.

Envie notificações de alerta para si mesmo ou para outras pessoas na sua organização. As notificações podem ser enviadas por email ou mensagem do Microsoft Teams.

Exemplo de cenários

Estas são algumas maneiras de usar alertas do Activator com consultas KQL:

• Suponha que você tenha um banco de dados KQL e esteja armazenando logs de aplicativos.
  • Você recebe um alerta quando todos os registros dos últimos 5 minutos contêm a cadeia de caracteres authorization error na coluna de mensagem da tabela.
• Em um cenário diferente, você tem dados de streaming para bicicletas disponíveis em diferentes bairros. Uma consulta KQL é criada para renderizar um gráfico de pizza para o número de bicicletas disponíveis por bairro.
  • Você recebe um alerta quando o número de bicicletas disponíveis em qualquer bairro fica abaixo de um número aceitável.

Pré-requisitos

• Um espaço de trabalho com uma capacidade habilitada para o Microsoft Fabric
• Um Banco de dados KQL com dados
• Um Conjunto de Consultas KQL conectado ao banco de dados KQL. Para obter mais informações, confira Consultar dados em um conjunto de consultas KQL.

Importante

Há suporte apenas para consultas em bancos de dados KQL em um Eventhouse. Se o conjunto de consultas KQL estiver conectado a um cluster externo do Azure Data Explorer, não há suporte para a criação de um alerta.

As etapas a seguir mostram como criar um alerta em uma consulta que cria uma visualização ou em uma consulta que não a cria.

Escolha o guia que corresponde ao fluxo de trabalho desejado.

Com visualização

Definir alerta em um Conjunto de Consultas KQL

Importante

Não há suporte para visualizações de Gráfico de Tempo neste cenário. Elas são compatíveis com a opção Criar alertas do Activator de um Painel em Tempo Real.

1. Navegue até o Conjunto de Consultas KQL.

2. Execute uma consulta que retorna uma visualização.

3. Após a consulta retornar os resultados, selecione Definir Alerta na faixa de opções superior.

   Por exemplo, a consulta a seguir baseia-se nos dados de amostra de Bicicletas do tutorial de Inteligência em Tempo Real.

   TutorialTable
   | where Timestamp < ago(5m)
   | summarize NumberOfBikes=sum(No_Bikes) by Neighbourhood
   | render columnchart
   

   A consulta retorna um gráfico de colunas que mostra o número de bicicletas disponíveis em cada bairro e esse gráfico é usado para definir condições de alerta.

Definir condições de alerta

1. Defina uma frequência de tempo para a frequência com que a consulta é executada. O padrão é 5 minutos.
2. Em Condições, especifique as condições de alerta da seguinte maneira:
   • Se a visualização não tiver dimensões, você poderá selecionar a condiçãoEm cada evento quando para monitorar as alterações no fluxo de dados escolhendo um campo específico a ser monitorado.
   • Se a visualização incluir dimensões, você poderá selecionar a condição Em cada evento agrupado por para monitorar as alterações no fluxo de dados selecionando um campo para agrupamento, que divide os dados em grupos distintos
   • Na lista suspensa Quando, defina o valor a ser avaliado.
   • Na lista suspensa Condição, defina a condição a ser avaliada. Para obter mais informações, consulte Condições.
   • No campo Valor, defina o valor a ser comparado.
3. Em Ação, especifique se deseja alertar por email ou pelo Microsoft Teams. No painel lateral, configure notificações enviadas para você mesmo. Para enviar notificações para um usuário diferente, confira Opcional: edite a regra no Activator.
4. Em Salvar local, especifique onde salvar o alerta do Activator. Escolha um espaço de trabalho existente e salve em um ativador existente ou em um novo.
5. Selecione Criar para criar a regra do Activator.

Sem visualização

Definir alerta em um Conjunto de Consultas KQL

1. Navegue até o Conjunto de Consultas KQL.
2. Executar uma consulta. O Activator verifica os resultados dessa consulta de acordo com a frequência de tempo definida em uma etapa posterior e envia um alerta para cada registro retornado no conjunto de resultados. Por exemplo, se uma consulta agendada retornar cinco registros, o Activator enviará cinco alertas.
3. Após concluir a consulta, selecione Definir Alerta na faixa de opções superior.

Exemplo 1 – Resultado único quando a contagem é maior que o limite

Por exemplo, a consulta a seguir retorna um alerta se houver mais do que o limite de registros na tabela dos últimos 5 minutos. As duas últimas linhas da consulta são chave, na qual a contagem de registros correspondentes aos filtros é criada e um resultado é retornado somente se a contagem for maior que o limite.

SampleTable 
| where ingestion_time() > ago (5min)
// Add any other optional filters
| count 
| where Count > threshold

Exemplo 2 – Criar um único resultado com uma matriz de vários valores

No exemplo a seguir, a consulta retornará um alerta se o número de bicicletas em qualquer bairro estiver acima do limite especificado. Para obter um único alerta para todos os bairros para os quais o número está acima do limite, a consulta é criada para retornar um único registro (ou seja, um único alerta). Isso é feito usando o operador make_list() Para editar o alerta para conter a lista dos bairros que atingiram o limite, confira Opcional: edite a regra no Activator.

TableForReflex
| where ingestion_time() > ago (5min)
| summarize NeighborhoodCount = count() by Neighbourhood
| where NeighborhoodCount > threshold
| summarize NeighbourhoodList = make_list(Neighbourhood)

Defina condições do alerta

Em seguida, defina suas condições de alerta. No painel Definir Alerta exibido, execute as seguintes etapas:

1. Defina uma frequência de tempo para a frequência com que a consulta é executada. O padrão é 5 minutos. A única condição disponível neste cenário é Em cada evento, o que significa que, quando qualquer registro é retornado, a condição é atendida.
2. Em Ação, especifique se deseja alertar por email ou pelo Microsoft Teams. No painel lateral, configure notificações enviadas para você mesmo. Para enviar notificações para um usuário diferente, confira Opcional: edite a regra no Activator.
3. Em Salvar local, especifique onde salvar o alerta do Activator. Escolha um espaço de trabalho existente e salve em um ativador existente ou em um novo.
4. Selecione Criar para criar a regra do Activator.

Opcional: editar a regra no Activator

Quando o ativador for salvo, o painel lateral exibirá um link para o item. Selecione o link para editar ainda mais no Activator. Essa etapa pode ser útil caso queira fazer uma das seguintes ações:

• Adicionar outros destinatários ao seu alerta.
• Alterar o conteúdo do alerta para refletir os dados específicos que dispararam o alerta.
• Defina uma condição de alerta mais complexa do que a possível no painel Definir alerta.

Para obter informações sobre como editar regras no Activator, confira Criar regras do Activator.

No próprio ativador, também é possível exibir o histórico dos resultados da consulta e o histórico das ativações da regra. Para obter mais informações, confira Criar um workspace.

Conteúdo relacionado

• Consultar dados em um conjunto de consultas KQL
• Introdução ao Activator
• Guia de referência rápida da KQL