Administración de destinos de notificaciones

En esta página se explica cómo crear y configurar destinos de notificación para el área de trabajo.

Las notificaciones del sistema son mensajes que indican los momentos en los que el flujo de trabajo experimenta un evento de ejecución (inicio, consecución y error). Por defecto, las notificaciones se envían a las direcciones de correo electrónico de los usuarios, pero los administradores pueden configurar destinos alternativos de notificaciones usando webhooks o la aplicación Databricks Genie para Slack y Microsoft Teams (Beta). Esto le permite crear integraciones controladas por eventos con Azure Databricks.

Los administradores también pueden configurar destinos de notificación para recibir solicitudes de acceso de usuarios del área de trabajo, como solicitudes de privilegios en objetos de Catálogo de Unity.

Debe ser administrador del área de trabajo de Azure Databricks para administrar los destinos de notificación. Una vez configurado un destino, está disponible para todos los usuarios.

Requisitos de red

Para destinos basados en webhook, el punto final receptor debe cumplir los siguientes requisitos:

• Azure Databricks exige el uso de HTTPS para la seguridad. El destino de la notificación debe utilizar certificados SSL (Secure Sockets Layer) firmados por una autoridad de certificación de confianza.
• El destino de la notificación debe agregar tanto el plano de control del área de trabajo como las direcciones IP salientes del plano de datos a su lista de permitidos:

  • Para las direcciones IP de la aplicación web del plano de control, consulte direcciones IP y dominios para los servicios y activos de Azure Databricks.

  • Para las direcciones IP de salida del plano de datos, consulte el ip-ranges.json archivo que Azure Databricks publica. Busque en el archivo la región del plano de datos de su espacio de trabajo e incluya en la lista de permitidos las direcciones IP de salida correspondientes en su pila de red.

    Azure Databricks puede actualizar las direcciones IP de salida con tanta frecuencia como una vez cada 30 días. Las direcciones IP actualizadas se activan tan pronto como 60 días después de la publicación, por lo que revise el archivo periódicamente y actualice la lista de permitidos antes de que se cierre la ventana de activación.

    Para realizar un seguimiento de los cambios entre versiones, guarde las versiones sucesivas del archivo JSON y compare el timestampSeconds valor. Filtre las entradas donde:

    • El service campo es Databricks
    • El platform campo es azure
    • El type campo es outbound

Creación de un nuevo destino de notificaciones

Para configurar un nuevo destino de notificaciones

1. Haga clic en el nombre de usuario en la barra superior del área de trabajo y seleccione Configuración en la lista desplegable.
2. En la sección Administrador del área de trabajo, haga clic en la pestaña Notificaciones.
3. Haga clic en el botón Administrar:
4. Haga clic en +Agregar destino.
5. Seleccione un tipo de destino. Actualmente, se admiten los siguientes destinos:
   • Correo Electrónico
   • Slack
   • Webhook, con autenticación OAuth opcional (Beta)
   • Equipos de Microsoft
   • PagerDuty
6. Configure el destino en función del tipo.
7. Haga clic en Crear.

Cargas útiles de webhooks

El servicio que envía una notificación define la carga útil del webhook. Para conocer las cargas útiles que envían los trabajos, consulta Cargas útiles de webhooks HTTP. Para conocer la carga útil que envían las alertas de SQL de Databricks tras un cambio de estado, consulta Carga útil de webhook de alertas de SQL.

Usar credenciales diferentes para cada destino

La configuración de un destino se almacena de forma segura cifrada en el área de trabajo de Azure Databricks. Para destinos que requieren que proporciones una URL o credenciales, Azure Databricks recomienda usar diferentes credenciales para cada destino configurado. Esto limita el impacto si un endpoint de terceros es comprometido. Entre ellas se incluyen las siguientes:

• Slack usando un webhook: la URL a la que se envía la notificación.
• Microsoft Teams usando un webhook: la URL a la que se envía la notificación.
• PagerDuty: clave de integración que se usa para enrutar de forma única las notificaciones a un servicio PagerDuty.
• Webhook: un nombre de usuario y contraseña para la autenticación HTTP Basic, o un ID de cliente y secreto de cliente para la autenticación OAuth (Beta).

El uso de secretos diferentes para cada destino configurado permite revocar individualmente el acceso de destinos de notificación individuales sin afectar al funcionamiento de todos los demás destinos del área de trabajo de Azure Databricks.

Autenticación OAuth para destinos de webhook

Utiliza las credenciales de cliente OAuth 2.0 para enviar notificaciones a un endpoint que requiera un token de acceso. Azure Databricks obtiene el token de tu proveedor de identidad y lo utiliza para autenticar la solicitud de notificación.

Tu proveedor de identidad debe respaldar la concesión de credenciales del cliente. Tanto el punto final receptor como el token deben usar HTTPS.

Para crear un destino de webhook OAuth:

1. En Notificaciones de Configuración>, haz clic en Gestionar y luego en +Añadir destino.
2. Introduce un nombre y selecciona Webhook para Tipo.
3. Para el modo de autenticación, selecciona OAuth.
4. Escriba los valores siguientes:
   • URL: El endpoint que recibe las notificaciones.
   • ID del cliente y secreto del cliente: Las credenciales emitidas por tu proveedor de identidad.
   • URL del endpoint del token: El endpoint desde el que Azure Databricks obtiene un token de acceso.
   • Ámbitos y audiencia: Introduce estos valores opcionales si tu proveedor de identidad lo requiere. Separa varios ámbitos con comas.
5. Haga clic en Crear.

El ID del cliente, el secreto del cliente y la URL del endpoint del token se requieren juntos. OAuth no puede combinarse con la autenticación HTTP Basic.

Para verificar la configuración, abre el menú de tres puntos del destino y haz clic en Test. Azure Databricks obtiene un token de acceso y envía una notificación de ejemplo. Si la prueba falla, comprueba las credenciales, los ámbitos, la audiencia, los permisos del receptor y el acceso a la red a ambos extremos.

Destino de Slack

Para configurar un destino de Slack mediante webhooks, sigue las instrucciones de Webhooks entrantes para Slack. Pegue la dirección URL generada en el destino de la notificación Azure Databricks. Para usar la aplicación Genie de Databricks en su lugar, consulta los destinos de las aplicaciones Slack y Microsoft Teams Genie.

Destinos de las aplicaciones Slack y Microsoft Teams Genie

Utiliza la aplicación Databricks Genie para conectar tu espacio de trabajo de Slack o el tenant de Microsoft Teams con tu espacio de trabajo de Azure Databricks. Luego selecciona un canal disponible como destino de notificación.

Puedes usar los destinos de la app Genie con las siguientes características:

• Alertas SQL: Slack y Microsoft Teams.
• Solicitudes de acceso al Catálogo de Unity: Slack y Microsoft Teams.
• Notificaciones de modelo de puntos de conexión de servicio: Slack.

Crear un destino para la app Genie

Antes de crear un destino de aplicación Genie, debes instalar la app Genie de Databricks para Slack o Microsoft Teams, conectarla a tu espacio de trabajo de Azure Databricks y añadirla al canal que recibe las notificaciones. Para más detalles sobre la instalación de aplicaciones y los pasos de conexión, consulta Slack o Microsoft Teams.

Para crear un destino de la app Genie:

1. En Notificaciones de Configuración>, haz clic en Gestionar y luego en +Añadir destino.

2. Para Tipo, selecciona Slack o Microsoft Teams y, a continuación, selecciona Usar la aplicación Databricks.

3. Introduce un nombre para el destino.

4. Selecciona el espacio de trabajo o inquilino y el canal:

   • Para Slack, selecciona el espacio de trabajo y canal de Slack.
   • Para Microsoft Teams, seleccione el Inquilino y el Canal. El selector de inquilinos identifica a cada inquilino por los últimos seis caracteres de su ID de inquilino.

   Si no hay espacios de trabajo de Slack ni tenants de Microsoft Teams conectados, haz clic en Conectar un espacio de trabajo de Slack o Conectar un tenant de Teams, respectivamente, y completa la configuración de la app Genie. Vuelve al formulario de destino y haz clic en Actualizar. Si acabas de añadir la app Genie a un canal, haz clic en Recargar canales para actualizar la lista de canales.

5. Haga clic en Crear.

Destino de PagerDuty

Para configurar un destino de PagerDuty:

1. En PagerDuty, añade una integración a tu servicio y selecciona el tipo de integración de la API de eventos V2 .
2. Copia la clave de integración que genere PagerDuty para la integración.
3. En Azure Databricks, pega la clave de integración en el destino de notificación de PagerDuty.

Agregar un webhook a un trabajo

Después de configurar destinos, puede acceder a ellos en la configuración de notificaciones de trabajo de un trabajo. Para obtener más información, consulte Agregar notificaciones a una tarea.

Cada trabajo admite hasta tres destinos del sistema por tipo de evento. Al configurar las notificaciones de trabajo, las direcciones de correo electrónico deben escribirse manualmente.

Limitaciones

Actualmente, los destinos de notificación tienen las siguientes limitaciones:

• Los destinos de notificación por correo electrónico tienen un límite de 1300 caracteres en la longitud de la dirección del destinatario.
• Para cuerpos de notificaciones personalizados, los destinos que no son de correo electrónico como Slack y Microsoft Teams no soportan formato HTML. Algunos destinos de notificación admiten Markdown.
• En el caso de los trabajos, los destinos de correo electrónico deben establecerse manualmente en la configuración del trabajo.