Monaco o Terraform: ¿cuál elegir para gestionar la configuración de Dynatrace mediante código? La pregunta aparece en cuanto un equipo de plataforma quiere dejar los ajustes manuales, versionar sus perfiles de alertas y reproducir un entorno de preproducción idéntico. Las dos herramientas lo permiten. No responden a las mismas necesidades.
Esta comparativa se basa en la documentación oficial y en los repositorios de ambos proyectos. No pretende medir nada: ayuda a decidir según tus herramientas, tu organización y los objetos que quieres gestionar. Para la puesta en marcha, dos guías detallan cada herramienta: Monaco paso a paso y el provider de Terraform.
Alcance: la configuración de un entorno Dynatrace. Las páginas oficiales consultadas no precisan todas la compatibilidad de cada objeto con SaaS o Managed; el punto se trata más abajo, con lo que está verificado y lo que no.
Monaco o Terraform: qué dice la documentación de Dynatrace
La página «Configuration as Code» de Dynatrace presenta las dos herramientas. Terraform, con el provider de Dynatrace, se describe como la herramienta de referencia del sector. Monaco es la herramienta de línea de comandos de Dynatrace, que funciona en modo autónomo y describe las configuraciones en JSON nativo.
La recomendación de la página es clara. Terraform conviene a los equipos que ya lo conocen, a los que gestionan varios proveedores en un mismo espacio de trabajo y a los que quieren un estado gestionado externamente y una configuración dinámica gracias a las expresiones HCL. Monaco es la opción cuando no se puede usar Terraform. Quédate con esta jerarquía: viene del fabricante, no de span.observer.
Ambos proyectos se publican con licencia Apache 2.0 (repositorios Dynatrace/dynatrace-configuration-as-code y dynatrace-oss/terraform-provider-dynatrace). El README del provider indica que cuenta con soporte oficial de Dynatrace.
El modelo de cada herramienta
Monaco: manifiesto, proyectos, YAML y plantillas JSON
Monaco se basa en un manifiesto de despliegue, que indica qué proyectos van a qué entornos, y en proyectos que agrupan los archivos desplegados hacia el mismo destino. Cada configuración incluye un archivo YAML (parámetros, dependencias, nombre) y una plantilla JSON que contiene la carga útil de la API, con variables sustituidas en el despliegue. El JSON es el de la API de Dynatrace: si conoces los esquemas de la API, lees la plantilla sin esfuerzo.
Terraform: HCL, estado y plan
Con Terraform describes recursos en HCL. El provider dynatrace-oss/dynatrace crea dashboards, workflows y alertas personalizadas, y expone también fuentes de datos, como el identificador de entidad de un servicio detectado. Terraform conserva un estado, calcula un plan y luego lo aplica. La documentación de Dynatrace cita entre los beneficios la reducción de los cambios manuales en producción, la sincronización de entornos, la reconstrucción tras un desastre y los módulos reutilizables.
Comparar Monaco y Terraform en siete criterios
| Criterio | Monaco | Terraform (provider de Dynatrace) |
|---|---|---|
| Papel según la documentación | Herramienta CLI de Dynatrace, JSON nativo, modo autónomo | Herramienta de referencia del sector, recomendada si ya la usas |
| Lenguaje | YAML + plantillas JSON | HCL |
| Estado | La documentación consultada no describe un estado externo | Estado gestionado externamente (página Configuration as Code) |
| Validación antes del despliegue | deploy --dry-run: estructura de los archivos, sin conexión a Dynatrace |
terraform plan: diferencias calculadas con el estado y el entorno |
| Partir de lo existente | monaco download |
Exportación con el ejecutable del provider, un archivo .tf por objeto |
| Otros proveedores | No | Sí, en el mismo espacio de trabajo |
| Autenticación | Token, token de plataforma o cliente OAuth, indicados por nombres de variables | Variables DYNATRACE_ENV_URL, DYNATRACE_API_TOKEN, OAuth, token de plataforma |
El --dry-run de Monaco merece una precisión: la documentación indica que no se conecta a Dynatrace, de modo que aún puede aparecer un error HTTP 400 en el despliegue real. Un terraform plan, en cambio, consulta el entorno y detecta la deriva.
Pasos prácticos: probar ambas en un mismo objeto
El mejor criterio de decisión sigue siendo una prueba. Toma un objeto sencillo, por ejemplo un perfil de alertas, y gestiónalo con cada herramienta en un entorno de pruebas. Lleva media jornada.
- Prepara un entorno de pruebas y un token limitado a los objetos previstos. Los scopes dependen del objeto: la página del provider lista
settings.read,settings.write,ReadConfig,WriteConfigy otros para el token de acceso. - Lado Terraform: declara el provider, exporta las variables e inicializa.

- Lado Monaco: descarga lo existente, valida en seco, despliega y después elimina con un archivo
delete.yaml.

- Cambia un valor en el código y mide el esfuerzo: revisión del diff, tiempo de validación, claridad del error en caso de fallo.
- Modifica el mismo valor a mano en la interfaz y vuelve a ejecutar la herramienta. Observa cómo reacciona cada una ante la deriva.
Cómo comprobar que funciona
Tras un despliegue, abre el objeto en la interfaz de Dynatrace: su valor debe coincidir con el repositorio. Vuelve a ejecutar el mismo comando: un segundo terraform plan debe anunciar «No changes», y un segundo monaco deploy no debe fallar ni duplicar el objeto. Si gestionas una misma configuración con las dos herramientas, te expones a conflictos: un objeto, una sola herramienta.
SaaS, Managed y objetos de plataforma
El README del provider da dos formas de URL: https://########.live.dynatrace.com para SaaS y https://<dynatrace-host>/e/<id> para Managed. Los recursos basados en OAuth o en la plataforma (workflows, documentos, SLO recientes, buckets) apuntan al entorno SaaS; la página precisa además que algunos recursos, como dynatrace_json_dashboard, solo aceptan tokens de API. Para Monaco, la página de comandos señala que la opción --token afecta únicamente al Dynatrace clásico; las páginas consultadas no detallan la compatibilidad con Managed objeto por objeto. Verifica por tanto cada tipo en la documentación de tu versión antes de comprometerte. La elección de la plataforma se aborda en Managed o SaaS.
Buenas prácticas
- Una sola herramienta por objeto. Dos herramientas que escriben el mismo perfil se disputan el valor en cada ejecución.
- Exporta antes de escribir.
monaco downloado la exportación del provider da el formato de partida correcto. - Secretos fuera del repositorio. Ambas herramientas leen los tokens de variables de entorno.
- Revisa como código. Una merge request por cada cambio de alertas reduce el MTTR: el
git logdice qué ha cambiado. - Estandariza. Módulos de Terraform o proyectos de Monaco por servicio evitan que cada equipo reinvente su alerting. El ejemplo de los SLO con Terraform muestra el enfoque.
Preguntas frecuentes
¿Hay que elegir Monaco o Terraform para Dynatrace?
Según la documentación de Dynatrace, se recomienda Terraform si tu equipo lo domina, gestiona varios proveedores o quiere un estado externo. Monaco es la opción cuando no se puede usar Terraform.
¿Se pueden usar las dos herramientas juntas?
Técnicamente sí, sobre objetos distintos. Evita gestionar el mismo objeto con ambas: el último despliegue sobrescribe al otro. Separa los ámbitos por tipo de objeto o por equipo.
¿Cómo migrar de una herramienta a otra?
Exporta lo existente con la herramienta de destino (monaco download o la exportación del provider), compara con el entorno y retira la herramienta anterior de la cadena para esos objetos. Prueba antes en un entorno no productivo.
Conclusión
Si Terraform ya está en tu cadena, el provider de Dynatrace se integra en ella y la documentación lo recomienda. Si no, Monaco ofrece un modelo más cercano a la API (JSON nativo). En ambos casos, el valor está en el proceso: código, revisión, despliegue automatizado. Haz la prueba con un objeto antes de generalizar y mantén el conjunto bajo una sola herramienta por objeto. En cuanto a la telemetría, el Collector de OpenTelemetry también se configura como código.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión. Fuentes: Configuration as Code, comandos de Monaco y provider de Terraform.