Crea alertas

Si tienes los permisos de usuario adecuados, puedes crear alertas en los mosaicos basados en consultas o vinculados a la vista en paneles definidos por el usuario o en paneles de LookML.

Crea una alerta

Las alertas se pueden configurar solo en mosaicos que tienen al menos una medida numérica o un cálculo de tabla en la visualización del mosaico. El tipo de visualización y los campos presentes en la visualización del mosaico del panel determinan si puedes establecer una condición de alerta que se base en un solo campo o en un valor de cálculo de tabla, o en “cualquiera” campo o valor de cálculo basado en tablas.

Según el tipo de visualización del mosaico del panel y los tipos de campos que estén presentes en la visualización, Looker verifica tus datos de diferentes maneras. Cuando crees una alerta, será de uno de los siguientes tipos:

  • Alertas de valor único (que se usan solo con visualizaciones de un solo valor): Looker verifica los datos según el valor que se usa en la visualización, que es la primera fila de la tabla de resultados.
  • Alertas de series temporales (se usan cuando hay una dimensión de fecha u hora en los resultados de la consulta): Looker verifica todas las filas nuevas que no se hayan visto antes (según la dimensión de fecha o de hora de la consulta).
  • Alertas categóricas (ni de valor único ni series temporales): Looker verifica todas las filas y los valores de tabla dinámica, a menos que se haya seleccionado una fila o un valor de tabla dinámica específicos cuando se creó la alerta.

No se admiten las alertas basadas en un cálculo basado en tablas que incluye un total de fila.

Para crear alertas, tu panel debe estar fuera del modo de edición y del Modo de desarrollo.

Para crear una alerta en un mosaico del panel, haz clic en el ícono de campana del mosaico y, luego, en el botón Nuevo al final de la lista de alertas existentes que se pueden ver (es posible que debas desplazarte para ver la lista completa). Si aún no se configuró ninguna alerta para ese mosaico o si no tienes permiso para ver ninguna alerta existente en ese mosaico, mantén el puntero sobre el mosaico del panel para que aparezca el ícono de Alertas en forma de campana. Haz clic en el ícono de Alertas en forma de campana del panel para abrir el diálogo de creación de alertas.

En la ventana de creación de alertas, puedes especificar varios componentes:

Cada consulta de alertas captura la configuración del panel y de los mosaicos en el momento en que se creó la alerta. Sin embargo, una alerta se sincroniza con muchos de los tipos de cambios comunes que tú y otros usuarios realizan en el panel o la tarjeta subyacentes, sin necesidad de volver a crear la alerta. Consulta la página de documentación Efectos de las ediciones del panel en las alertas para obtener más información.

Nombra una alerta

El título predeterminado de la alerta indica qué condiciones deben cumplirse para que se active la alerta. Si deseas cambiar el nombre de tu alerta, sigue estos pasos:

  1. Haz clic en el menú de tres puntos y, luego, en Editar alerta.
  2. Haz clic una vez en el título de la alerta.
  3. Ingresa un título personalizado y, luego, haz clic fuera del campo o presiona la tecla Intro para ver la actualización.
  4. Haz clic en Guardar alerta para guardar el título nuevo.

El título de tu alerta personalizada aparecerá en todas las alertas visibles públicamente que se incluyan en la ventana de vista de alertas de ese mosaico. El título personalizado también aparecerá en las notificaciones de alerta.

Coloca el cursor sobre el título personalizado de cualquier alerta en la ventana de vista de alerta para ver las condiciones que la activan.

Configura condiciones de alerta

En los menús desplegables Condición de la ventana de creación de alertas, puedes configurar los componentes que le indican a Looker cómo verificar los datos de las tarjetas en busca de cambios y los tipos de cambios que activan una notificación de alerta.

La condición de alerta se representa con estos componentes:

  • La lista de campos o cálculos basados en tablas que aparecen en la visualización del mosaico del panel
  • El cambio que deben someterse a los cálculos de tablas, campos, campos o campos seleccionados para activar la notificación de alerta
  • La magnitud del cambio que activaría la notificación de alerta

Entre estas condiciones, se incluyen las siguientes:

  • Es mayor que
  • Es inferior a
  • Es igual a
  • Es mayor o igual que
  • Es menor o igual que

Si la consulta contiene un campo de fecha o de hora, se mostrarán las siguientes condiciones adicionales:

  • Aumenta en
  • Disminuye en
  • Cambios en (una combinación de Aumenta un y Disminuye un)

El uso de estas condiciones de comparación con datos de series temporales tiene algunas consideraciones adicionales. Para obtener más información, consulta esta página de prácticas recomendadas en Configura alertas según datos de series temporales.

Puedes crear alertas basadas solo en comparaciones de números enteros y valores de datos decimales. Para establecer alertas basadas en cambios porcentuales de los valores de los datos, consulta la página de prácticas recomendadas Cómo establecer condiciones de alerta según los cambios porcentuales de los valores de los datos.

Configura las notificaciones de alerta

En la sección Dónde enviarla de la ventana de creación de alertas, puedes especificar el destino de la notificación de alerta.

Envío de alertas por correo electrónico

Para enviar las notificaciones de alerta por correo electrónico, selecciona Correo electrónico en el menú desplegable Dónde enviarlo. Puedes designar los destinatarios de la notificación por correo electrónico de alerta. Tu correo electrónico se mostrará de forma predeterminada, y podrás modificar la lista de destinatarios según sea necesario. Tus permisos determinan a qué dominios de correo electrónico puedes enviar notificaciones de alerta.

Cada destinatario recibirá un correo electrónico con información sobre la alerta y una opción para dejar de seguirla. Si decide dejar de seguir la alerta, su dirección de correo electrónico se quitará de la lista de destinatarios.

En el caso de los paneles incorporados, puedes personalizar la URL que proporcionas para que los destinatarios vinculen a Looker. Para usar esta opción, un administrador de Looker o un usuario con los permisos schedule_look_emails o create_alerts primero deben especificar los dominios permitidos para el vínculo personalizado y seleccionar el formato de la URL del vínculo personalizado en la página Incorporar en el menú Administrador.

  • En el campo Dominio, selecciona uno de los dominios disponibles.
  • En el campo Ruta de acceso, ingresa una ruta al panel, como /dashboards/12 o /reports/salesoverview. La opción Ruta solo se muestra si la URL definida por el usuario está seleccionada en el campo Seleccionar la ruta de acceso al contenido de la página Incorporar en el menú Administrador.
  • En el campo Etiqueta de URL, de forma opcional, ingresa texto nuevo para el vínculo que dirige al contenido. Este campo mostrará todo el texto que se ingrese en el campo Etiqueta de URL en la página Incorporar en el menú Administrador de forma predeterminada y se puede cambiar en este campo.

Envía alertas a la integración de adjuntos de Slack (token de API)

La acción de adjunto de Slack (token de API) está disponible en el Centro de acciones de Looker. Cuando esta acción esté habilitada en la página Acciones del panel Administrador, se mostrará la opción Archivo adjunto de Slack (token de API) como una opción en el menú desplegable Dónde enviarlo de la ventana de creación de alertas.

Los administradores de las instancias alojadas por el cliente que usan un servidor de concentrador de acciones autoalojado deben reiniciar ese servidor cuando actualicen su instancia de Looker.

Una vez que un administrador de Looker haya habilitado la acción de adjunto de Slack (token de API) y el usuario bot de la app de Looker se haya configurado en Slack, puedes seguir estos pasos para enviar notificaciones de alerta a Slack mediante la integración del adjunto de Slack (token de la API):

  1. Selecciona Adjunto de Slack (token de API) en el menú desplegable Dónde enviarlo.

    Aparecerán los campos Tipo de canal y Compartir en.

    Incluso si los usuarios incorporados tienen permisos para enviar notificaciones de alerta a la integración del adjunto de Slack, no verán el archivo adjunto de Slack (token de API) en el menú desplegable Dónde enviarlo, a menos que su lugar de trabajo de Slack esté configurado para el usuario bot de la aplicación de Looker.

  2. Usa el campo Channel Type a fin de especificar el tipo de destinatario de Slack para la alerta:

    • Canales: Envía la alerta a un canal de Slack.
    • Usuarios: Envía la alerta en un mensaje directo a un usuario de Slack.

    Una vez que selecciones el tipo de canal, el campo Compartir en se propagará con las opciones del canal o del mensaje directo que se apliquen a las credenciales del usuario bot de la aplicación de Looker en el espacio de trabajo de Slack.

  3. En el campo Compartir en, selecciona el mensaje directo o el canal al que deseas enviar la notificación de alerta. El usuario o canal seleccionado recibirá una notificación con información relacionada con la tarjeta en la que se estableció la alerta:

    • Una imagen PNG de la visualización del mosaico del panel
    • Un mensaje con el nombre del panel o el título de la alerta personalizada y las condiciones que activaron la alerta
    • Un vínculo para navegar al panel del mosaico
    • Un vínculo para anular la suscripción a la notificación de alerta

    Para las visualizaciones de valor único, la notificación de Slack incluirá el valor único como texto, en lugar de un archivo PNG de la visualización.

Envía alertas a la integración de Slack

La acción de Slack está disponible en el Centro de acciones de Looker. Cuando esta acción esté habilitada en la página Acciones del panel Administrador, Slack se mostrará como una opción en el menú desplegable Dónde enviarlo de la ventana de creación de alertas. Un administrador de Looker también debe conectar al menos un espacio de trabajo de Slack a la instancia de Looker.

La integración de Slack está disponible para las implementaciones alojadas en Looker que cumplan con las siguientes condiciones:

  • La instancia está en Looker 6.24 o una versión posterior.
  • La función Lista de IP permitidas no está habilitada en la instancia de Looker.

Esta integración de Slack no es compatible con las instancias alojadas por el cliente.

Para habilitar la instalación de la app de Looker, es posible que el propietario de tu espacio de trabajo de Slack deba ajustar la configuración de instalación de la app de tu espacio de trabajo de Slack.

Una vez que un administrador de Looker haya habilitado la acción de Slack y haya conectado los espacios de trabajo de Slack adecuados, podrás enviar notificaciones de alerta a Slack siguiendo estos pasos:

  1. Selecciona Slack en el menú desplegable Dónde enviarlo.

    Si todavía no te autenticaste en Slack, aparecerá el botón Acceder con Slack (Sign in with Slack) en el menú desplegable Where to send it (Dónde enviarlo).

  2. Haz clic en Acceder con Slack. Looker solicitará acceso al espacio de trabajo de Slack. Si tu administrador de Looker conectó varios espacios de trabajo de Slack a tu instancia de Looker, aparecerá un menú desplegable en la esquina superior derecha de la página de OAuth. Selecciona el lugar de trabajo de Slack adecuado en el menú desplegable. Haz clic en Permitir.

    También puedes autenticarte en Slack desde la página de tu cuenta personal en Looker. Si tu administrador de Looker conectó varios espacios de trabajo de Slack a tu instancia de Looker, verás una lista de lugares de trabajo con opciones para acceder a cada uno de manera individual.

    Después de acceder al menos a un lugar de trabajo de Slack, aparecerán los campos Channel Type y Share In.

    Incluso si los usuarios incorporados tienen permisos para enviar notificaciones de alerta a la integración de Slack, a menos que su lugar de trabajo de Slack esté conectado a la instancia de Looker, no verán la opción Slack en el menú desplegable Dónde enviarlo.

  3. En el menú desplegable Lugar de trabajo, se muestra la lista de todos los lugares de trabajo a los que accediste. Selecciona un lugar de trabajo de la lista. Si no ves el lugar de trabajo al que quieres enviar la notificación de alerta, puedes ver una lista de los lugares de trabajo que el administrador de Looker conectó a tu instancia de Looker y acceder a cada uno de forma individual desde la página de tu cuenta personal en Looker.

  4. El campo Compartir en (Share In) se propaga con las opciones de canal y mensaje directo que se basan en el espacio de trabajo de Slack seleccionado. Selecciona el mensaje directo o el canal al que quieres enviar la notificación de alerta. Los usuarios de ese canal verán una notificación con información relacionada con la tarjeta en la que se configuró la alerta:

    • Una imagen PNG de la visualización del mosaico del panel
    • Un mensaje con el nombre del panel o el título de la alerta personalizada y las condiciones que activaron la alerta
    • Un vínculo para navegar al panel del mosaico
    • Un vínculo para anular la suscripción a la notificación de alerta

    Para las visualizaciones de valor único, la notificación de Slack incluirá el valor único como texto, en lugar de un archivo PNG de la visualización.

Configura la frecuencia de las alertas

En la sección Frequency de la ventana de creación de alertas, puedes configurar la frecuencia con la que Looker verifica tus datos en busca de cambios (y envía una notificación de alerta si se cumplen las condiciones de alerta). La frecuencia predeterminada es Diariamente a las 05:00. Las opciones de frecuencia disponibles son las siguientes:

  • Mensualmente en un Día específico del mes (el valor predeterminado es el 1° del mes) en una Hora especificada (el valor predeterminado es 05:00)
  • Semanalmente en un Día específico de la semana (el valor predeterminado es Dom. para el domingo) a una Hora especificada (el valor predeterminado es 05:00)
  • Diariamente en una Hora especificada (el valor predeterminado es 05:00)
  • Cada hora en un intervalo específico (la configuración predeterminada es verificar los datos cada hora) con horas de inicio y finalización especificadas (los valores predeterminados son 05:00 y 17:00). Con los intervalos por hora, puedes hacer que Looker revise los datos en estos intervalos:
    • Hora
    • 2 horas
    • 3 horas
    • 4 horas
    • 6 horas
    • 8 horas
    • 12 horas
  • Minutes en un intervalo específico (la configuración predeterminada es verificar los datos cada 15 minutos) con horas de inicio y finalización especificadas (el valor predeterminado es 05:00 y 17:00) Con los intervalos basados en minutos, puedes hacer que Looker verifique los datos en estos intervalos:
    • 15 minutos
    • 30 minutos

Las horas de inicio y finalización son inclusivas. Por ejemplo, si configuras Verificar cada en 12 horas con una hora de Inicio de 05:00 y una hora de Finalización de 17:00, Looker verificará los datos a las 05:00 y a las 17:00.

Looker envía alertas según la zona horaria que se indica en el parámetro de configuración Zona horaria de la aplicación en la página Configuración del administrador o, si está habilitada, la zona horaria específica del usuario del creador de la alerta.

Configura permisos de alertas

Por motivos de seguridad, otros usuarios no podrán ver ni seguir algunas alertas, y tú no podrás ver ni configurar sus permisos.

Para configurar los permisos de la alerta, selecciona las opciones Público o Privado en el menú desplegable Permisos en la ventana de creación de alertas. Si una alerta se puede seguir, se marcará como Pública de forma predeterminada, lo que significa que cualquier usuario de Looker con permisos de seguimiento en el contenido subyacente del mosaico del panel podrá ver tu alerta y su configuración en la ventana de la vista de alerta. También puede seguir tu alerta para recibir notificaciones por correo electrónico cuando se activen las condiciones de tu alerta.

Puedes configurar tu alerta como Privada para que solo tú y los administradores puedan ver la configuración. Para ello, elige la opción Privado del menú desplegable Permisos en la ventana de creación de alertas.

No se pueden seguir las alertas para las integraciones de Slack y Archivos adjuntos de Slack (token de API). Sin embargo, si creas una alerta para uno de estos destinos y la marcas como Pública, otros usuarios podrán ver y duplicar la configuración de las alertas.