Información general

Se utilizan eventos de despliegue para calcular la frecuencia de despliegue, el tiempo de espera de cambio y la tasa de fallas de cambio.

Selección y configuración de una fuente de datos de despliegue

  curl -X POST "https://api.<DD_SITE>/api/v2/dora/deployment" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "DD-API-KEY: ${DD_API_KEY}" \
  -d @- << EOF
  {
    "data": {
      "attributes": {
        "service": "shopist",
        "started_at": 1693491974000000000,
        "finished_at": 1693491984000000000,
        "git": {
          "commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588",
          "repository_url": "https://github.com/organization/example-repository"
        },
        "env": "prod",
        "team": "backend"
      }
    }
  }
EOF

export DD_BETA_COMMANDS_ENABLED=1
export DD_SITE="<DD_SITE>"
export DD_API_KEY="<DD_API_KEY>"

export deploy_start=`date +%s`
./your-deploy-script.sh
datadog-ci dora deployment --service shopist --env prod \
    --started-at $deploy_start --finished-at `date +%s` \
    --git-repository-url "https://github.com/organization/example-repository" \
    --git-commit-sha 66adc9350f2cc9b250b69abddab733dd55e1a588

Cálculo de la frecuencia de despliegue

La frecuencia de despliegue se calcula en función de la métrica dora.deployments.count que se genera y aumenta con cada despliegue detectado desde tu fuente de datos de despliegue seleccionada. La frecuencia se calcula dividiendo dora.deployments.count entre un periodo de tiempo específico.

Cálculo del tiempo de espera de cambio

Para una única confirmación de Git, el tiempo de espera de cambio (CLT) se calcula como el tiempo transcurrido desde la creación de la confirmación hasta el momento en que se ejecutó el despliegue que incluía dicha confirmación.

Para calcular el tiempo de espera de cambio de un despliegue, Datadog ejecuta git log entre el SHA del confirmación de despliegue y el SHA de confirmación de despliegue anterior para encontrar todas las confirmaciones que se están desplegando. A continuación, calcula la media de los valores de tiempo de espera de cambio relacionados para todas estas confirmaciones. Datadog no almacena el contenido real de los archivos de tu repositorio, sólo los objetos de árbol y confirmación de Git.

Para obtener más información sobre el desglose de la métrica del tiempo de espera de cambio, consulta Datos recopilados.

Sincronizar los metadatos del repositorio con Datadog

Reporting commit 007f7f466e035b052415134600ea899693e7bb34 from repository git@github.com:organization/example-repository.git.
180 tracked file paths will be reported.
✅  Handled in 0.077 seconds.

Manejo de varios servicios en el mismo repositorio

Si el código fuente de varios servicios está presente en el mismo repositorio, se necesitan acciones adicionales para asegurar que el tiempo de espera de cambio se calcule teniendo en cuenta sólo las confirmaciones que afectan al servicio específico que se está desplegando.

Para filtrar las confirmaciones medidas a sólo las que afectan al servicio, especifica los patrones de las rutas de archivos glob del código fuente en la definición de servicios.

Si la definición de servicios contiene una URL completa de GitHub a la carpeta de la aplicación, se utilizará automáticamente un único patrón de ruta.

Ejemplo (versión del esquema v2.2):

links:
  - name: shopist
    type: repo
    provider: github
    url: https://github.com/organization/example-repository/tree/main/src/apps/shopist

Las métricas de DORA para el servicio shopist sólo consideran las confirmaciones de Git que incluyen cambios en src/apps/shopist/**. Puedes configurar un control más granular del filtrado con extensions[datadoghq.com/dora-metrics].

Ejemplo (versión del esquema v2.2):

extensions:
  datadoghq.com/dora-metrics:
    source_patterns:
      - src/apps/shopist/**
      - src/libs/utils/**

Las métricas de DORA para el servicio shopist sólo tienen en cuenta las confirmaciones de Git que incluyen cambios en src/apps/shopist/** o src/libs/utils/**.

Si se definen las dos entradas de metadatos para un servicio, sólo se tiene en cuenta extensions[datadoghq.com/dora-metrics] para filtrar los confirmaciones.

Limitaciones

• Las métricas del desglose por etapas del tiempo de espera de cambio sólo están disponibles para GitHub.
• El tiempo de espera de cambio no está disponible para el primer despliegue de un servicio que incluya información de Git.
• El cálculo del tiempo de espera de cambio incluye un máximo de 5000 confirmaciones por despliegue.
• Para las ramas recalculadas, los cálculos del tiempo de espera de cambio consideran las nuevas confirmaciones creadas durante el recálculo, no las confirmaciones originales.
• Cuando se utiliza “Squash” para fusionar solicitudes de extracción:
  • Para GitHub: se emiten métricas para las confirmaciones originales.
  • Para otros proveedores de git: se emiten métricas para la nueva confirmación añadida a la rama de destino.

Cálculo de la tasa de fallas de cambio

La tasa de fallas de cambio se calcula dividiendo dora.incidents.count entre dora.deployments.count para los mismos servicios y/o equipos asociados con un incidente y con un evento de despliegue.

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Más información sobre la configuración de datos sobre fallas en métricas de DORADOCUMENTACIÓN Más información sobre el catálogo de serviciosDOCUMENTACIÓN Más información sobre la herramienta Datadog-ci CLICÓDIGO FUENTE Más información sobre la visibilidad del despliegueDOCUMENTACIÓN