Crea alertas

Si tienes los permisos de usuario adecuados, puedes crear alertas en los mosaicos basados en búsquedas o vinculados por la apariencia en los paneles definidos por el usuario o en los paneles de LookML que usen paneles nuevos o heredados.

Crea una alerta

Las alertas se pueden configurar solo en tarjetas que tengan al menos una medida numérica o un cálculo de la tabla en la visualización de la tarjeta. 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 basada en un valor de cálculo de un solo campo o tabla, o en un valor de cálculo de campo o tabla.

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

  • Alertas de valor único (usadas solo con visualizaciones de un solo valor): Looker verifica los datos según el valor que se use 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 o de hora en los resultados de la consulta): Looker verifica todas las filas nuevas que no se vieron antes (según la dimensión de fecha o de hora de la consulta).
  • Alertas categóricas (ni un solo valor ni una serie temporal): Looker verifica todas las filas y los valores de tabla dinámica, a menos que se haya seleccionado un valor específico de fila o de tabla dinámica cuando se creó la alerta.

No se admiten alertas basadas en un cálculo de tabla que incluya un total de fila.

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

Para crear una alerta en un mosaico del panel, haga clic en el ícono de campana de la tarjeta y, luego, en el botón Nuevo ubicado en la parte inferior de la lista de las alertas existentes que permitió ver (es posible que deba desplazarse para ver la lista completa). Si actualmente no hay alertas configuradas para ese mosaico o si no tienes permiso para ver las alertas existentes en él, desplázate sobre el mosaico del panel a fin de ver el ícono de Alertas con forma de campana. Haga clic en el ícono de Alertas para abrir la ventana de creación de alertas.

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

Cada consulta de alerta captura la configuración del panel y el mosaico en el momento en que se creó la alerta. Una consulta de alerta no detectará ningún cambio que se realice en el panel o en el mosaico después de que se cree, incluidos los cambios en los filtros del panel o la apariencia de la visualización de tu mosaico del panel (como los cambios en el tipo de visualización). Deberá crear una alerta nueva después de que se implementen los cambios para que se apliquen a su alerta y notificaciones.

Una alerta se sincroniza con muchos de los tipos comunes de cambios que usted o algún otro usuario realizan en el panel o la tarjeta subyacente, sin necesidad de recrear la alerta. Consulta la página de documentación Efectos de las modificaciones del panel en las alertas para obtener más información.

Nombra una alerta

El título de la alerta predeterminada indica qué condiciones deben cumplirse para que se active la alerta. Si deseas cambiar el nombre de tu alerta, haz lo siguiente:

  1. Haga 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 su alerta personalizada aparecerá en todas las alertas visibles de forma pública que aparezcan en la ventana de vista de alertas en ese mosaico. El título personalizado también aparecerá en las notificaciones de alertas.

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

Cómo configurar 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 mosaicos en busca de cambios y los tipos de cambios que activan una notificación de alerta.

La condición de alerta está representada por estos componentes:

  • La lista de campos o cálculos de tabla que aparecen en la visualización del mosaico del panel
  • El cambio que se debe realizar en el campo, los campos, el cálculo de la tabla o los cálculos de la tabla 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 inferior o igual a

Si la consulta contiene un campo de fecha o de hora, hay condiciones adicionales disponibles:

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

El uso de estas condiciones de comparación con los datos de series temporales tiene algunas consideraciones adicionales. Para obtener más información, consulta esta página de prácticas recomendadas sobre cómo configurar alertas basadas en datos de series temporales.

Looker solo crea alertas basadas en comparaciones de valores numéricos y números enteros. Sin embargo, con una solución sencilla puede establecer alertas que se basen en cambios porcentuales de los valores de los datos.

Configuración de notificaciones de alerta

En la sección Where to send it de la ventana de creación de alertas, puede especificar el destino de la notificación de la alerta.

Enviando alertas por correo electrónico

Para enviar notificaciones de alerta al correo electrónico, seleccione Correo electrónico en el menú desplegable Dónde enviarlo. Puede designar los destinatarios de la notificación por correo electrónico de alerta. Tu correo electrónico aparecerá en la lista 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 deciden dejar de seguir la alerta, se quitará su dirección de correo electrónico de la lista de destinatarios.

Si está habilitada la función URL personalizadas para alertas y programar correos electrónicosLabs,Look muestra la opción Incluir vínculo personalizado.

En el caso del contenido incorporado, puedes personalizar la URL que proporcionan los destinatarios para que vinculen a Looker.

  • En el campo Dominio, selecciona uno de los dominios disponibles.
  • En el campo Path, puedes ingresar una ruta de acceso al contenido, como /dashboards/12 o /reports/salesoverview. El formato de la ruta debe coincidir con el de Selección de parámetro definido que se establece en la página Configuración del administrador: incorporación.
  • En el campo Etiqueta de la URL, tienes la opción de ingresar un texto nuevo para el vínculo que dirige al contenido.

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

La acción de archivo adjunto de Slack (token de API) está disponible en Looker Action Hub. Cuando se habilita esta acción en la página Acciones del panel Administrador, el Archivo adjunto de Slack (token de API) aparece como opción en el menú desplegable Dónde enviarlo de la ventana de creación de alertas.

Los administradores de instancias alojadas por el cliente que usan un servidor de Action Hub autoalojado deben reiniciar su servidor de Action Hub cuando actualicen su instancia de Looker.

Una vez que un administrador de Looker habilitó la acción de archivo adjunto de Slack (token de API) y se configuró el usuario del bot de la aplicación Looker en Slack, puedes enviar notificaciones de alerta a Slack mediante la integración del archivo adjunto de Slack (token de API).

  1. Seleccione Slack Attachment (API Token) en el menú desplegable Where to send it.

    Los campos Tipo de canal y Compartir aparecerán debajo del menú desplegable Dónde enviarlo.

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

  2. Use 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: Se envía la alerta en un mensaje directo a un usuario de Slack.

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

  3. En el campo Compartir, selecciona el canal o mensaje directo 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 configuró la alerta:

    • Imagen PNG de la visualización de los mosaicos 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 de tarjetas
    • Un vínculo para anular la suscripción a las notificaciones 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 aparecerá como una opción en el menú desplegable Dónde enviarla de la ventana de creación de alertas. Un administrador de Looker también debe conectar al menos un lugar de trabajo de Slack a la instancia de Looker.

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

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

A fin de habilitar la instalación de la aplicación de Looker, es posible que el propietario del lugar de trabajo de Slack deba ajustar la configuración de instalación de la aplicación para el lugar de trabajo de Slack.

Una vez que un administrador de Looker habilite la acción de Slack y conecte los lugares de trabajo de Slack adecuados, podrá enviar notificaciones de alerta a Slack:

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

    Si aún no se ha autenticado en Slack, aparecerá el botón Sign in with Slack (Acceder con Slack) en el menú desplegable Where to send it.

  2. Haga clic en Acceder con Slack. Looker solicitará acceso al lugar de trabajo de Slack. Si el administrador de Looker conectó varios lugares 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. Haga 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 lugares 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 forma individual.

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

    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 una 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 deseas enviar la notificación de alerta, puedes ver una lista de los lugares de trabajo a los que tu administrador de Looker se conectó a tu instancia de Looker y acceder a cada uno de manera individual desde tu página de cuenta personal en Looker.

  4. El campo Compartir en se propaga con las opciones del canal y del mensaje directo que se basan en el lugar de trabajo de Slack seleccionado. Seleccione el mensaje directo o el canal al que desea enviar la notificación de alerta. Cualquier persona de ese canal verá una notificación con información relacionada con la tarjeta en la que se configuró la alerta:

    • Imagen PNG de la visualización de los mosaicos 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 de tarjetas
    • Un vínculo para anular la suscripción a la notificación de alertas

    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.

Configuración de la frecuencia de las alertas

Puedes configurar la frecuencia con la que Looker verificará tus datos en busca de cambios (y enviará una notificación si se cumplen las condiciones correspondientes) en la sección Frecuencia de la ventana de creación de alertas. La frecuencia predeterminada es Diariamente a las 05:00. Estas son las opciones de frecuencia disponibles:

  • Mensual en un día del mes especificado (el valor predeterminado es el 1 del mes) en un valor de Hora especificado (el valor predeterminado es 05:00)
  • Semanal, en un día específico de la semana (el valor predeterminado es dom para el domingo) a una hora específica (el valor predeterminado es 05:00)
  • Diaria en una Hora especificada (el valor predeterminado es 05:00)
  • Cada hora, en un intervalo especificado (la configuración predeterminada es verificar los datos cada hora) con las horas de Inicio y Finalización especificadas (la predeterminada es 05:00 y 17:00). Con los intervalos por hora, puedes hacer que Looker verifique los datos en estos intervalos:
    • Hora
    • 2 horas
    • 3 horas
    • 4 horas
    • 6 horas
    • 8 horas
    • 12 horas
  • Minutos en un intervalo específico (la configuración predeterminada es verificar los datos cada 15 minutos) con las horas de Inicio y Finalización especificadas (las 05:00 y 17:00 son las predeterminadas). 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 fin son inclusivas. Por ejemplo, si configuras Check every como 12 hours con Start start de 05:00 y End End of 17:00, Looker will check the data at 05:00 and 17:00.

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

Configura permisos de alertas

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

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

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

Por motivos de seguridad, otros usuarios no pueden ver ni seguir algunas alertas, y no podrá ver ni configurar los permisos de las alertas.