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 Regras , siga estes passos para definir as suas condições de alerta:

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

   

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

   

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

   

   • Se a sua visualização não tiver dimensões, selecione a condição Em cada evento quando para monitorizar alterações no fluxo de dados escolhendo um campo específico a monitorizar.
   • No menu suspenso Quando, defina o valor que se pretende avaliar.
   • No menu suspenso Condição, defina a condição a avaliar. 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 ativado.

4. Na seção 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.

     

   • Enviar Microsoft Teams notificação: Envia uma notificação Microsoft Teams a indivíduos, a um grupo de chat ou a um canal. Pode personalizar o título e o conteúdo da mensagem.

     1. Para selecionar ação, selecione Teams -->Mensagem para indivíduos, Mensagem no chat de grupo ou publicação no canal.
     2. Siga um destes passos dependendo da sua escolha:
        • Se selecionar a opção Mensagem para indivíduos , insira endereços de email dos destinatários ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. Quando a condição é cumprida, é enviada uma mensagem Teams aos indivíduos especificados.
        • Se selecionar a opção Mensagem de chat de grupo, selecione um chat de grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat de grupo.
        • Se selecionar a opção publicação no canal, selecione uma equipa e um canal nas 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 iniciar um pipeline do Fabric, Dataflow, trabalho Spark, notebook ou Função de Dados do Utilizador quando a condição for cumprida, siga estas etapas:

     1. Para Selecionar ação, selecione o tipo de item apropriado de Fabric na secção Executar Atividades de Fabric.
     2. No Selecione o item Fabric para execução, selecione o item Fabric 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. Depois, complete a configuração de ações personalizadas seguindo os passos de Acionar ações personalizadas (fluxos de 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 seguinte consulta retorna um alerta se houver mais de limite de registos na tabela nos ú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 todas as vizinhanças onde o número está acima do limiar, a consulta devolve um único registo (ou seja, um único alerta) 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 Regras , siga estes passos para definir as suas condições de alerta:

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

   

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

   

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

   

   • Se a sua visualização não tiver dimensões, selecione a condição Em cada evento quando para monitorizar alterações no fluxo de dados escolhendo um campo específico a monitorizar.
   • No menu suspenso Quando, defina o valor que se pretende avaliar.
   • No menu suspenso Condição, defina a condição a avaliar. 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 ativado.

4. Na seção 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.

     

   • Enviar Microsoft Teams notificação: Envia uma notificação Microsoft Teams a indivíduos, a um grupo de chat ou a um canal. Pode personalizar o título e o conteúdo da mensagem.

     1. Para selecionar ação, selecione Teams -->Mensagem para indivíduos, Mensagem no chat de grupo ou publicação no canal.
     2. Siga um destes passos dependendo da sua escolha:
        • Se selecionar a opção Mensagem para indivíduos , insira endereços de email dos destinatários ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. Quando a condição é cumprida, é enviada uma mensagem Teams aos indivíduos especificados.
        • Se selecionar a opção Mensagem de chat de grupo, selecione um chat de grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat de grupo.
        • Se selecionar a opção publicação no canal, selecione uma equipa e um canal nas 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.

     

   • Atividades do Fabric: Para configurar o alerta para iniciar um pipeline do Fabric, Dataflow, job Spark, notebook ou Função de Dados do Utilizador (pré-visualização) quando a condição for cumprida, siga estes passos:

     1. Para Selecionar ação, selecione o tipo de item apropriado de Fabric na secção Executar Atividades de Fabric.
     2. No Selecione o item Fabric para execução, selecione o item Fabric 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. Depois, complete a configuração de ações personalizadas seguindo os passos de Acionar ações personalizadas (fluxos de 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.

1. Selecione Criar para criar sua regra de Ativador.