Este módulo del curso Monaco Managed detalla la instalación de Monaco Managed: descargar el binario, escribir un manifiesto que designe tu entorno Managed y aportar un token de API con los ámbitos correctos.
Itinerario: Monaco Managed · Módulo 2/5 · Duración: ~40 min · Nivel: Principiante
Objetivos:
- Descargar, verificar e instalar el binario de Monaco
- Escribir un manifiesto que apunte a un entorno Managed
- Crear un token de API con ámbitos adecuados y proporcionarlo mediante una variable de entorno
- Validar el conjunto con un
deployen modo--dry-run
Requisitos previos: un entorno Managed de pruebas, el módulo 1, un terminal y acceso a GitHub.
Monaco (Dynatrace Configuration as Code) es una herramienta de línea de comandos. Lee archivos YAML y JSON y los envía a las API de tu entorno. Antes de cualquier despliegue deben estar listos tres elementos: el programa, un manifiesto y un token.
Este módulo solo es válido para Dynatrace Managed. Las secciones de autenticación por token de plataforma y OAuth, que existen en la documentación SaaS, no forman parte de este itinerario.
Instalación de Monaco Managed: descargar y verificar el binario
La página de instalación de la documentación de Managed ofrece un binario por sistema: Linux (64 bits AMD, 64 bits ARM, 32 bits), macOS (Apple Silicon, Intel) y Windows (64 y 32 bits). Los binarios se publican en la página de versiones del repositorio de GitHub de la herramienta.
En Linux de 64 bits (AMD), la documentación indica esta secuencia: descarga, verificación de la suma de comprobación, cambio de nombre, permiso de ejecución y copia en el PATH.

La documentación presenta la verificación como opcional, pero cuesta un solo comando. El resultado esperado es la línea monaco-linux-amd64: OK. Los dos archivos deben estar en la misma carpeta.
En Windows, la documentación usa PowerShell con Invoke-WebRequest para obtener monaco.exe, y luego pide añadir su carpeta a la variable PATH (entradas separadas por punto y coma) y abrir una nueva consola. La página indica que este ejecutable está firmado por Dynatrace.
También existe una imagen de contenedor dynatrace/dynatrace-configuration-as-code:[VERSION]; la misma página describe su verificación con cosign.
Comprobar que Monaco responde
Ejecuta monaco sin argumentos: la ayuda lista los comandos disponibles. El comando monaco version muestra la versión instalada; anótala, porque el comportamiento y las funciones dependen de la versión.

La opción -v activa los registros de depuración, útiles para entender un fallo.
El manifiesto: dónde desplegar
El manifiesto es un archivo YAML que describe los proyectos que se van a desplegar y los entornos de destino. Tiene tres claves de primer nivel: manifestVersion, projects y environmentGroups. Según la documentación, la única versión de manifiesto admitida es 1.0.
projects: cada proyecto lleva unname(sin barra oblicua) y unpathopcional. Sinpath, el nombre se usa como ruta. El tipogroupingcarga cada subcarpeta como un proyecto distinto, llamadonombre.subcarpeta.environmentGroups: cada entorno pertenece a un grupo, y solo a uno. Los grupos permiten seleccionar o sobrescribir varios entornos a la vez, por ejemplo para separar preproducción y producción.- Cada entorno tiene un
name(libre, pero único), unaurly una secciónauth.

La URL de un entorno Managed
El campo url tiene un type y un value. Con type: value, la dirección se escribe en el archivo; con type: environment, el valor es el nombre de una variable de entorno. El ejemplo anterior elige la segunda forma, porque la dirección cambia de un entorno a otro.
En Managed, la dirección del entorno sigue el patrón https://{tu-dominio}/e/{identificador-del-entorno}, el que usa la documentación de la API de entorno de Managed para su API Explorer. Las direcciones apps.dynatrace.com de los ejemplos de la documentación de Monaco ilustran la estructura del archivo; no corresponden a Managed.
El token de API y sus ámbitos
El manifiesto nunca contiene un secreto: la herramienta no permite definirlo en claro y siempre carga el token desde una variable de entorno. La clave name de auth.token designa esa variable. En el código de Monaco, una variable ausente o vacía produce un error explícito al cargar el manifiesto.
La documentación de Managed indica que un token de acceso exige como mínimo el siguiente ámbito, para consultar la información general del entorno:
DataExport: acceso a problemas, flujo de eventos, métricas y topología (API v1).
En la mayoría de los casos se necesitan al menos los cinco ámbitos siguientes:
| Ámbito | Función |
|---|---|
DataExport |
Información general del entorno |
ReadConfig |
Lectura mediante la API de configuración |
WriteConfig |
Escritura mediante la API de configuración |
settings.read |
Lectura mediante la API Settings |
settings.write |
Escritura mediante la API Settings |
Cada tipo de configuración requiere sus propios ámbitos: consulta la página «Monaco API support and access permission handling» antes de ampliar el perímetro. Se aplica el principio de mínimo privilegio: un token de lectura basta para la exportación del módulo 3, y el token de escritura solo se crea para el despliegue. Un token de acceso de Managed se genera desde la página de tokens de acceso del entorno, con «Generate new token».
Ejercicio práctico
Este ejercicio se hace en un entorno Managed de preproducción. Los comandos siguientes no se ejecutaron para redactar este módulo; por tanto, no se reproduce ninguna salida más allá de las de la documentación.
Paso 1 — Instalar Monaco
Sigue los comandos de tu sistema y ejecuta monaco version. Resultado esperado: un número de versión y la ayuda que muestra monaco solo.
Paso 2 — Crear el token
En el entorno de preproducción, genera un token llamado «monaco-recette» con los cinco ámbitos de la tabla. Guárdalo en tu gestor de secretos. Resultado esperado: un token visible una sola vez, nunca pegado en un archivo del repositorio.
Paso 3 — Exportar las variables
export DT_MANAGED_URL="https://{votre-domaine}/e/{identifiant-de-l-environnement}"
export DT_API_TOKEN="<votre-jeton>"
Resultado esperado: dos variables definidas en el terminal actual, fuera de cualquier archivo seguido por Git.
Paso 4 — Escribir el manifiesto y el proyecto
Crea manifest.yaml como en la captura, además de la carpeta shared/infrastructure. Resultado esperado: un árbol con un manifiesto y una carpeta de proyecto.
Paso 5 — Validar en seco
monaco deploy manifest.yaml --dry-run
Según la ayuda del comando, --dry-run (o -d) valida la estructura del manifiesto, de los proyectos y de las configuraciones, resuelve los parámetros y genera las plantillas JSON, sin poder validar el contenido de las cargas. Resultado esperado: ningún error de variable de entorno. Si eliminas DT_API_TOKEN, un error debe señalar la variable no encontrada. El comportamiento exacto con un proyecto vacío no se ha verificado aquí; el módulo 4 rellena el proyecto.
Buenas prácticas
- Un token por entorno y por uso (lectura, escritura); nunca un secreto en el manifiesto ni en Git.
- Empieza por la preproducción: la producción solo se añade al manifiesto tras la validación.
Cuestionario
- ¿Qué comando muestra la versión de Monaco? a)
monaco --aboutb)monaco versionc)monaco statusd)monaco info - ¿Dónde guarda el manifiesto el token de API? a) En claro en
auth.tokenb) Enprojectsc) Como el nombre de una variable de entorno d) En el nombre del entorno - ¿A cuántos grupos puede pertenecer un mismo entorno? a) A uno solo b) A dos c) A tantos como se quiera d) A ninguno
- ¿Qué hace
--dry-runendeploy? a) Despliega sin registros b) Valida la estructura y resuelve los parámetros, sin validar el contenido de las cargas c) Elimina configuraciones d) Crea el token
Solucionario
- b)
versionfigura en la lista de comandos de la ayuda. - c) La documentación precisa que
namees el nombre de la variable, no el secreto. - a) Cada entorno pertenece a un grupo, y solo a uno.
- b) Según la ayuda del comando, la validación no inspecciona el contenido de los JSON.
Para ir más lejos
- Dynatrace Monaco: la configuración como código
- Monaco o Terraform para configurar Dynatrace
- Monaco: de Managed a SaaS, para preparar lo que sigue
- Instalación de Monaco (documentación de Managed) y repositorio de Monaco
← Módulo 1: configuration as code Managed · Índice del itinerario · Módulo 3: exportación de Monaco Managed →
Preguntas frecuentes
¿Hay que instalar Monaco en el servidor Managed?
No. Monaco se ejecuta en un equipo o en un agente de CI y llama a las API del entorno por la red. Basta con que la dirección del entorno sea accesible desde esa máquina.
¿Se puede escribir el token directamente en el manifiesto?
No. La documentación indica que la herramienta no permite definir esta información sensible en el archivo y siempre la carga desde variables de entorno.
¿Se aplican las secciones platformToken y oAuth a Managed?
Sirven para las API de la plataforma y figuran en la documentación SaaS. La documentación de Monaco para Managed solo describe el token de acceso; este itinerario se limita a él.
Monaco está instalado, el manifiesto designa el entorno y el token llega por variable de entorno. El módulo siguiente usa monaco download para exportar la configuración existente y leer la estructura generada.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Este itinerario no sustituye a las formaciones y certificaciones oficiales de Dynatrace University. Dynatrace es una marca de Dynatrace LLC. Comprueba las funciones en la documentación oficial de tu versión.