Criar alertas do Activator a partir de um conjunto de consultas KQL

Definir alerta em um conjunto de consultas KQL

1. Abra o espaço de trabalho que contém o conjunto de consultas KQL.

2. Navegue até o seu conjunto de consultas KQL e selecione-o para abrir.

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

4. Quando a consulta retornar os resultados, selecione Definir alerta na faixa de opções superior.

   

Definir condições de alerta

No painel lateral de Adicionar Regra que aparece, siga estes passos para definir as suas condições de alerta:

1. Na secção de Detalhes , dê um nome para a sua regra de alerta de Ativador.

   

2. Na secção Monitor , defina uma frequência de tempo para a frequência com que a consulta é executada. O padrão é 5 minutos.

   

3. Na secção de Condições , especifique as suas condições de alerta da seguinte forma:

   

   • Se sua visualização não tiver dimensões, você poderá selecionar a condição Em cada evento quando para monitorar alterações no fluxo de dados escolhendo um campo específico para monitorar.
   • 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 Ocorrência , defina o número de vezes que a condição deve ser cumprida antes de um alerta ser acionado.

4. Na secção de Ação , selecione uma das seguintes ações:

   • Enviar notificação por email:

     1. Para Selecionar ação, selecione Enviar e-mail.
     2. Para To, introduza o endereço de email do destinatário ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. Por padrão, o seu endereço de email está preenchido aqui.
     3. Para o assunto, introduza o assunto da notificação por email.
     4. Para o Título, introduza o título da notificação por email.
     5. Para Notas, introduza notas para a notificação por email.

        Observação

        Ao inserir assunto, título ou anotações, você pode fazer referência às propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

     6. Para Contexto, selecione da lista suspensa os valores que pretende incluir na notificação de email.

     

   • Envie uma notificação do Microsoft Teams: Envie uma mensagem do Microsoft Teams para si próprio. Pode personalizar o título e o conteúdo da mensagem.

     1. Para selecionar ação, selecione Teams -->Mensagem para indivíduos ou mensagem de grupo no chat, ou publicação no canal.
     2. Siga um destes passos dependendo da sua escolha:
        • Se você selecionou a opção Mensagem para indivíduos , insira os endereços de e-mail dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de e-mail. Quando a condição é cumprida, um e-mail é enviado para indivíduos específicos.
        • Se você selecionou a opção Mensagem de chat de grupo , selecione um bate-papo em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat de grupo.
        • Se tiveres selecionado a opção Publicação no canal, seleciona uma equipa e um canal a partir das listas suspensas. Quando a condição é cumprida, uma mensagem é publicada no canal selecionado.
     3. No Campo 'Título', introduza o título da notificação do Teams.
     4. Para Notas, introduza notas para a notificação do Teams.

        Observação

        Ao inserir assunto, título ou anotações, você pode fazer referência às propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

     5. Para contextualizar, selecione os valores da lista suspensa que pretende incluir na notificação do Teams.

     

   • Executar atividades do Fabric: Para configurar o alerta para executar um pipeline do Fabric, trabalho Spark ou notebook quando a condição for cumprida, siga os seguintes passos:

     1. Para Selecionar ação, selecione Executar Pipeline, Executar tarefa Spark, Executar Notebook ou Executar Função (pré-visualização).
     2. Para selecionar o item Fabric a executar, selecione o item Fabric (pipeline, notebook, tarefa Spark ou função) da lista.
     3. Selecione Adicionar parâmetro e especifique o nome do parâmetro para o item Fabric e um valor para ele. Você pode adicionar mais de um parâmetro. Pode passar parâmetros a partir dos dados de alerta escrevendo @ ou selecionando o botão ao lado da caixa de texto. Por exemplo, @BikepointID.

   • Ações personalizadas: Para configurar o alerta para chamar uma ação personalizada quando a condição for cumprida, siga estes passos:

     1. Para Selecionar ação, selecione Criar ação personalizada.

        

     2. Como mencionado na secção Ação, crie primeiro a regra e depois complete a configuração da ação personalizada seguindo os passos de Trigger custom actions (fluxos do Power Automate).

     3. Depois de criares a ação personalizada, no painel de Definição da regra, seleciona a ação personalizada que criaste na lista suspensa de Ações .

5. Em Guardar localização, especifique onde guardar o alerta do Activator. Escolha um espaço de trabalho existente e salve em um ativador existente ou em um novo.

   

6. Selecione Criar para criar sua regra de Ativador.

Definir alerta em um conjunto de consultas KQL

1. Abra o espaço de trabalho que contém o conjunto de consultas KQL.
2. Navegue até o seu conjunto de consultas KQL e selecione-o para abrir.
3. Execute 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.
4. Quando a execução da consulta estiver concluída, 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 de registros de limite 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 retorna um alerta se o número de bicicletas em qualquer bairro estiver acima do limite determinado. 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), que é feito usando o operador make_list(). Para editar o alerta para conter a lista dos bairros que atingiram o limite, consulte Opcional: editar sua regra no Ativador.

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

Definir condições de alerta

No painel lateral de Adicionar Regra que aparece, siga estes passos para definir as suas condições de alerta:

1. Na secção de Detalhes , dê um nome para a sua regra de alerta de Ativador.

   

2. Na secção Monitor , defina uma frequência de tempo para a frequência com que a consulta é executada. O padrão é 5 minutos.

   

3. Na secção de Condições , especifique as suas condições de alerta da seguinte forma:

   

   • Se sua visualização não tiver dimensões, você poderá selecionar a condição Em cada evento quando para monitorar alterações no fluxo de dados escolhendo um campo específico para monitorar.
   • 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 Ocorrência , defina o número de vezes que a condição deve ser cumprida antes de um alerta ser acionado.

4. Na secção de Ação , selecione uma das seguintes ações:

   • Enviar notificação por email:

     1. Para Selecionar ação, selecione Enviar e-mail.
     2. Para To, introduza o endereço de email do destinatário ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. Por defeito, o seu endereço de email é preenchido automaticamente aqui.
     3. Para o assunto, introduza o assunto da notificação por email.
     4. Para o Título, introduza o título da notificação por email.
     5. Para Notas, introduza notas para a notificação por email.

        Observação

        Ao inserir assunto, título ou anotações, você pode fazer referência às propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

     6. Para contextualizar, selecione os valores da lista suspensa que pretende incluir na notificação do email.

     

   • Envie uma notificação do Microsoft Teams: Envie uma mensagem do Microsoft Teams para si próprio. Pode personalizar o título e o conteúdo da mensagem.

     1. Para selecionar ação, selecione Teams -->Mensagem para indivíduos ou mensagem de grupo no chat, ou publicação no canal.
     2. Siga um destes passos dependendo da sua escolha:
        • Se você selecionou a opção Mensagem para indivíduos , insira os endereços de e-mail dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de e-mail. Quando a condição é cumprida, um e-mail é enviado para indivíduos específicos.
        • Se você selecionou a opção Mensagem de chat de grupo , selecione um bate-papo em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat de grupo.
        • Se selecionaste a opção de publicação do canal , seleciona uma equipa e um canal nas listas suspensas. Quando a condição é cumprida, uma mensagem é publicada no canal selecionado.
     3. Para o Título, introduza o título da notificação do Teams.
     4. Para Notas, introduza notas para a notificação do Teams.

        Observação

        Ao inserir assunto, título ou anotações, você pode fazer referência às propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

     5. Para Contexto, selecione os valores da lista suspensa para incluir na notificação do Teams.

     

   • Executar atividades Fabric: Para configurar o alerta para lançar um pipeline Fabric, trabalho Spark ou notebook quando a condição for cumprida, siga estes passos:

     1. Para a opção Select action, selecione Run Pipeline, Run Spark job, Run Notebook ou Run Function (pré-visualização).
     2. Ao selecionar o item Fabric a executar, selecione o item Fabric (pipeline, notebook, tarefa Spark ou função) da lista.
     3. Selecione Adicionar parâmetro e especifique o nome do parâmetro para o item Fabric e um valor para ele. Você pode adicionar mais de um parâmetro. Pode passar parâmetros a partir dos dados de alerta escrevendo @ ou selecionando o botão ao lado da caixa de texto. Por exemplo, @BikepointID.

   • Ações personalizadas: Para configurar o alerta para chamar uma ação personalizada quando a condição for cumprida, siga estes passos:

     1. Para Selecionar ação, selecione Criar ação personalizada.

        

     2. Como mencionado na secção de Ações, crie primeiro a regra e depois complete a configuração personalizada das ações seguindo os passos de Trigger ações personalizadas (fluxos do Power Automate).

     3. Depois de criares a ação personalizada, no painel de Definição da regra, seleciona a ação personalizada que criaste na lista suspensa de Ação.

5. Em Guardar localização, especifique onde guardar o alerta do Activator. Escolha um espaço de trabalho existente e salve em um ativador existente ou em um novo.

1. Selecione Criar para criar sua regra de Ativador.