Crea alertas

Si tienes los permisos de usuario adecuados, puedes crear alertas en tarjetas basadas en consultas o vinculadas a vistas en paneles definidos por el usuario o paneles de LookML.

Crea una alerta

Las alertas solo se pueden configurar en tarjetas que tengan al menos una medida numérica o un cálculo basado en tablas en la visualización de la tarjeta. El tipo de visualización y los campos que están presentes en la visualización de tarjetas del panel determinan si puedes establecer una condición de alerta basada en un solo campo o valor de cálculo de tabla, o en "cualquier" campo o valor de cálculo de tabla.

Según el tipo de visualización de la tarjeta 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 estos tipos:

  • Alertas de valor único (se usan solo con visualizaciones de valor único): Looker verifica los datos en función del 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 o hora en los resultados de la consulta): Looker verifica todas las filas nuevas que no se habían visto antes (según la dimensión de fecha o hora en la consulta).
  • Alertas categóricas (ni valores individuales ni series temporales): Looker verifica todas las filas y los valores de pivote, a menos que se haya seleccionado una fila o un valor de pivote específicos cuando se creó la alerta.

No se admiten las alertas que se basan en un cálculo de tabla que incluye un total de fila.

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

Para crear una alerta en una tarjeta del panel, haz clic en el ícono de campana de la tarjeta y, luego, en el botón Nueva que se encuentra en la parte inferior de la lista de alertas existentes que tienes permiso para ver (es posible que debas desplazarte para ver toda la lista). Si aún no se configuraron alertas para esa tarjeta o si no tienes permiso para ver las alertas existentes en ella, coloca el puntero sobre la tarjeta del panel para que aparezca el ícono de Alertas con forma de campana. Haz clic en el ícono de campana Alertas en la tarjeta del panel para abrir el diálogo de creación de alertas.

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

Cada consulta de alerta captura la configuración del panel y la tarjeta 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ú o otros usuarios realizan en su panel o tarjeta subyacente, sin necesidad de volver a crear la alerta. Consulta la página de documentación Efecto de las modificaciones del panel en las alertas para obtener más información.

Cómo asignar un nombre a una alerta

El título predeterminado de la alerta indica qué condiciones deben ser verdaderas para que se active la alerta. Si quieres cambiar el nombre de la 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 la alerta personalizada aparecerá en todas las alertas visibles para el público que se enumeren en la ventana de la vista de alertas de esa tarjeta. El título personalizado también aparecerá en las notificaciones de la alerta.

Coloca el cursor sobre el título personalizado de cualquier alerta en la ventana de la 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 la tarjeta 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:

  • Es la lista de campos o cálculos de tablas que aparecen en la visualización de la tarjeta del panel.
  • El cambio que deben sufrir el campo o los campos seleccionados, o el cálculo de la tabla o los cálculos de la tabla 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 menor que
  • Es igual a
  • Es mayor o igual que
  • Es inferior o igual a

Si la consulta contiene un campo de fecha o hora, están disponibles estas condiciones adicionales:

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

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 sobre cómo configurar alertas basadas en datos de series temporales.

Puedes crear alertas que se basen solo en comparaciones de valores de datos decimales y enteros. 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 basadas en cambios porcentuales de los valores de los datos.

Cómo configurar notificaciones de alertas

En la sección Where to send it 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 tus notificaciones de alerta por correo electrónico, selecciona Correo electrónico en el menú desplegable Dónde enviar. Puedes designar a los destinatarios de la notificación por correo electrónico de la alerta. Tu correo electrónico aparecerá de forma predeterminada, y puedes 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 la vinculen a Looker. Para usar esta opción, un administrador de Looker o un usuario con el permiso schedule_look_emails o create_alerts primero debe especificar los dominios permitidos para el vínculo personalizado y seleccionar el formato de la URL del vínculo personalizado en la página Incrustar del menú Administrador.

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

Cómo enviar alertas a la integración de archivo adjunto de Slack (token de API)

La acción de archivo adjunto de Slack (token de API) está disponible en el Action Hub de Looker. Cuando esta acción esté habilitada en la página Acciones del panel Administrador, Slack Attachment (API Token) aparecerá como una opción en el menú desplegable Where to send it 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 reiniciarlo cuando actualizan 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 de bot de la app de Looker en Slack, puedes seguir estos pasos para enviar notificaciones de alerta a Slack con la integración de archivo adjunto de Slack (token de API):

  1. Selecciona Archivo 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 de archivos adjuntos de Slack, no verán la opción Archivo adjunto de Slack (token de API) en el menú desplegable Dónde enviar, a menos que su espacio de trabajo de Slack esté configurado para el usuario de bot de la app de Looker.

  2. Usa el campo Channel Type para especificar el tipo de destinatario de Slack de 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 de canal o mensaje directo que se apliquen a las credenciales del usuario del bot de la app 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 sobre la tarjeta en la que se configuró la alerta:

    • Una imagen PNG de la visualización de tarjetas 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 la tarjeta
    • Un vínculo para anular la suscripción a la notificación de alerta

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

Envía alertas a la integración de Slack

La acción de Slack está disponible en el Action Hub de Looker. Cuando esta acción esté habilitada en la página Actions del panel Admin, Slack aparecerá como una opción en el menú desplegable Where to send it 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 las implementaciones alojadas en Looker que cumplan con estas condiciones:

  • La instancia está en Looker 6.24 o una versión posterior.
  • La función IP Allowlist 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 lugar de trabajo de Slack deba ajustar la configuración de instalación de la app.

Una vez que un administrador de Looker habilitó la acción de Slack y conectó los espacios de trabajo de Slack adecuados, puedes seguir estos pasos para enviar notificaciones de alertas a Slack:

  1. Selecciona Slack en el menú desplegable Where to send it.

    Si aún no te autenticaste en Slack, aparecerá el botón Acceder con Slack en el menú desplegable Dónde enviarlo.

  2. Haz clic en Acceder con Slack. Looker solicitará acceso al lugar 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 parte 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 espacios de trabajo con opciones para acceder a cada uno de ellos de forma individual.

    Después de haber accedido a, al menos, un lugar de trabajo de Slack, aparecerán los campos Tipo de canal y Compartir en.

    Incluso si los usuarios incorporados tienen permisos para enviar notificaciones de alertas 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 Where to send it.

  3. En el menú desplegable Lugar de trabajo, se muestra una lista de 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 tu administrador de Looker conectó a tu instancia de Looker y acceder a cada uno de ellos de forma individual desde la página de tu cuenta personal en Looker.

  4. El campo Compartir en se completa con las opciones de canal y mensaje directo que se basan en el lugar de trabajo de Slack seleccionado. Selecciona el mensaje directo o el canal al que deseas 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:

    • Una imagen PNG de la visualización de tarjetas 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 la tarjeta
    • Un vínculo para anular la suscripción en la notificación de alerta

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

Cómo configurar la frecuencia de las alertas

En la sección Frecuencia de la ventana de creación de alertas, puedes establecer 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 la alerta). La frecuencia predeterminada es Diaria 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) a una Hora específica (el valor predeterminado es 05:00)
  • Semanalmente en un Día específico de la semana (el valor predeterminado es Dom para domingo) a una Hora específica (el valor predeterminado es 05:00)
  • Diariamente a una hora especificada (el valor predeterminado es 05:00)
  • Cada hora en un intervalo especificado (la opción predeterminada es verificar los datos cada hora) con horas de inicio y final especificadas (la opción 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 especificado (la configuración predeterminada es verificar los datos cada 15 minutos) con horas de inicio y fin especificadas (la configuración predeterminada 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 final son inclusivas. Por ejemplo, si configuras Verificar cada en 12 horas con una hora de inicio a las 05:00 y una hora de finalización a las 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.

Cómo configurar los permisos de las alertas

Por motivos de seguridad, otros usuarios no pueden ver ni seguir algunas alertas, y tú tampoco puedes ver ni establecer sus permisos.

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

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

No se pueden seguir las alertas de las integraciones de Slack y Slack Attachment (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 la alerta.