Datadog proporciona reglas predeterminadas para que puedas empezar a utilizar Scorecards rápidamente, pero también puedes crear reglas personalizadas.

Creación de reglas personalizadas

Para añadir y evaluar reglas personalizadas mediante la API de Scorecards:

1. Especifica el nombre de la regla, la scorecard a la que pertenece, una descripción de la regla y un propietario para pasarla a /scorecard/rules.
2. Envía un resultado pass, fail o skip por cada tupla {rule, entity} que estés evaluando a /scorecard/outcomes/batch.
3. Ve un resumen de los resultados y las observaciones en el dashboard de Scorecards.

Tras la configuración inicial, las reglas también pueden activarse o desactivarse a través de la API.

Para evaluar y añadir reglas personalizadas en la interfaz de Scorecards:

1. Haz clic en Create Rule (Crear regla) en la página de scorecards.
2. Especifica el nombre de la regla, la scorecard a la que pertenece, una descripción de la regla, el equipo propietario, a qué nivel pertenece la regla y un contexto de aplicación, si es necesario.
3. Ve a la regla que creaste y selecciona Edit Outcome (Editar resultado), junto a la entidad que quieres evaluar.
4. Selecciona el resultado pertinente de pass, fail o skip y añade una observación opcional que describa el motivo del resultado.
5. Ve un resumen de los resultados y las observaciones en el dashboard de Scorecards.

Evaluar reglas personalizadas mediante Workflow Automation

Workflow Automation te permite automatizar la evaluación de tus reglas personalizadas en Datadog utilizando la acción Update scorecard rule outcome (Actualizar resultado de regla de scorecard).

Cuando creas una regla personalizada, puedes evaluarla utilizando una de las siguientes opciones:

• Añadir flujo de trabajo:
  • Crea un flujo de trabajo desde cero.
  • Crea un flujo de trabajo a partir de un plano de scorecards.
  • Vincula un flujo de trabajo personalizado existente.
• Utiliza la API de scorecards.

Crear un flujo de trabajo

Después de crear tu regla personalizada, elige la opción Add Workflow (Añadir flujo de trabajo) cuando se te pida que configures tus criterios de evaluación. A partir de ahí, puedes crear un flujo de trabajo desde cero o utilizar un plano.

Desde cero

Para crear un flujo de trabajo desde cero:

1. Configura un cronograma para la ejecución de tu flujo de trabajo.
2. Haz clic en el icono más (+) para añadir un paso.
3. Selecciona la acción List entity definitions (Listar definiciones de entidades) para recuperar todas las entidades definidas del Catálogo de software.
4. Haz clic en el icono más (+) para añadir un paso.
5. Selecciona For loop (Para bucle) para iterar sobre cada entidad una a una.
6. Selecciona la acción necesaria para recuperar tus datos de evaluación (por ejemplo: “List Monitors” (Listar monitores) o “Get Repository Content” (Obtener contendio de repositorio) de GitHub).
7. Transforma los datos devueltos mediante una función JavaScript personalizada para generar resultados de aprobado/no aprobado para cada entidad.
8. Utiliza la acción Update scorecard rule outcome (Actualizar resultado de regla de scorecard) para enviar los resultados a Scorecards.
9. Ejecuta el flujo de trabajo para ver tus evaluaciones de tu regla personalizada aparecer en scorecards.
10. Publica tu flujo de trabajo. Los flujos de trabajo no publicados no se ejecutan automáticamente.

A partir de un plano

En lugar de crear un flujo de trabajo desde cero, puedes empezar con un plano de scorecard:

1. Explora los planos de scorecards y selecciona uno.

2. Edita el plano para crear tu flujo de trabajo personalizado.

   Nota: Todos los planos de scorecards incluyen la acción Update scorecard rule outcome (Actualizar resultado de regla de scorecard) para enviar los resultados a scorecards. No elimines este paso.

3. Ejecuta el flujo de trabajo para ver tus evaluaciones de tu regla personalizada aparecer en scorecards.

4. Publica tu flujo de trabajo. Los flujos de trabajo no publicados no se ejecutan automáticamente.

Una vez creado el flujo de trabajo, este se vincula automáticamente a la regla de scorecard. Haz clic en el enlace para abrir el flujo de trabajo, realizar cambios y ver detalles como el propietario, el historial de ejecución y la fecha de la última modificación.

Todos los flujos de trabajo creados desde la página de scorecards o desde un plano de scorecards se etiquetan automáticamente con source: scorecards para su búsqueda y filtrado.

Nota: Al hacer clic en el botón rojo de desvinculación de una regla de scorecard, se elimina el flujo de trabajo de la regla, pero no se despublica automáticamente el flujo de trabajo. Para evitar que se ejecuten evaluaciones, también debes despublicar los flujos de trabajo desvinculados.

Vincular flujo de trabajo existente

Después de crear tu regla personalizada, elige la opción Add Workflow (Añadir flujo de trabajo) para configurar sus criterios de evaluación. Busca y selecciona un flujo de trabajo existente para vincularlo a la regla.

También puedes vincular un flujo de trabajo existente a cualquier regla personalizada que ya genere resultados:

1. Haz clic en la regla personalizada.
2. Selecciona Link Workflow (Vincular flujos de trabajo).
3. Busca un flujo de trabajo y selecciónalo para vincularlo a la regla.

Referencias adicionales

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

Catálogo de softwareDOCUMENTACIÓN API de scorecardsDOCUMENTACIÓN Priorizar y promover las prácticas de observabilidad recomendadas del servicio con scorecardsBLOG Formalizar las prácticas recomendadas con scorecards personalizadasBLOG Seguimiento de las métricas DORA con DatadogDOCUMENTACIÓN