Dynatrace Monaco: la configuración como código, paso a paso

Dynatrace Monaco paso a paso: manifiesto, download, perfil de alerta parametrizado, dry-run, despliegue en CI y borrado limpio, para SaaS y Managed.
Dynatrace Monaco : la configuration en code, pas à pas

Un perfil de alerta modificado a mano en producción, otro olvidado en preproducción, y nadie sabe quién cambió qué. Dynatrace Monaco (Monitoring as Code) resuelve este problema: la configuración de tus entornos vive en archivos YAML y JSON versionados en Git, revisados en una merge request y desplegados por la CI como cualquier otro código.

Para un equipo SRE, lo que está en juego es concreto. Una configuración reproducible reduce la deriva entre entornos, hace reversible cada cambio y elimina el toil de los ajustes manuales repetidos en diez entornos. Ante un incidente, un git log responde a la pregunta «¿qué ha cambiado?» en unos segundos.

Objetivo de este tutorial: instalar la CLI, descargar una configuración existente, crear un perfil de alerta parametrizado, desplegarlo primero en seco y luego de verdad, e integrarlo en un pipeline. Monaco funciona con Dynatrace SaaS y Dynatrace Managed para las API de configuración clásicas y Settings 2.0; los objetos de la plataforma (workflows, documentos, buckets, SLO recientes) solo conciernen a SaaS.

Dynatrace Monaco: los tres archivos que debes conocer

Archivo Función
manifest.yaml Declara los proyectos (carpetas de configuración) y los entornos de destino, con sus URL y el nombre de las variables que contienen los secretos
config.yaml En cada carpeta de proyecto: la lista de configuraciones, su tipo (API clásica, esquema de Settings 2.0, workflow…) y sus parámetros
Plantilla JSON El cuerpo del objeto, con variables {{ .nom }} que se sustituyen por los parámetros en el despliegue

Esta separación distingue lo que cambia de un entorno a otro (los parámetros) de lo que no cambia (la plantilla).

Requisitos previos

  • La CLI monaco 2.x, descargada desde las releases del repositorio Dynatrace/dynatrace-configuration-as-code.
  • Un token de API con los scopes adecuados a los objetos gestionados: como mínimo settings.read y settings.write para Settings 2.0, ReadConfig y WriteConfig para las API clásicas. En SaaS, un cliente OAuth o un platform token para los objetos de la plataforma.
  • Un repositorio Git y un runner de CI capaz de leer variables secretas.

Un token rechazado produce errores 401 o 403 poco explícitos en la salida de Monaco: la guía Automatizar la administración con la API recuerda cómo probar un token antes de usarlo.

Tutorial paso a paso

Paso 1: instalar la CLI

# Linux amd64 : remplacez <version> par la dernière release publiée
curl -L -o monaco https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/download/v<version>/monaco-linux-amd64
chmod +x monaco
sudo mv monaco /usr/local/bin/
monaco version

Paso 2: escribir el manifiesto

manifestVersion: 1.0
projects:
  - name: alerting
environmentGroups:
  - name: preprod
    environments:
      - name: preprod
        url:
          type: environment
          value: DT_PREPROD_URL
        auth:
          token:
            name: DT_PREPROD_TOKEN
  - name: prod
    environments:
      - name: prod
        url:
          type: environment
          value: DT_PROD_URL
        auth:
          token:
            name: DT_PROD_TOKEN

Línea crítica: type: environment. El valor no es la URL sino el nombre de la variable que la contiene. Lo mismo ocurre con token.name. Así, el archivo puede subirse al repositorio sin secretos. En Managed, la URL tiene la forma https://<dominio>/e/<env-id>; en SaaS, https://<env-id>.live.dynatrace.com.

Paso 3: partir de lo existente con download

En lugar de escribir una plantilla desde cero, descarga un objeto existente para obtener el formato correcto:

export DT_PREPROD_URL="https://<env-id>.live.dynatrace.com"
export DT_PREPROD_TOKEN="dt0c01.XXXX"
monaco download --manifest manifest.yaml --environment preprod \
  --settings-schema builtin:alerting.profile \
  --output-folder download

Monaco escribe una carpeta de proyecto con un config.yaml y un JSON por objeto. Solo extrae el valor del objeto, sin los metadatos de la API.

Paso 4: parametrizar la configuración

Copia el objeto descargado en alerting/ y sustituye los valores propios del equipo por variables. El config.yaml:

configs:
  - id: profil-equipe-paiement
    type:
      settings:
        schema: builtin:alerting.profile
        scope: environment
    config:
      name: Paiement - production
      template: profil.json
      parameters:
        equipe: paiement

Y la plantilla profil.json, simplificada a partir de la descarga:

{
  "name": "{{ .name }}",
  "severityRules": [
    {
      "severityLevel": "AVAILABILITY",
      "delayInMinutes": 0,
      "tagFilterIncludeMode": "INCLUDE_ALL",
      "tagFilter": ["team:{{ .equipe }}"]
    }
  ],
  "eventFilters": []
}

El campo name del config.yaml se expone a la plantilla como {{ .name }}; cada entrada de parameters se expone con su propio nombre. Conserva los nombres de propiedades exactamente como los produjo el download: el esquema de Settings 2.0 es el que manda. La regla de etiqueta supone un etiquetado coherente, consulta Management zones y etiquetado automático.

Paso 5: validar y luego desplegar

monaco deploy manifest.yaml --environment preprod --dry-run
monaco deploy manifest.yaml --environment preprod

El modo --dry-run comprueba la sintaxis, las referencias y los parámetros sin llamar a la API de escritura. El despliegue real crea el objeto o lo actualiza si ya existe: Monaco encuentra el objeto gracias a un identificador externo derivado del proyecto y del id de la configuración. Por tanto, volver a ejecutar el comando no crea duplicados.

Paso 6: conectar la CI

# .gitlab-ci.yml (extrait)
monaco-preprod:
  stage: deploy
  script:
    - monaco deploy manifest.yaml --environment preprod --dry-run
    - monaco deploy manifest.yaml --environment preprod
  rules:
    - if: $CI_COMMIT_BRANCH == "main"

monaco-prod:
  stage: deploy
  script:
    - monaco deploy manifest.yaml --environment prod
  when: manual

Las variables DT_PREPROD_* y DT_PROD_* proceden de los secretos del proyecto de CI. La producción sigue siendo manual: una persona valida después de ver que la preproducción se comporta correctamente.

Paso 7: borrar de forma limpia

Quitar una entrada de config.yaml no borra nada en Dynatrace. Lista el objeto en un archivo delete.yaml:

delete:
  - project: alerting
    type: builtin:alerting.profile
    id: profil-equipe-paiement
monaco delete --manifest manifest.yaml --file delete.yaml --environment preprod

Cómo comprobar que funciona

  • La salida de monaco deploy termina sin errores y lista la configuración desplegada.
  • En el entorno, abre los ajustes de los perfiles de alerta: el perfil «Paiement – production» existe con la regla esperada.
  • Mediante la API, el objeto aparece bajo el esquema:
curl -s -H "Authorization: Api-Token $DT_PREPROD_TOKEN" \
  "$DT_PREPROD_URL/api/v2/settings/objects?schemaIds=builtin:alerting.profile&fields=objectId,value" | jq '.items[].value.name'
  • Vuelve a ejecutar monaco deploy: el resultado debe ser idéntico, sin que se cree ningún objeto nuevo.

Buenas prácticas

  • Una única fuente de verdad: un objeto gestionado por Monaco ya no se modifica a mano. Anúncialo o, mejor, limita los derechos de escritura en la interfaz.
  • Proyectos pequeños: una carpeta por dominio (alertas, etiquetado, detección de anomalías) y por equipo propietario. Las revisiones siguen siendo legibles.
  • Dry-run sistemático en la merge request: el error aparece antes de la fusión, no durante el despliegue.
  • Detección de deriva: un download programado y comparado con el repositorio revela los cambios hechos fuera de Git.
  • Alertas coherentes: los perfiles desplegados deben seguir alineados con las integraciones de notificación; de lo contrario, la alerta se pierde en el vacío.

Preguntas frecuentes

¿Funciona Monaco con Dynatrace Managed?

Sí para las API de configuración clásicas y los objetos de Settings 2.0, con un token de API. Los tipos propios de la plataforma SaaS (workflows, documentos, buckets de Grail) no se aplican a Managed.

¿Monaco o Terraform?

Monaco está centrado en Dynatrace, con un modelo de proyectos y entornos sencillo de dominar. Terraform es adecuado si tus equipos ya lo usan para el resto de la infraestructura. Lo esencial es no gestionar el mismo objeto con las dos herramientas.

¿Cómo se gestionan los secretos en las plantillas?

Declara un parámetro de tipo environment que lea una variable de entorno en el despliegue. El secreto nunca pasa por el repositorio Git.

Conclusión

Con Dynatrace Monaco, la configuración se convierte en código: un manifiesto, proyectos, plantillas parametrizadas, un dry-run en la merge request y un despliegue por la CI. Empieza por un dominio sencillo como los perfiles de alerta y luego amplía. Cada cambio se vuelve trazable, reversible e idéntico de un entorno a otro.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Las opciones de la CLI y los esquemas evolucionan: compruébalos en la documentación oficial de Monaco correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Pods en CrashLoopBackOff OOMKilled : diagnostiquer avec Dynatrace

Pods en CrashLoopBackOff OOMKilled: diagnóstico con Dynatrace

Next Post
Provider Terraform Dynatrace : alerting, management zones et tableaux de bord

Terraform Dynatrace: alertas, management zones y dashboards con el provider

Related Posts