Criar alertas do Activator a partir de um Conjunto de Consultas KQL

Definir alerta em um Conjunto de Consultas KQL

1. Abra a área de trabalho que contém o conjunto de consultas KQL.

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

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

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

   

Definir condições de alerta

No painel lateral Adicionar Regra que aparece, siga estas etapas para definir suas condições de alerta:

1. Na seção Detalhes , forneça um nome para a regra de alerta do Ativador.

   

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

   

3. Na seção Condição , 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.
   • 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 atendida antes que um alerta seja disparado.

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

   • Enviar notificação por email:

     1. Para selecionar a ação, selecione Enviar email.
     2. Para To, insira o endereço de email do receptor ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Por padrão, seu endereço de email é preenchido aqui.
     3. Para Assunto, insira o assunto da notificação por email.
     4. Para o Título, insira a manchete da notificação por email.
     5. Para Anotações, insira anotações para a notificação por email.

        Observação

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

     6. Para o Contexto, selecione, na lista suspensa, os valores que deseja incluir na notificação por e-mail.

     

   • Enviar notificação do Microsoft Teams: envia uma mensagem do Microsoft Teams para si mesmo. Você pode personalizar o título e o conteúdo da mensagem.

     1. Para selecionar a ação, selecione Teams -->Mensagem para individuais ou Mensagem de chat em grupo ou Postagem de Canal.
     2. Siga uma destas etapas dependendo da seleção:
        • Se você selecionou a opção Mensagem para indivíduos, insira os endereços de email dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Quando a condição é atendida, um email é enviado para indivíduos especificados.
        • Se você selecionou a opção Mensagem de chat em grupo, selecione um chat em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat do grupo.
        • Se você selecionou a opção de postagem do Canal , selecione uma equipe e um canal nas listas suspensas. Quando a condição é atendida, uma mensagem é postada no canal selecionado.
     3. Para Título, insira o título da notificação do Teams.
     4. Para anotações, insira anotações para a notificação do Teams.

        Observação

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

     5. Para Contexto, selecione os valores na lista suspensa que você deseja incluir na notificação do Teams.

     

   • Executar atividades do Fabric: para configurar o alerta para iniciar um pipeline do Fabric, um trabalho do Spark ou um notebook quando a condição for atendida, siga estas etapas:

     1. Para selecionar a ação, selecione Executar Pipeline, Executar trabalho do Spark, Executar Notebook ou Executar Função (versão prévia).
     2. Na seleção do item Fabric a ser executado, selecione o item Fabric (pipeline, notebook, trabalho do Spark ou função) na lista.
     3. Selecione Adicionar um 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. Você pode passar parâmetros dos dados de alerta digitando @ 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 atendida, siga estas etapas:

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

        

     2. Conforme mencionado na seção Ação, crie a regra primeiro e conclua a configuração da ação personalizada seguindo as etapas de Disparar ações personalizadas (fluxos do Power Automate).

     3. Depois de criar a ação personalizada, no painel Definição da regra, selecione a ação personalizada criada na lista suspensa Ação .

5. 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.

   

6. Selecione Criar para criar a regra do Activator.

Definir alerta em um Conjunto de Consultas KQL

1. Abra a área de trabalho que contém o conjunto de consultas KQL.
2. Navegue até o conjunto de consultas KQL e selecione-o para abrir.
3. 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.
4. 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), 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 Activator.

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 Adicionar Regra que aparece, siga estas etapas para definir suas condições de alerta:

1. Na seção Detalhes , forneça um nome para a regra de alerta do Ativador.

   

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

   

3. Na seção Condição , 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.
   • 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 atendida antes que um alerta seja disparado.

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

   • Enviar notificação por email:

     1. Para selecionar a ação, selecione Enviar email.
     2. Para To, insira o endereço de email do receptor ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Por padrão, seu endereço de email é preenchido aqui.
     3. Para Assunto, insira o assunto da notificação por email.
     4. Para o Título, insira a manchete da notificação por email.
     5. Para Anotações, insira anotações para a notificação por email.

        Observação

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

     6. Para o Contexto, selecione, na lista suspensa, os valores que deseja incluir na notificação por e-mail.

     

   • Enviar notificação do Microsoft Teams: envia uma mensagem do Microsoft Teams para si mesmo. Você pode personalizar o título e o conteúdo da mensagem.

     1. Para selecionar a ação, selecione Teams -->Mensagem para individuais ou Mensagem de chat em grupo ou Postagem de Canal.
     2. Siga uma destas etapas dependendo da seleção:
        • Se você selecionou a opção Mensagem para indivíduos, insira os endereços de email dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Quando a condição é atendida, um email é enviado para indivíduos especificados.
        • Se você selecionou a opção Mensagem de chat em grupo, selecione um chat em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat do grupo.
        • Se você selecionou a opção de postagem do Canal , selecione uma equipe e um canal nas listas suspensas. Quando a condição é atendida, uma mensagem é postada no canal selecionado.
     3. Para Título, insira o título da notificação do Teams.
     4. Para anotações, insira anotações para a notificação do Teams.

        Observação

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

     5. Para Contexto, selecione os valores na lista suspensa que você deseja incluir na notificação do Teams.

     

   • Executar atividades do Fabric: para configurar o alerta para iniciar um pipeline do Fabric, um trabalho do Spark ou um notebook quando a condição for atendida, siga estas etapas:

     1. Para selecionar a ação, selecione Executar Pipeline, Executar trabalho do Spark, Executar Notebook ou Executar Função (versão prévia).
     2. Na seleção do item Fabric a ser executado, selecione o item Fabric (pipeline, notebook, trabalho do Spark ou função) na lista.
     3. Selecione Adicionar um 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. Você pode passar parâmetros dos dados de alerta digitando @ 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 atendida, siga estas etapas:

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

        

     2. Conforme mencionado na seção Ação, crie a regra primeiro e conclua a configuração da ação personalizada seguindo as etapas de Disparar ações personalizadas (fluxos do Power Automate).

     3. Depois de criar a ação personalizada, no painel Definição da regra, selecione a ação personalizada criada na lista suspensa Ação .

5. 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.

1. Selecione Criar para criar a regra do Activator.