Enviar notificaciones de monitor a un canal de Microsoft Teams

Conecta tu inquilino de Microsoft a Datadog.

1. En Datadog, ve a Integrations > Microsoft Teams (Integraciones > Microsoft Teams).
2. Haz clic en Add Tenant (Agregar inquilino), que te redirigirá a Microsoft.
3. Sigue las instrucciones y haz clic en OK (Aceptar).

Una vez que el bot se haya añadido al equipo, configura el gestor de notificaciones en Datadog.

1. En un inquilino configurado, haz clic en Add Handle (Añadir gestor). Asigna un nombre al gestor, selecciona el equipo y el canal en los menús desplegables y haz clic en Save (Guardar).

Migrar los conectores de legacy a la integración basada en inquilinos

Microsoft ha anunciado que los conectores de Office 365 para Microsoft Teams quedan obsoletos. Esto tiene los siguientes efectos:

• Todos los conectores de Datadog dejarán de funcionar el 31 de enero de 2025.
• Los conectores de webhooks entrantes sin URL actualizadas dejarán de funcionar el 31 de enero de 2025.
• Todos los conectores dejarán de funcionar el 31 de diciembre de 2025 (previamente era el 1 de octubre de 2024).

Para obtener más información, consulta la entrada de blog de Microsoft.

Para migrar todos los gestores de notificaciones que utilizan actualmente los conectores de Office 365 legacy a integraciones Datadog basadas en inquilinos:

Utilización

Desde un monitor Datadog, envía una notificación a Microsoft Teams utilizando la función @-notification. Envía la notificación a la dirección @teams-<HANDLE>, sustituyendo <HANDLE> por el nombre de tu gestor de Microsoft Teams. Para silenciar un monitor activado desde Microsoft Teams, haz clic en Mute Monitor (Silenciar Monitor), selecciona la Duración del silencio y haz clic en Mute (Silenciar).

Menciones de usuarios

Las menciones de usuarios te permiten notificar a usuarios específicos de tus canales de Microsoft Teams cuando se activan las alertas de monitor. Esto ayuda a garantizar que se notifiquen los eventos importantes a las personas adecuadas. Para mencionar a un usuario específico, sigue los pasos que se indican a continuación para encontrar su nombre principal de usuario (UPN).

**Sintaxis: <at>{User Principal Name}</at>

Ejemplo: <at>user@microsoft.com</at>

Ejemplo de notificación completa: @Teams-CHANNEL_NAME <at>user@microsoft.com</at> <at>another.user@microsoft.com</at>

Para encontrar el nombre principal de usuario (UPN) de un usuario:

1. Método 1 (sólo funciona si el UPN coincide con el correo electrónico):

   • En Microsoft Teams, haz clic en la foto de perfil o en el nombre del usuario para abrir su tarjeta de contacto.
   • El correo electrónico que aparece en el campo Chat suele ser el UPN. Si difieren, utiliza el método 2 a continuación.

2. Método 2 (funciona siempre, pero requiere permisos de Azure Portal):

   • Inicia sesión en el Microsoft Azure Portal.
   • Ve a Microsoft Entra ID > Manage > Users.
   • Localiza al usuario en la lista y copia su UPN de la columna User principal name.

Datadog recomienda probar tus notificaciones de monitor para garantizar una entrega fiable. Para obtener instrucciones, consulta Probar notificaciones.

Dashboards

Puedes publicar snapshots de widgets de dashboard en cualquier equipo o chat. Para consultar la lista de los widgets admitidos, consulta Informes programados.

Para compartir un widget de dashboard en Teams:

1. En Datadog, pasa el ratón por encima del widget de dashboard y pulsa CMD + C o CTRL + C, o haz clic en el botón Copy (Copiar) del menú compartir.
2. Pega el enlace en Teams.

Limitar el acceso de edición

Por defecto, todos los usuarios tienen acceso completo a los inquilinos de Microsoft Teams conectados.

Utiliza el control de acceso granular para limitar los roles que pueden editar un inquilino específico:

1. Mientras visualizas un inquilino, haz clic en el icono de engranaje de la esquina superior derecha para abrir el menú de configuración.
2. Selecciona Permissions (Permisos).
3. Haz clic en Restrict Access (Acceso restringido). El cuadro de diálogo se actualiza para mostrar que los miembros de tu organización tienen acceso de Visor por defecto.
4. Utiliza el desplegable para seleccionar uno o varios roles, equipos o usuarios que pueden editar el inquilino de Microsoft Teams.
5. Haz clic en Add (Añadir). El cuadro de diálogo se actualiza para mostrar que el rol seleccionado tiene el permiso de Editor.
6. Haz clic en Save (Guardar).

Nota: Para conservar tu acceso de edición al inquilino, debes incluir al menos un rol al que pertenezcas antes de guardar.

Si tienes acceso de edición, puedes restablecer el acceso general a un inquilino restringido siguiendo estos pasos:

1. Mientras visualizas el inquilino, haz clic en el icono de engranaje de la esquina superior derecha para abrir el menú de configuración.
2. Selecciona Permissions (Permisos).
3. Haz clic en Restore Full Access (Restablecer acceso completo).
4. Haz clic en Save (Guardar).

Para editar los permisos de los inquilinos a través de la API:

1. Ve al cuadro de la integración Microsoft Teams.
2. Haz clic en la pestaña Inquilinos.
3. Copia el ID de inquilino mostrado para el inquilino seleccionado.
4. Utiliza la API de políticas de restricción, donde el tipo de recurso es integration-account y el ID es microsoft-Teams:<tenant_id>.

¿Qué son los webhooks de Microsoft Workflows?

Workflows / Power Automate es un producto de Microsoft para crear flujos de trabajo automatizados. Microsoft Workflows puede utilizarse para enviar notificaciones con webhooks entrantes. Si no puedes instalar la aplicación Datadog en tu inquilino de Microsoft Teams (recomendado) o si quieres enviar notificaciones a canales privados, puedes configurar gestores Datadog para enviar notificaciones a canales de Microsoft Teams a través de Microsoft Workflows. Esta integración está pensada para su uso con la siguiente plantilla de Microsoft Workflows: Publicar en un canal cuando se recibe una solicitud de webhook

¿Estás migrando conectores legacy a la integración de webhooks de Microsoft Workflows?

Microsoft ha anunciado que los conectores de Office 365 para Microsoft Teams quedan obsoletos y las URL de los conectores existentes dejarán de funcionar el 31 de enero de 2025. Microsoft promueve el uso de webhooks entrantes de Microsoft Workflows como sustituto de los conectores legacy. Sigue los pasos que se indican a continuación para migrar todos los gestores de notificaciones que utilizan actualmente conectores de Office 365 legacy a la integración de webhooks de Microsoft Workflows de Datadog.

Para cada gestor de un conector de notificaciones legacy en el cuadro de la integración Microsoft Teams:

1. Sigue los pasos de configuración para crear un gestor de webhook de flujo de trabajo para el canal de Microsoft Teams elegido.
2. En la sección Webhooks de Microsoft Workflows, asigna al nuevo gestor el mismo nombre que el gestor del conector al que debe sustituir. Por ejemplo, si el gestor del conector legacy se denomina channel-123, asigna el nombre channel-123 a su nuevo gestor en la sección Webhooks de Microsoft Workflows. Este nuevo gestor sustituye al gestor de conector legacy existente.

Crear un webhook de Microsoft Workflows

Requisitos previos

• Para crear un nuevo flujo de trabajo, se requiere una cuenta Microsoft, tanto para la propiedad del flujo de trabajo como para enviar notificaciones a los canales (no es necesario que sean de la misma cuenta Microsoft).
• La cuenta propietaria del flujo de trabajo (configurada en el paso 2 a continuación) es la cuenta que puede editar y renovar el flujo de trabajo. Para facilitar el acceso compartido, utiliza una cuenta de servicio.
• La cuenta que envía notificaciones a los canales (configurada en el paso 8 a continuación) realiza publicaciones como usuario de la cuenta. Esta cuenta debe formar parte del equipo al que quieres enviar notificaciones. Si envías notificaciones a un canal privado, esta cuenta también debe ser añadida al canal. Si quieres darle a esta cuenta un nombre como “Notificaciones Datadog” utiliza una cuenta de servicio.

Instrucciones

Nota: La mayoría de estos pasos están en Microsoft Workflows. Dado que Microsoft realiza cambios en Workflows, es posible que los siguientes pasos no reflejen los cambios más recientes.

1. En Microsoft Teams, añade la aplicación Workflows a todos los equipos a los que quieres enviar notificaciones. Si no puedes añadir la aplicación a tu equipo, sigue las instrucciones de la sección “Canales privados”.

2. Crea un nuevo flujo de trabajo en Power Automate a partir de la plantilla Publicar en un canal cuando se reciba una solicitud de webhook de Microsoft.

3. Elige la cuenta Microsoft que quieres utilizar para ser propietario del flujo de trabajo (utiliza una cuenta de servicio para facilitar el acceso compartido) y luego haz clic en Continue (Continuar).

4. Haz clic en Edit in advanced mode (Editar en modo avanzado).

5. Amplía Enviar cada tarjeta adaptable y luego haz clic en Post card in a chat or channel (Publicar tarjeta en un chat o canal).

6. Utiliza el desplegable Post As (Publicar como) para definir Post as (Publicar como) en Flow bot (Bot de flujo). Las notificaciones aparecerán como enviadas por “<NAME> vía Workflows”. Para recibir estas notificaciones, la aplicación Workflows debe añadirse al equipo elegido. Si se envían notificaciones a un canal privado, Post As (Publicar como) debe definirse en un usuario del canal. Para obtener más información, consulta la sección “Canales privados” a continuación. Nota: Al cambiar Post as (Publicar como) se restablecerá el campo Post in (Publicar en).

7. Para acceder a los desplegables de equipos y canales, elimina los símbolos @ borrándolos o haciendo clic en los iconos X.

8. Utiliza los desplegables para seleccionar el equipo y el canal.

9. Asegúrate de que el flujo de trabajo está conectado a la cuenta de Microsoft prevista para el envío de notificaciones (por ejemplo, una cuenta de servicio denominada “Notificaciones de Datadog”). Las notificaciones aparecerán como enviadas por “<NAME> a través de Workflows”. Esta cuenta debe tener acceso al canal de Microsoft Teams configurado. Para cambiar la cuenta, haz clic en Change connection (Cambiar connection) y sigue las instrucciones para configurar otra cuenta de Microsoft.

10. Pulsa el botón Save (Guardar).

11. Para encontrar el enlace de tu webhook, haz clic en el primer bloque del flujo de trabajo.

12. Asegúrate de que cualquiera pueda activar el flujo y luego copia el enlace.

13. Haz clic en el botón Back (Volver) para ir al dashboard del flujo de trabajo.

14. Comprueba que el flujo de trabajo está activado en el dashboard. Si está desactivado, haz clic en el botón “Turn on” (Activar).

15. En Datadog, ve a Integrations > Microsoft Teams (Integraciones > Microsoft Teams).

16. En la pestaña Configuración, ve a la sección Webhooks de Microsoft Workflows y haz clic en Add Handle (Añadir gestor). Colócale un nombre al gestor (si estás migrando desde un gestor de conector legacy, utiliza el mismo nombre del gestor de conector correspondiente) y pega la URL del webhook.

17. Haz clic en Save (Guardar).

Canales privados

Para enviar notificaciones a canales privados, la cuenta configurada dentro del bloque Publicar tarjeta en chat o canal debe tener acceso al canal. Esto permite que el flujo de trabajo envíe notificaciones en nombre de esa cuenta de usuario.

1. Dentro del bloque Publicar tarjeta en chat o canal, cambia Post as (Publicar como) a User (Usuario).

2. A continuación, para elegir la cuenta, haz clic en Change connection (Cambiar conexión) y sigue las instrucciones para cambiar la cuenta.

Limitaciones

• Si eres cliente de Microsoft 365, los flujos de trabajo se desactivarán automáticamente después de 90 días sin activaciones exitosas. Cuando un flujo de trabajo está a punto de caducar, Microsoft envía un correo electrónico a la cuenta a la que pertenece el flujo de trabajo. Este temporizador de 90 días se puede restablecer ejecutando un test dentro de Microsoft Workflows.

• Cuando se utiliza la plantilla, todos los mensajes se adjuntan con una línea de texto que indica quién ha creado el flujo de trabajo junto con un enlace a la plantilla.

  Para eliminar esto, ve a tu flujo de trabajo y haz clic en Save As (Guardar como) para hacer una copia, ve hasta la copia buscándola dentro de Mis Flujos y utiliza el nuevo webhook del flujo de trabajo copiado en lugar del flujo de trabajo original.

• Microsoft Workflows no admite funciones interactivas para los mensajes que publica (como silenciar monitores directamente desde Microsoft Teams).

• Microsoft Workflows no admite canales compartidos.

• Microsoft Workflows no admite menciones de usuarios cuando se publica un webhook de Workflows como usuario.

Utilización

Desde un monitor Datadog, envía una notificación a Microsoft Teams utilizando la función @-notification. Envía la notificación a la dirección @teams-<HANDLE>, sustituyendo <HANDLE> por el nombre de tu gestor de Microsoft Teams.

Menciones de usuarios con identificadores de webhooks de Microsoft Workflows

Las menciones de usuarios te permiten notificar a usuarios específicos de tus canales de Microsoft Teams cuando se activan las alertas de monitor. Esto ayuda a garantizar que se notifiquen los eventos importantes a las personas adecuadas. Para mencionar a un usuario específico, sigue los pasos que se indican a continuación para encontrar su nombre principal de usuario (UPN).

**Sintaxis: <at>{User Principal Name}</at>

Ejemplo: <at>user@microsoft.com</at>

Ejemplo de notificación completa: @Teams-CHANNEL_NAME <at>user@microsoft.com</at> <at>another.user@microsoft.com</at>

Para encontrar el nombre de usuario principal (UPN) de un usuario:

1. Método 1 (sólo funciona si el UPN coincide con el correo electrónico):

   • En Microsoft Teams, haz clic en la foto de perfil o en el nombre del usuario para abrir su tarjeta de contacto.
   • El correo electrónico que aparece en el campo Chat suele ser el UPN. Si difieren, utiliza el método 2 a continuación.

2. Método 2 (funciona siempre, pero requiere permisos de Azure Portal):

   • Inicia sesión en el Microsoft Azure Portal.
   • Ve a Microsoft Entra ID > Manage > Users.
   • Localiza al usuario en la lista y copia su UPN de la columna User principal name.

Datadog recomienda probar tus notificaciones de monitor para garantizar una entrega fiable. Para obtener instrucciones, consulta Probar notificaciones.

Limitar el acceso de edición

Por defecto, todos los usuarios tienen acceso completo a cada identificador de webhook de Microsoft Workflows.

Utiliza el control de acceso granular para limitar los roles que pueden editar un identificador de webhook de Workflows específico:

1. Mientras visualizas los webhooks de Workflows, pasa el ratón sobre un identificador restringido para revelar las acciones en el lado derecho de la fila.
2. Haz clic en el icono del candado con la etiqueta Permisos.
3. Haz clic en Restrict Access (Acceso restringido). El cuadro de diálogo se actualiza para mostrar que los miembros de tu organización tienen acceso de Visor por defecto.
4. Utiliza el desplegable para seleccionar uno o varios roles, equipos o usuarios que pueden editar el identificador de webhook de Workflows.
5. Haz clic en Add (Añadir). El cuadro de diálogo se actualiza para mostrar que el rol seleccionado tiene el permiso de Editor.
6. Haz clic en Save (Guardar).

Nota: Para conservar tu acceso de edición al identificador de webhook de Workflows, debes incluir al menos un rol al que pertenezcas antes de guardar.

Si tienes acceso de edición, puedes restablecer el acceso general a un identificador de webhook de Workflows restringido siguiendo estos pasos:

1. Mientras visualizas los webhooks de Workflows, pasa el ratón sobre el identificador restringido para revelar las acciones en el lado derecho de la fila.
2. Haz clic en el icono del candado con la etiqueta Permisos.
3. Haz clic en Restore Full Access (Restablecer acceso completo).
4. Haz clic en Save (Guardar).

Para editar permisos de webhooks de Workflows a través de la API:

1. Obtén los ID de webhooks de Workflows utilizando la API de la integración Microsoft Teams .
2. Utiliza la API de políticas de restricción, donde el tipo de recurso es integration-webhook y el ID es microsoft-teams:<workflows_webhook_id>.

Migrar los conectores de legacy a la integración basada en inquilinos

Microsoft ha anunciado que los conectores de Office 365 para Microsoft Teams quedan obsoletos. Esto tiene los siguientes efectos:

• Todos los conectores de Datadog dejarán de funcionar el 31 de enero de 2025.
• Los conectores de webhooks entrantes sin URL actualizadas dejarán de funcionar el 31 de enero de 2025.
• Todos los conectores dejarán de funcionar el 31 de diciembre de 2025 (previamente era el 1 de octubre de 2024).

Para obtener más información, consulta la entrada de blog de Microsoft.

Para migrar todos los gestores de notificaciones que utilizan actualmente los conectores de Office 365 legacy a la integración de Datadog basada en inquilinos:

Migrar conectores legacy a la integración de webhooks de Microsoft Workflows

Microsoft ha anunciado que los conectores de Office 365 para Microsoft Teams quedan obsoletos. Esto tiene los siguientes efectos:

• Todos los conectores de Datadog dejarán de funcionar el 31 de enero de 2025.
• Los conectores de webhooks entrantes sin URL actualizadas dejarán de funcionar el 31 de enero de 2025.
• Todos los conectores dejarán de funcionar el 31 de diciembre de 2025 (previamente era el 1 de octubre de 2024).

Para obtener más información, consulta la entrada de blog de Microsoft.

Para migrar todos los gestores de notificaciones que utilizan actualmente los conectores de Office 365 legacy a la integración de webhooks de Microsoft Workflows de Datadog, consulta Webhooks de Microsoft Workflows.

Configuración del conector (obsoleto)

1. Selecciona el botón ... situado junto al nombre del canal en lista de canales y, a continuación, elige Connectors (Conectores).

2. Busca Datadog y haz clic en Configure (Configurar).

3. En el modal de configuración del conector, copia la URL del webhook.

4. En Datadog, ve a Integrations > Microsoft Teams (Integraciones > Microsoft Teams).

5. En la pestaña Configuration (Configuración), haz clic en Add Handle (Añadir gestor), dale un nombre y pega la URL del webhook.

6. En el modal de configuración del conector, haz clic en Save (Guardar).