Creación de alertas de Activator a partir de un conjunto de consultas KQL

Establecer alertas en un conjunto de consultas KQL

1. Abra el área de trabajo que contiene el conjunto de consultas KQL.

2. Vaya al conjunto de consultas KQL y selecciónelo para abrirlo.

3. Ejecute una consulta que devuelva una visualización.

4. Una vez que la consulta devuelva resultados, seleccione Establecer alerta en la cinta de opciones superior.

   

Definir las condiciones de la alerta

En el panel lateral Agregar regla que aparece, siga estos pasos para definir las condiciones de alerta:

1. En la sección Detalles , proporcione un nombre para la regla de alerta activator.

   

2. En la sección Supervisión , establezca una frecuencia de tiempo para la frecuencia con la que se ejecuta la consulta. El valor predeterminado es 5 minutos.

   

3. En la sección Condición , especifique las condiciones de alerta de la siguiente manera:

   

   • Si la visualización no tiene dimensiones, puede seleccionar la condición En cada evento cuando para supervisar los cambios en el flujo de datos eligiendo un campo específico para supervisar.
   • En la lista desplegable Cuando, establezca el valor que se va a evaluar.
   • En la lista desplegable Condición, establezca la condición que debe evaluarse. Para obtener más información, consulte Condiciones.
   • En el campo Repetición , establezca el número de veces que se debe cumplir la condición antes de que se desencadene una alerta.

4. En la sección Acción , seleccione una de las acciones siguientes:

   • Enviar notificación por correo electrónico:

     1. En Seleccionar acción, seleccione Enviar correo electrónico.
     2. En Para, escriba la dirección de correo electrónico del receptor o use la lista desplegable para seleccionar una propiedad cuyo valor sea una dirección de correo electrónico. De forma predeterminada, la dirección de correo electrónico se rellena aquí.
     3. En Asunto, escriba el asunto de la notificación por correo electrónico.
     4. En Titular, escriba el titular de la notificación por correo electrónico.
     5. En Notas, escriba notas para la notificación por correo electrónico.

        Nota:

        Al escribir asunto, titular o notas, puede hacer referencia a las propiedades de los datos escribiendo @ o seleccionando el botón situado junto a los cuadros de texto. Por ejemplo: @BikepointID.

     6. En Contexto, seleccione los valores de la lista desplegable que desea incluir en la notificación por correo electrónico.

     

   • Enviar notificación de Microsoft Teams: Envía un mensaje de Microsoft Teams a ti mismo. Puede personalizar el título y el contenido del mensaje.

     1. En Seleccionar acción, seleccione Teams -->Mensaje a individuos o Mensaje de chat grupal, o Publicación en canal.
     2. Siga uno de estos pasos en función de la selección:
        • Si seleccionó la opción Mensaje a usuarios , escriba direcciones de correo electrónico de receptores o use la lista desplegable para seleccionar una propiedad cuyo valor sea una dirección de correo electrónico. Cuando se cumple la condición, se envía un correo electrónico a individuos especificados.
        • Si seleccionó la opción Mensaje de chat en grupo, seleccione un chat de grupo en la lista desplegable. Cuando se cumple la condición, se publica un mensaje en el chat de grupo.
        • Si seleccionó la opción Publicación del canal , seleccione un equipo y un canal en las listas desplegables. Cuando se cumple la condición, se publica un mensaje en el canal seleccionado.
     3. En Encabezado, escriba el encabezado de la notificación de Teams.
     4. En Notas, escriba notas para la notificación de Teams.

        Nota:

        Al escribir asunto, titular o notas, puede hacer referencia a las propiedades de los datos escribiendo @ o seleccionando el botón situado junto a los cuadros de texto. Por ejemplo: @BikepointID.

     5. En Contexto, seleccione los valores de la lista desplegable que desea incluir en la notificación de Teams.

     

   • Ejecutar actividades de Fabric: para configurar la alerta para iniciar una canalización de Fabric, un trabajo de Spark o un cuaderno cuando se cumpla la condición, siga estos pasos:

     1. En Seleccionar acción, seleccione Ejecutar tubería, Ejecutar trabajo de Spark, Ejecutar cuaderno o Ejecutar función (versión preliminar).
     2. En la opción Seleccionar elemento de Fabric que se va a ejecutar, elija el elemento Fabric (canalización, cuaderno, trabajo de Spark o función) de la lista.
     3. Seleccione Agregar parámetro y especifique el nombre del parámetro para el elemento Fabric y un valor para él. Puede agregar más de un parámetro. Puede pasar parámetros de los datos de alerta escribiendo @ o seleccionando el botón situado junto al cuadro de texto. Por ejemplo: @BikepointID.

   • Acciones personalizadas: para configurar la alerta para llamar a una acción personalizada cuando se cumpla la condición, siga estos pasos:

     1. En Seleccionar acción, seleccione Crear acción personalizada.

        

     2. Como se mencionó en la sección Acción, cree primero la regla y, a continuación, complete la configuración de acciones personalizadas siguiendo los pasos descritos en Desencadenar acciones personalizadas (flujos de Power Automate).

     3. Después de crear la acción personalizada, en el panel Definición de la regla, seleccione la acción personalizada que creó en la lista desplegable Acción .

5. En Guardar ubicación, especifica dónde guardar la alerta de Activator. Elige un área de trabajo existente y guárdala en un activador ya existente o en uno nuevo.

   

6. Selecciona Crear para crear la regla de Activator.

Establecer alertas en un conjunto de consultas KQL

1. Abra el área de trabajo que contiene el conjunto de consultas KQL.
2. Vaya al conjunto de consultas KQL y selecciónelo para abrirlo.
3. Ejecute una consulta . Activator comprueba los resultados de esta consulta según la frecuencia de tiempo establecida en un paso posterior y envía una alerta para cada registro devuelto en el conjunto de resultados. Por ejemplo, si una consulta programada devuelve cinco registros, Activator envía cinco alertas.
4. Una vez finalizada la ejecución de la consulta, seleccione Establecer alerta en la cinta de opciones superior.

Ejemplo 1: resultado único cuando el recuento es mayor que el umbral

Por ejemplo, la siguiente consulta devuelve una alerta si hay más registros de umbral en la tabla de los últimos 5 minutos. Las dos últimas líneas de la consulta son clave, en la que se crea el recuento de registros que coinciden con los filtros y solo se devuelve un resultado si el recuento es mayor que el umbral.

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

Ejemplo 2: Crear un único resultado con una matriz de varios valores

En el siguiente ejemplo, la consulta devuelve una alerta si el número de bicicletas de cualquier barrio está por encima del umbral especificado. Para obtener una sola alerta para todos los barrios para los que el número está por encima del umbral, la consulta se crea para devolver un único registro (es decir, una sola alerta), que se realiza mediante el operador make_list(). Para editar la alerta para que contenga la lista de los barrios que alcanzaron el umbral, consulte Opcional: Editar la regla en Activator.

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

Definir las condiciones de la alerta

En el panel lateral Agregar regla que aparece, siga estos pasos para definir las condiciones de alerta:

1. En la sección Detalles , proporcione un nombre para la regla de alerta activator.

   

2. En la sección Supervisión , establezca una frecuencia de tiempo para la frecuencia con la que se ejecuta la consulta. El valor predeterminado es 5 minutos.

   

3. En la sección Condición , especifique las condiciones de alerta de la siguiente manera:

   

   • Si la visualización no tiene dimensiones, puede seleccionar la condición En cada evento cuando para supervisar los cambios en el flujo de datos eligiendo un campo específico para supervisar.
   • En la lista desplegable Cuando, establezca el valor que se va a evaluar.
   • En la lista desplegable Condición, establezca la condición que debe evaluarse. Para obtener más información, consulte Condiciones.
   • En el campo Repetición , establezca el número de veces que se debe cumplir la condición antes de que se desencadene una alerta.

4. En la sección Acción , seleccione una de las acciones siguientes:

   • Enviar notificación por correo electrónico:

     1. En Seleccionar acción, seleccione Enviar correo electrónico.
     2. En Para, escriba la dirección de correo electrónico del receptor o use la lista desplegable para seleccionar una propiedad cuyo valor sea una dirección de correo electrónico. De forma predeterminada, la dirección de correo electrónico se rellena aquí.
     3. En Asunto, escriba el asunto de la notificación por correo electrónico.
     4. En Titular, escriba el titular de la notificación por correo electrónico.
     5. En Notas, escriba notas para la notificación por correo electrónico.

        Nota:

        Al escribir asunto, titular o notas, puede hacer referencia a las propiedades de los datos escribiendo @ o seleccionando el botón situado junto a los cuadros de texto. Por ejemplo: @BikepointID.

     6. En Contexto, seleccione los valores de la lista desplegable que desea incluir en la notificación por correo electrónico.

     

   • Enviar notificación de Microsoft Teams: Envía un mensaje de Microsoft Teams a ti mismo. Puede personalizar el título y el contenido del mensaje.

     1. En Seleccionar acción, seleccione Teams -->Mensaje a individuos o Mensaje de chat grupal, o Publicación en canal.
     2. Siga uno de estos pasos en función de la selección:
        • Si seleccionó la opción Mensaje a usuarios , escriba direcciones de correo electrónico de receptores o use la lista desplegable para seleccionar una propiedad cuyo valor sea una dirección de correo electrónico. Cuando se cumple la condición, se envía un correo electrónico a individuos especificados.
        • Si seleccionó la opción Mensaje de chat en grupo, seleccione un chat de grupo en la lista desplegable. Cuando se cumple la condición, se publica un mensaje en el chat de grupo.
        • Si seleccionó la opción Publicación del canal , seleccione un equipo y un canal en las listas desplegables. Cuando se cumple la condición, se publica un mensaje en el canal seleccionado.
     3. En Encabezado, escriba el encabezado de la notificación de Teams.
     4. En Notas, escriba notas para la notificación de Teams.

        Nota:

        Al escribir asunto, titular o notas, puede hacer referencia a las propiedades de los datos escribiendo @ o seleccionando el botón situado junto a los cuadros de texto. Por ejemplo: @BikepointID.

     5. En Contexto, seleccione los valores de la lista desplegable que desea incluir en la notificación de Teams.

     

   • Ejecutar actividades de Fabric: para configurar la alerta para iniciar una canalización de Fabric, un trabajo de Spark o un cuaderno cuando se cumpla la condición, siga estos pasos:

     1. En Seleccionar acción, seleccione Ejecutar tubería, Ejecutar trabajo de Spark, Ejecutar cuaderno o Ejecutar función (versión preliminar).
     2. En la opción Seleccionar elemento de Fabric que se va a ejecutar, elija el elemento Fabric (canalización, cuaderno, trabajo de Spark o función) de la lista.
     3. Seleccione Agregar parámetro y especifique el nombre del parámetro para el elemento Fabric y un valor para él. Puede agregar más de un parámetro. Puede pasar parámetros de los datos de alerta escribiendo @ o seleccionando el botón situado junto al cuadro de texto. Por ejemplo: @BikepointID.

   • Acciones personalizadas: para configurar la alerta para llamar a una acción personalizada cuando se cumpla la condición, siga estos pasos:

     1. En Seleccionar acción, seleccione Crear acción personalizada.

        

     2. Como se mencionó en la sección Acción, cree primero la regla y, a continuación, complete la configuración de acciones personalizadas siguiendo los pasos descritos en Desencadenar acciones personalizadas (flujos de Power Automate).

     3. Después de crear la acción personalizada, en el panel Definición de la regla, seleccione la acción personalizada que creó en la lista desplegable Acción .

5. En Guardar ubicación, especifica dónde guardar la alerta de Activator. Elige un área de trabajo existente y guárdala en un activador ya existente o en uno nuevo.

1. Selecciona Crear para crear la regla de Activator.