Configuración del administrador: Alertas

Los administradores de Looker pueden administrar las alertas que crean todos los usuarios en la página de administración de Alertas, a la que se puede acceder desde la sección Alertas y programas del panel Administrador. En la página de administración de Alertas, se muestra información sobre todas las alertas activas e inactivas.

Los administradores también pueden ver las alertas que crearon o que siguieron, o para las que aparecen como destinatarios, en la página del usuario Administrar alertas. Los usuarios con otros permisos de alertas pueden administrar las alertas que crearon y a las que siguieron desde la página del usuario Administrar alertas.

Información de la alerta

La página de administración Administrar alertas proporciona información sobre todas las alertas de la instancia de Looker. Los administradores y los usuarios a los que se les otorgó el permiso see_alerts pueden ver esta configuración en la tabla de la página del administrador Administrar alertas:

Columna Definición
Nombre de la alerta Es el título de la alerta, que se establece cuando se crea o edita. El título predeterminado de la alerta indica las condiciones que se deben cumplir o superar para que se active la alerta. Haz clic en el nombre de la alerta para abrir la página Detalles de la alerta de esa alerta.
Panel Es el nombre del panel que contiene la tarjeta con la alerta. Haz clic en el vínculo para navegar al panel. Ninguno indica que la alerta no está sincronizada con su panel. Para resolver una alerta no sincronizada, consulta la página de documentación Efecto de las ediciones del panel en las alertas.
Propietario Es el nombre del usuario que creó la alerta.
Tiempo de ejecución prom. Es la duración de la consulta de alerta en segundos.
Se cumplió la condición Un valor o No que indica si se cumplieron las condiciones de la alerta cuando se ejecutó la consulta de la alerta por última vez. Se muestra un símbolo -- si la consulta de alerta aún no se ejecutó o si se ejecutó, pero no se pudo determinar si se cumplieron las condiciones de la alerta. En esta columna, se muestran íconos de advertencia o de error relacionados con cualquier advertencia o error que aparezca cuando se ejecute la consulta de alerta o se envíe la notificación de alerta. Coloca el cursor sobre el ícono de advertencia o error para ver el mensaje de error asociado, si corresponde.

Un ícono de advertencia con una advertencia de alerta inactiva indica que los datos de la tarjeta del panel no cambiaron entre las dos consultas de alerta más recientes. Obtén más información sobre este mensaje en la sección Mensajes de error y advertencia de Alert en esta página.
Frecuencia Es la frecuencia con la que se verifica la alerta para determinar si se cumplieron o superaron las condiciones.
Estado Esta columna indica si la alerta está activa o inhabilitada.

  • Una alerta se marca como Inhabilitada cuando un usuario inhabilita su propia alerta (con el menú de tres puntos) en la ventana emergente de creación de alertas o en la página de usuario de administración de alertas, o cuando un administrador de Looker inhabilita la alerta. Coloca el cursor sobre el estado Inhabilitada para ver la explicación del propietario de la alerta o del administrador de Looker sobre por qué se inhabilitó. Si inhabilitas una alerta, se pausarán las notificaciones para todos los destinatarios, pero la alerta seguirá apareciendo en la ventana de vista de alerta. El propietario de la alerta puede ver que el estado de la alerta aparece como Activo hasta la próxima vez que se ejecute la consulta de la alerta.
  • Si un administrador inhabilita la alerta, los seguidores ya no recibirán notificaciones de alerta.
Siguiendo Un botón que indica tu estado de seguimiento de la alerta. Obtén más información en la sección Sigue alertas en esta página.
Actividad Un vínculo que te dirige a la pestaña Actividad de la alerta en la página Detalles de la alerta
Menú de tres puntos Un menú desde el que puedes realizar acciones adicionales en la alerta. Obtén más información en la sección Opciones de administración de alertas de esta página.

Si un usuario borra el panel o la tarjeta del panel en la que se encuentra la alerta, esta se inhabilitará: Los seguidores o destinatarios ya no recibirán notificaciones cuando se cumplan las condiciones de la alerta. En esta página, el nombre del panel se borrará de inmediato para la alerta. La próxima vez que se ejecute la consulta de alerta, el estado aparecerá como Inhabilitado con un mensaje de cuadro de información que indica que se borró el panel o el elemento del panel (tarjeta). Luego, un administrador puede borrar la alerta de forma permanente desde el menú de tres puntos que se encuentra a la derecha de la alerta.

Cómo filtrar alertas

Para filtrar la lista de alertas, usa la barra de búsqueda Filtrar lista en la parte superior de la página.

Puedes filtrar las alertas por los siguientes atributos:

  • Frecuencia: Es la frecuencia con la que se verifica la alerta para determinar si se cumplieron o superaron las condiciones.
    • Minutos: Muestra todas las alertas con una frecuencia de 15 minutos o 30 minutos.
    • Hourly: Muestra todas las alertas con una frecuencia de Hour, 2 hours, 3 hours, 4 hours, 6 hours, 8 hours o 12 hours.
    • Diario: Muestra todas las alertas con una frecuencia Diaria de cualquier Hora
    • Semanalmente: Muestra todas las alertas con una frecuencia semanal de cualquier Día o Hora.
    • Mensualmente: Muestra todas las alertas con una frecuencia Mensualmente de cualquier Día o Hora.
  • Se cumplió la condición: Indica si se cumplieron las condiciones de la alerta cuando se ejecutó la consulta de la alerta por última vez.
    • : Se cumplieron o superaron las condiciones de alerta
    • No: No se cumplieron ni se superaron las condiciones de alerta.
  • Estado: Indica si la alerta aún se está verificando en función de sus condiciones.
    • Activo: La alerta aún se está verificando en función de sus condiciones.
    • Inhabilitada: La alerta ya no se verifica en función de sus condiciones.

Puedes aplicar varios filtros a los resultados. Para borrar un filtro, haz clic en la x junto al nombre del filtro. Si actualizas el navegador, también se borrarán todos los filtros seleccionados.

Agrupación de alertas

Haz clic en el ícono Agrupar alertas para abrir el menú Agrupar por.

Puedes agrupar alertas de las siguientes maneras:

  • Predeterminado: Sin agrupación
  • Nombres de los paneles: En orden alfabético por el nombre del panel en el que se configuró la alerta
  • Propietario: En orden alfabético por propietario de la alerta

Mensajes de advertencia y error de alerta

En la página de administración Administrar alertas, se muestran los errores o las advertencias que aparecen cuando se ejecuta la consulta de la alerta o se entrega la notificación de la alerta. Los mensajes de error, si corresponde, aparecen cuando colocas el cursor sobre el ícono de advertencia o el ícono de error en la columna Condición cumplida.

En el caso de las alertas configuradas para enviar notificaciones a las integraciones de Slack o Slack Attachment (token de API), el mensaje de error Notification delivery failed with existing configuration aparece cuando la consulta de la alerta determina que se cumplieron las condiciones de la alerta, pero no se pudo entregar la notificación. Este error puede ocurrir si algo de la configuración de Slack cambió desde que se creó la alerta, por ejemplo, si el espacio de trabajo de Slack al que se enviaba la alerta se desconectó de la instancia de Looker, si se borró el canal de Slack al que se enviaba la alerta o si Looker no puede conectarse a las integraciones.

Advertencia: Consulta de datos actualizados

Un ícono de advertencia en la columna Se cumple la condición indica que los datos de la tarjeta del panel en la que se basa la alerta no cambiaron entre las dos consultas de alerta más recientes. Si colocas el cursor sobre este ícono, se mostrará el mensaje Stale Alert Warning y el siguiente texto:

The data for this tile did not change between the two most recent alert queries. Verify that the caching policies defined for this dashboard tile are aligned with the alert frequency.

Existen algunas explicaciones posibles por las que los datos no cambiaron entre las consultas. Si esta advertencia persiste, habla con tu administrador o desarrollador de Looker para verificar que las políticas de almacenamiento en caché definidas para esta tarjeta del panel estén alineadas con el parámetro de configuración de frecuencia de alertas.

Seguimiento de alertas

En la columna Siguiendo, se muestran los botones Dejar de seguir y Seguir en los que se puede hacer clic, y los botones Seguir en los que no se puede hacer clic.

Si estás siguiendo la alerta, verás un botón Dejar de seguir junto a ella. Si haces clic en Dejar de seguir, dejarás de recibir notificaciones cuando se active esta alerta. Después de hacer clic en Dejar de seguir, ocurrirá lo siguiente:

  • Si eres el propietario de la alerta, verás el botón Seguir en esta columna.
  • Si no es tuya, se quitará de esta página una vez que actualices el navegador.
  • Si apareces como destinatario de las notificaciones de una alerta, pero no la seguiste desde la ventana de vista de la alerta, verás un botón Seguir en el que no se puede hacer clic. Para dejar de seguir la alerta, debes anular la suscripción directamente desde la notificación de alerta.

Verás un botón Seguir junto a la alerta que no se puede hacer clic si se cumple alguna de las siguientes condiciones:

Opciones de administración de alertas

A la derecha de cada alerta, hay un menú de tres puntos con las siguientes opciones:

  • Ver alerta
  • Editar alerta
  • Inhabilitar alerta (si la alerta está habilitada actualmente)
  • Habilitar alerta (si la alerta está inhabilitada actualmente)

Haz clic en Ver alerta para abrir la página Detalles de la alerta.

Haz clic en Editar alerta para abrir la ventana de la alerta en la que puedes modificar su configuración. Haz clic en Guardar alerta para guardar los cambios o en Cancelar para cerrar la ventana de alerta sin guardarlos.

Si un usuario borra el panel o la tarjeta del panel en la que se encuentra la alerta, esta se inhabilitará: Los seguidores o destinatarios ya no recibirán notificaciones cuando se cumplan las condiciones de la alerta. En esta página, el propietario de la alerta verá de inmediato que se borró el nombre del panel de la alerta. La próxima vez que se ejecute la consulta de alerta, el Estado de la alerta aparecerá como Inhabilitada.

Página Detalles de la alerta

La página Detalles de la alerta es una ventana emergente que muestra un resumen de la información de la alerta, que configura el propietario. Los propietarios y seguidores de alertas tienen una vista diferente de esta página.

Puedes abrir la página Detalles de la alerta de una de las siguientes maneras:

  1. Haz clic en el menú de tres puntos a la derecha de la alerta y selecciona Ver alerta.
  2. Hacer clic en el título de la alerta

Configura la página Detalles de la alerta

Después de crear una alerta, aparecerá una entrada para esa alerta en la página de administración Administrar alertas. Abre la página Detalles de la alerta para configurar la información sobre la alerta que sus seguidores y destinatarios pueden ver.

Para vincular un panel a una alerta, sigue estos pasos:

  1. Haz clic en el cuadro de texto para agregar contexto sobre las condiciones que activan tu alerta o lo que significa que se active una alerta. Haz clic en Guardar para guardar la descripción.
  2. Haz clic en el botón + Vincular panel de investigación.
  3. En la ventana Link Dashboard to Alert, selecciona la carpeta que contiene el panel y, luego, haz clic en el nombre del panel.

    El nombre del panel vinculado aparecerá en lugar del botón + Vincular panel de investigación. Haz clic en el botón para navegar al panel vinculado. Para borrar el panel vinculado, haz clic en la x que aparece en el nombre del panel. Looker te pedirá que confirmes que quieres borrar el vínculo al panel.

Algunos detalles de las alertas se muestran automáticamente en la página Detalles de la alerta y no se pueden configurar:

  • Información sobre el historial de la alerta (que se indica en la pestaña Actividad de la página)
  • La visualización de la alerta
  • El estado de sincronización del panel y el nombre del panel con el que está asociada la alerta

Estas son otras formas de interactuar con una alerta que te pertenece:

  • Haz clic en el menú de tres puntos de la visualización de la alerta y, luego, en Explorar desde aquí para abrir una función Explorar preconfigurada con la búsqueda de la tarjeta del panel en la que se estableció la alerta.
  • Haz clic en el botón Probar ahora para ejecutar una consulta de alerta instantánea. Si se activa la alerta, se enviará una notificación a su propietario, destinatarios y seguidores.

Haz clic en Listo para cerrar la página Detalles de la alerta.

Cómo ver la página Detalles de la alerta

Puedes ver los detalles de la alerta de una alerta que no te pertenece si apareces como destinatario de esa alerta o si elegiste seguirla. Abre la pestaña Detalles en la página Detalles de alertas para ver la información sobre una alerta que configuró su propietario.

En la pestaña Detalles de la página Detalles de alertas, puedes realizar las siguientes tareas:

  1. Consulta el contexto sobre qué condiciones activan tu alerta o qué significa que se active una alerta.
  2. Haz clic en el panel vinculado para navegar a otro panel que pueda agregar contexto a la consulta de la alerta.
  3. Ver la visualización de la alerta
  4. Consulta el estado de sincronización de alertas.
  5. Haz clic en el menú de tres puntos de la visualización de la alerta y, luego, en Explorar desde aquí para abrir una función Explorar preconfigurada con la consulta de la tarjeta del panel en la que se estableció la alerta.
  6. Haz clic en el botón Probar ahora para ejecutar una consulta de alerta instantánea. Si se activa la alerta, se enviará una notificación a su propietario, destinatarios y seguidores.
  7. Haz clic en Listo para cerrar la página Detalles de la alerta.

Cómo ver la actividad de las alertas

Looker ejecuta una consulta de alerta con la frecuencia especificada para verificar si los datos cumplieron o superaron las condiciones de la alerta. Los resultados de estas verificaciones se convierten en el historial de la alerta. Puedes hacer clic en la pestaña Actividad en la parte superior de la página Detalles de la alerta para ver el historial de la alerta y otra información adicional.

En la pestaña Actividad de la página Detalles de la alerta, puedes realizar las siguientes tareas:

  1. Consulta la frecuencia con la que se verifica la alerta en función de sus condiciones.
  2. Ver los metadatos de las alertas.
  3. Consulta el estado de sincronización de alertas.
  4. Haz clic en el botón Probar ahora para ejecutar una consulta de alerta instantánea. Si se activa la alerta, se enviará una notificación a su propietario, destinatarios y seguidores.
  5. Haz clic en Listo para cerrar la página Detalles de la alerta.

Cómo ver los metadatos de las alertas

La tabla de la pestaña Actividad de la página Detalles de la alerta incluye metadatos sobre cada ejecución de la alerta.

Encabezado Definición Valores posibles
Fecha de ejecución Es la marca de tiempo del momento en que se inició la consulta de alerta. Cualquier marca de tiempo con el formato DD/MM HH:MM

Ejemplo: 05/30 18:25
Run Time Cuánto tiempo tardó en ejecutarse la consulta de alerta Cualquier duración en el formato 0.81s
Actual Es un valor booleano que indica si la consulta de alerta verificó datos que cambiaron entre las dos consultas de alerta más recientes. Si los datos cambiaron o no cambiaron
  • Yes (si los datos cambiaron)
  • No (si los datos no cambiaron)
Origen El origen de los datos a partir de los cuales la consulta de alerta verificó el valor condicional
  • query
  • cache
  • stale cache
  • Si no se aplican query, cache o stale cache, el valor de Source estará en blanco.
Hora de origen La marca de tiempo de la fila de la base de datos desde la que la consulta de alerta verificó el valor condicional Cualquier marca de tiempo con el formato DD/MM HH:MM

Ejemplo: 05/25 16:01
Se cumplió la condición Es un valor booleano que indica si se cumplieron o no las condiciones de la alerta.
  • Yes (se cumplieron las condiciones)
  • No (no se cumplieron las condiciones)
Activador Es el valor condicional que activaría la alerta si se cumple o supera. Cualquier valor numérico
Observadas El valor observado que cumplió o superó las condiciones de la alerta y la activó Cualquier valor numérico
Estado El estado de la consulta de alerta
  • Complete
  • Running
  • Not Started

Cómo ver el estado de sincronización de las alertas

En ambas pestañas de la página Detalles de la alerta, se muestra el estado de sincronización de la alerta y el nombre del panel con el que está asociada:

  • Una marca de verificación verde en círculo indica que la alerta aún está sincronizada con su panel.
  • Un símbolo de advertencia triangular amarillo indica que la alerta se desincronizó de su panel. El estado incluye una marca de tiempo del momento en que se interrumpió la sincronización. Una alerta no sincronizada muestra un valor Ninguno en la columna Panel. Para obtener información sobre cómo resolver una alerta no sincronizada, consulta la página de documentación Efecto de las ediciones del panel en las alertas.