Configurar el rastreo en un flujo de trabajo de CircleCI
En este momento, CI Visibility no está disponible en el sitio () seleccionado.
CircleCI es una plataforma de integración y entrega continuas que permite a los equipos crear, testear y desplegar software a escala.
Configura el rastreo en CircleCI para optimizar el rendimiento de tus pipelines, mejorar la colaboración entre equipos y asegurar procesos de compilación coherentes y conformes.
Compatibilidad
Configurar la integración de Datadog
La integración de Datadog para CircleCI funciona utilizando webhooks para enviar datos a Datadog.
Para cada proyecto, ve a Project Settings > Webhooks* (Configuración del proyecto > Webhooks) en CircleCI y añade un nuevo webhook:
- Webhook Name (Nombre del webhook):
Datadog CI Visibility
o cualquier otro nombre identificador que quieras proporcionar. - Receiver URL (URL del receptor):
https://webhook-intake./api/v2/webhook/?dd-api-key=<API_KEY>
donde <API_KEY>
es tu clave de API de Datadog. - **Certificate verifications (Verificación de certificados): habilita este check.
- Events (Eventos): selecciona
Workflow Completed
y Job Completed
.
Haz clic en Add Webhook (Añadir webhooks) para guardar el nuevo webhook.
Configuración avanzada
Configurar varios proyectos en bloque
Datadog ofrece un script para ayudarte a habilitar los hooks de servicio en varios o todos tus proyectos de CircleCI mediante la API de CircleCI. El script requiere Python 3 y el paquete de requests
.
Para ejecutar este script, necesitas:
- Tu clave de API Datadog
- Un token e dAPI personal de CircleCI
Para más información, puedes ejecutar el siguiente comando:
./service_hooks.py --help
Para configurar hooks en bloque para tus proyectos:
Inicia sesión en tu cuenta de CircleCI y sigue todos los proyectos en los que quieras activar los hooks. Opcionalmente, utiliza el botón Follow All (Seguir todos) de la página Projects (Proyectos).
Ejecuta el script utilizando las variables de entorno DD_API_KEY
y DD_SITE
, o pasando los parámetros indicadores --dd-api-key
y --dd-site
:
Por ejemplo:
./service_hooks.py \
--dd-api-key <DD_API_KEY> \
--circle-token <CIRCLECI_TOKEN> \
--dd-site
\
--threads 4
Establecer etiquetas personalizadas
Para establecer etiquetas personalizadas en todos los pipelines y tramos de trabajo generados por la integración, añade a la Receiver URL (URL del receptor) un parámetro de consulta codificado en URL tags
con pares key:value
separados por comas.
Si un par key:value
contiene alguna coma, enciérralo entre comillas. Por ejemplo, para añadir key1:value1,"key2: value with , comma",key3:value3
, habría que añadir la siguiente cadena a Receiver URL (URL del receptor): ?tags=key1%3Avalue1%2C%22key2%3A+value+with+%2C+comma%22%2Ckey3%3Avalue3
.
Integración con los equipos de Datadg
Para mostrar y filtrar los equipos asociados a tus pipelines, añade team:<your-team>
como una etiqueta personalizada. El nombre de etiqueta personalizada debe coincidir exactamente con el nombre de tu equipo en Equipos de Datadog.
Recopilar logs de trabajo
La integración de Datadog CircleCI recopila logs de tus trabajos de CircleCI finalizados y los reenvía a Datadog. Para instalar y configurar esta integración, consulta la documentación de la integración de CircleCI.
Los logs se facturan por separado de CI Visibility. La retención, la exclusión y los índices de logs se configuran en Log Management. Los logs para los trabajos de CircleCI se pueden identificar por las etiquetas datadog.product:cipipeline
y source:circleci
.
Visualizar los datos de pipeline en Datadog
Las páginas CI Pipeline List (Lista de pipelines de CI) y Executions (Ejecuciones) se rellenan con datos una vez finalizados los flujos de trabajo.
La página CI Pipeline List (Lista de pipelines de CI) muestra datos sólo para la rama por defecto de cada repositorio. Para obtener más información, consulta Buscar y gestionar pipelines de CI.
Referencias adicionales
Más enlaces, artículos y documentación útiles: