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, siga estos pasos para definir las condiciones de alerta:

1. En la sección Detalles, escriba 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, seleccione la condición On each event when para supervisar los cambios en el flujo de datos eligiendo un campo específico para monitorear los cambios. (Activado en cada evento cuando elija un campo específico para supervisar los cambios en el flujo de datos).
   • En la lista desplegable When (Cuándo ), establezca el valor que se va a evaluar.
   • En la lista desplegable Condición, establezca la condición que se va a evaluar. 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 siguientes acciones:

   • 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 notificaciones de Microsoft Teams: Envía una notificación de Microsoft Teams a personas, un chat grupal o un canal. Puede personalizar el título y el contenido del mensaje.

     1. En Seleccionar acción, seleccione Teams -->Mensaje a individuos, Mensaje de chat grupal, o Publicación de canal.
     2. Siga uno de estos pasos en función de la selección:
        • Si selecciona 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 mensaje de Teams a las personas especificadas.
        • Si selecciona 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 selecciona la opción Publicación de 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 que ejecute una canalización de Fabric, un flujo de datos, un trabajo de Spark, un cuaderno de notas, una Función de datos de usuario, un trabajo de copia (versión preliminar) o publique un evento empresarial (versión preliminar) cuando se cumpla la condición, siga estos pasos:

     1. Para Seleccionar acción, seleccione el tipo de elemento Fabric adecuado en la sección Ejecutar actividades de Fabric.
     2. En Seleccionar elemento Fabric para ejecutar, seleccione el elemento Fabric 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. Los trabajos de copia (versión preliminar) no aceptan parámetros, por lo que este paso no se aplica a ellos.

   • 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. A continuación, complete la configuración de la acción personalizada siguiendo los pasos de Accionar 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 vecindarios en los que el número está por encima del umbral, la consulta devuelve un único registro (es decir, una sola alerta) mediante el operador make_list().

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, siga estos pasos para definir las condiciones de alerta:

1. En la sección Detalles, escriba 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, seleccione la condición On each event when para supervisar los cambios en el flujo de datos eligiendo un campo específico para monitorear los cambios. (Activado en cada evento cuando elija un campo específico para supervisar los cambios en el flujo de datos).
   • En la lista desplegable When (Cuándo ), establezca el valor que se va a evaluar.
   • En la lista desplegable Condición, establezca la condición que se va a evaluar. 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 siguientes acciones:

   • 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 notificaciones de Microsoft Teams: Envía una notificación de Microsoft Teams a personas, un chat grupal o un canal. Puede personalizar el título y el contenido del mensaje.

     1. En Seleccionar acción, seleccione Teams -->Mensaje a individuos, Mensaje de chat grupal, o Publicación de canal.
     2. Siga uno de estos pasos en función de la selección:
        • Si selecciona 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 mensaje de Teams a las personas especificadas.
        • Si selecciona 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 selecciona la opción Publicación de 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 que ejecute una canalización de Fabric, un flujo de datos, un trabajo de Spark, un cuaderno de notas, una Función de datos de usuario, un trabajo de copia (versión preliminar) o publique un evento empresarial (versión preliminar) cuando se cumpla la condición, siga estos pasos:

     1. Para Seleccionar acción, seleccione el tipo de elemento Fabric adecuado en la sección Ejecutar actividades de Fabric.
     2. En Seleccionar elemento Fabric para ejecutar, seleccione el elemento Fabric 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. Los trabajos de copia (versión preliminar) no aceptan parámetros, por lo que este paso no se aplica a ellos.

   • 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. A continuación, complete la configuración de la acción personalizada siguiendo los pasos de Accionar 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. Verá la regla en el panel Reglas del conjunto de consultas KQL.