Azure DevOps proporciona funciones que las organizaciones utilizan para crear y desarrollar productos más rápidamente. Integra Datadog con Azure DevOps para:
- Rastrear solicitudes y fusiones a tus distintos proyectos.
- Monitorizar eventos de lanzamiento y creación en contexto con otros datos de tu stack tecnológico.
- Rastrear duraciones de las creaciones y los elementos de trabajo finalizados.
- Realizar un rastreo de los elementos de trabajo y las actualizaciones.
Configuración
Instalación
En Datadog, haz clic en el botón de instalación del ícono de integración de Azure DevOps.
Configuración
Utiliza un gancho de servicio para crear eventos y métricas en Datadog en respuesta a eventos de servicios de Azure DevOps:
- En Azure, ve a la página de enlaces de servicios de tu proyecto.
- Haz clic en Crear suscripción.
- Elige el servicio Datadog.
- Configura la activación del evento de Visual Studio.
- Introduce tu clave de la API de Datadog en el campo obligatorio.
- Añade el sitio de tu organización Datadog:
- Haz un test de la suscripción al enlace del servicio y finaliza el asistente. Nota: El test no valida su clave de la API ni el sitio de la organización Datadog.
- Repite los pasos 4-7 para cada tipo de evento que desees enviar a Datadog. Se aceptan todos los tipos de evento.
Una vez configurados tus enlaces de servicios, ve a Datadog para ver eventos y métricas de Azure DevOps.
Referencia adicional de Azure: Crear un enlace de servicio para servicios de Azure DevOps y TFS con Datadog
Programática
Sigue la documentación de Azure para Crear una suscripción a enlaces de servicios mediante programación y utiliza el endpoint de Datadog:
https:///intake/webhook/azuredevops?api_key=<DATADOG_API_KEY>
Utiliza monitores de Datadog como puertas en pipelines de Azure
También puedes utilizar monitores de Datadog como puertas para controlar las implementaciones de lanzamiento en Azure Pipelines. Esta opción permite detener automáticamente las implementaciones problemáticas si se detecta un estado que es bueno en Datadog.
Añade la extensión Datadog Monitors as puertas de implementación a tu organización Azure DevOps.
En Azure DevOps, ve a Conexiones al servicio en la configuración de tu proyecto y selecciona Nueva conexión al servicio.
Selecciona Datadog de la lista y pulsa Siguiente.
En los campos proporcionados, añade tu clave de la API de Datadog y la clave de la aplicación para la cuenta que deseas utilizar y, a continuación, introduce un nombre y una descripción para identificar esta cuenta de Datadog en Azure DevOps. Haz clic en Guardar. Puedes añadir conexiones a servicios adicionales si necesitas consultar monitores desde varias cuentas de Datadog.
Ve a Azure Pipelines para configurar tu implementación. Aquí, hay una opción para añadir condiciones anteriores o posteriores a la implementación entre etapas. Selecciona dónde deseas añadir el monitor de Datadog y, a continuación, activa el conmutador de alternancia de Puertas.
Haz clic en Añadir y selecciona la opción Consultar monitores de Datadog.
Selecciona la conexión al servicio de Datadog y, a continuación, introduce tu ID del monitor y el umbral de gravedad que deseas utilizar. El umbral de gravedad es el estado de monitor (ya sea Alert
o Warning
) en el que falla la tarea.
Repite los pasos 5-7 para añadir puertas adicionales según sea necesario en tu pipeline de implementación.
Nota: Utiliza monitores compuestos para monitorizar varias condiciones de las puertas en tu pipeline como parte de un único estado para cada etapa.
Para ver el código fuente, consulta el Informe de la extensión de puerta de Monitor de Azure Devops".
Datos recopilados
Métricas
azure.devops.event.count (counter) | The total number of events. Shown as event |
azure.devops.build.duration (gauge) | The duration of a build. Shown as second |
azure.devops.release.duration (gauge) | The duration of a release. Shown as second |
azure.devops.work_item.duration (gauge) | The lifetime duration of a work item. Shown as hour |
Eventos
La integración de Azure DevOps admite los siguientes tipos de eventos de enlaces a servicios:
- Creación y lanzamiento
- Elementos de trabajo
- Código
Checks de servicios
La integración de Azure DevOps no incluye ningún check de servicio.
Resolución de problemas
¿Necesitas ayuda? Ponte en contacto con Soporte técnico de Datadog.
FAQ
¿Se cobra un costo adicional por esta integración?
Las métricas y eventos generados a partir de esta integración no suponen ningún costo adicional.
¿Cuánto tiempo permanecen estos datos en Datadog?
Los datos de esta integración se mantienen durante 15 meses, de forma similar a otros tipos de datos de series temporales en Datadog.
¿Cuánto tiempo tardan en aparecer los eventos y las métricas en Datadog?
La latencia total tiene muchas variables, pero, en la mayoría de los casos, los eventos y las métricas se muestran en Datadog antes de que transcurran 30 segundos desde que se produce el incidente.
¿Qué puedes hacer con los eventos y las métricas de Azure DevOps en Datadog?
Los eventos y las métricas pueden utilizarse como otros eventos y métricas en Datadog, incluidos crear dashboards, configurar monitores y solucionar problemas.
¿Cómo se generan las métricas para la duración de la creación y la duración del elemento de trabajo?
La duración de la creación se genera a partir de eventos build completed tomando la diferencia de tiempo entre el momento en que se inició la creación y el momento en que finalizó (medida en segundos).
La duración del elemento de trabajo se genera a partir de eventos work item updated tomando la diferencia de tiempo entre la transición a Done
y el momento en que se creó el elemento de trabajo (medida en horas).
Nota: Si se vuelve a abrir un elemento de trabajo de Done
, la próxima vez que se pase a Done
se generará otro punto de datos. El punto de datos inicial no se modifica y el nuevo punto de datos sigue midiendo desde el momento en que se creó inicialmente el elemento de trabajo.
Tu test de suscripción de enlace de servicio devuelve un mensaje de éxito, ¿por qué no llegan eventos a Datadog?
El test de suscripción de enlace de servicio solo hace checks si Azure DevOps puede enviar eventos a Datadog. No valida tu clave de la API ni el sitio de tu organización Datadog (EE. UU. o UE). Asegúrate de que la clave de la API y el sitio sean correctos.
Leer más
Additional helpful documentation, links, and articles: