Crea alertas

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

Crea una alerta

Las alertas solo se pueden configurar en mosaicos que tengan al menos una medición numérica o un cálculo basado en tablas en la visualización del mosaico. El tipo de visualización y los campos que están presentes en la visualización del mosaico del panel determinan si puedes establecer una condición de alerta basada en un solo campo o valor de cálculo basado en tablas, o en "cualquier" 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 estos tipos:

  • Alertas de valor único (se usan solo con visualizaciones de valor único): 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 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 en la consulta).

  • Alertas categóricas (no son de valor único ni de 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.

Para crear alertas, el panel no debe estar en modo de edición, y tú no debes estar en el modo de desarrollo.

Para crear una alerta en un mosaico del panel, haz clic en el ícono add_alert Alertas del mosaico y, luego, en el botón Nuevo que se encuentra en la parte inferior de la lista de las alertas existentes que tienes permiso para ver (es posible que debas desplazarte para ver la lista completa). Si aún no se configuraron alertas para ese mosaico o si no tienes permiso para ver las alertas existentes en ese mosaico, mantén el puntero sobre el mosaico del panel para revelar el add_alert Alertas ícono. Haz clic en el ícono add_alert Alertas del mosaico 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 del mosaico en el momento en que se creó la alerta. Sin embargo, una alerta se sincroniza con muchos de los tipos comunes de cambios que tú u otros usuarios realizan en su panel o mosaico subyacente, sin necesidad de volver a crear la alerta. Consulta la página de documentación Efecto de las ediciones del panel en las alertas para obtener más información.

Cómo nombrar una alerta

El título de alerta predeterminado 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 nuevo título.

El título de alerta personalizado aparecerá en cualquier alerta visible públicamente que se muestre 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 alertas para ver las condiciones que activan esa alerta.

Cómo establecer condiciones de alerta

En los menús desplegables Condición de la ventana de creación de alertas, puedes establecer los componentes que le indican a Looker cómo verificar los datos del mosaico 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 basados en tablas que aparecen en la visualización del mosaico del panel
  • El cambio que debe experimentar el campo, los campos, el cálculo basado en tablas o los cálculos basados en tablas seleccionados para activar la notificación de alerta
  • La magnitud del cambio que activaría la notificación de alerta

Estas condiciones incluyen lo siguiente:

  • Es superior a
  • 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, estas condiciones adicionales están disponibles:

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

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

Cómo configurar las notificaciones de alerta

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ía alertas por correo electrónico

Para enviar las notificaciones de alerta por correo electrónico, selecciona Correo electrónico en el menú desplegable Where to send. 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 elige dejar de seguir la alerta, su dirección de correo electrónico se quitará de la lista de destinatarios. Cada destinatario también recibirá una notificación push en su dispositivo móvil si se cumple lo siguiente:

En el caso de los paneles incorporados, puedes personalizar la URL que proporcionas a los destinatarios para que vuelvan 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 Embed del menú Admin.

  • En el campo Domain, selecciona uno de los dominios disponibles.
  • En el campo Path, ingresa una ruta de acceso al panel, como /dashboards/12 o /reports/salesoverview. La opción Path solo se muestra si se selecciona User defined URL en el campo Select content path de la página Embed en el menú Admin.
  • En el campo URL label, puedes ingresar texto nuevo para el vínculo que apunta al contenido. De forma predeterminada, este campo mostrará cualquier texto que se ingrese en el campo URL label de la página Embed en el menú Admin y se puede cambiar en este campo.

Envía alertas a la integración de Slack Attachment (API Token)

La acción Slack Attachment (API Token) está disponible en el Centro de acciones de Looker. Cuando esta acción está habilitada en la página Actions del panel Admin, Slack Attachment (API Token) aparecerá como una opción en el menú desplegable Where to send de la ventana de creación de alertas.

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

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

    Aparecerán los campos Channel Type y Share In.

  2. Usa el campo Channel Type para 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 hayas seleccionado el tipo de canal, el campo Share In se completará con las opciones de canal o mensaje directo que sean aplicables a las credenciales del usuario bot de la app de Looker en el lugar de trabajo de Slack.

  3. En el campo Share In, 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 el mosaico en el 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 alerta personalizado 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

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 Actions del panel Admin, Slack aparecerá como una opción en el menú desplegable Where to send 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 satisfacen estas condiciones:

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 del lugar de trabajo de Slack deba ajustar la configuración de instalación de la app para tu lugar de trabajo de Slack.

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

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

    Si aún no te autenticaste en Slack, aparecerá un botón Sign in with Slack en el menú desplegable Where to send.

  2. Haz clic en Sign in with 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. Haz clic en Permitir.

    También puedes autenticarte en Slack desde la página de tu cuenta personal en Looker. Si el 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 espacio 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 Where to send.

  3. En el menú desplegable Workspace , se muestra una lista de todos los lugares de trabajo en 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 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 Share In 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 en ese canal verá una notificación con información relacionada con el mosaico en el 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 alerta personalizado 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

Cómo configurar la frecuencia de alerta

En la sección Frequency 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 Diariamente a las 05:00. Las opciones de frecuencia disponibles son las siguientes:

  • Mensualmente en un Día especificado del mes (el valor predeterminado es el 1º del mes) a una Hora especificada (el valor predeterminado es 05:00)
  • Semanalmente en un Día especificado de la semana (el valor predeterminado es Dom para el domingo) a una Hora especificada (el valor predeterminado es 05:00)
  • Diariamente a una Hora especificada (el valor predeterminado es 05:00)
  • Por hora en un intervalo especificado (el valor predeterminado es verificar los datos cada hora) con horas de Inicio y Finalización especificadas (el valor predeterminado es 05:00 y 17:00). Con 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 (el valor predeterminado 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 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 estableces 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 Application Time Zone de la página Settings de Admin o, si está habilitada, la zona horaria específica del usuario del creador de la alerta User Specific Time Zone.

Cómo configurar los permisos de alertas

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

Para establecer los permisos de tu alerta, selecciona las opciones Público o Privado en el menú desplegable Permisos de la ventana de creación de alertas. Si se puede seguir una alerta, se marca como Público de forma predeterminada, lo que significa que cualquier usuario de Looker con permisos de seguimiento 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.

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

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