Un clúster de Dynatrace Managed rara vez da servicio a un solo equipo, y la cuestión de los entornos multi-tenant se plantea enseguida. Muy pronto, producción convive con preproducción, una filial pide su propio espacio, un proveedor debe ver sus aplicaciones sin acceder al resto, y el área financiera quiere saber quién consume qué. Sin una organización clara, se acaba con un único entorno sobrecargado, permisos inextricables y una licencia agotada por el equipo más rápido en desplegar sus agentes.
Es un tema propio de Managed. Tu licencia define un volumen global de unidades (unidades de host, sesiones de usuario, monitores sintéticos, volúmenes de logs o de ingesta según tu modelo) que tú repartes entre entornos en la Cluster Management Console. El clúster no arbitrará por ti: si un entorno no tiene cuota, puede consumir hasta agotar el pool común.
Este artículo muestra cómo estructurar varios entornos en un mismo clúster, asignar y vigilar cuotas, y automatizar estas operaciones mediante la API Cluster.
Entorno: la unidad de aislamiento
Cada entorno de Managed es un espacio aislado lógicamente, accesible en https://{votre-domaine}/e/{id-environnement}. Tiene sus propios datos, su configuración, sus tokens de API, sus reglas de alerta y sus grupos de usuarios. Los agentes de un entorno no ven los de otro, y los datos no se mezclan.
En cambio, todos los entornos comparten los recursos físicos del clúster: CPU, memoria, disco, almacenamiento de Cassandra y Elasticsearch. El aislamiento es lógico, no material, lo que tiene dos consecuencias prácticas:
- un entorno muy ruidoso puede afectar al rendimiento global si el clúster está infradimensionado;
- la retención y la capacidad de disco deben planificarse para la suma de los entornos.
Estrategias de división de entornos multi-tenant
| Estrategia | Ventajas | Inconvenientes |
|---|---|---|
| Por fase (prod / no prod) | Sencilla, protege producción del ruido de las pruebas | Las trazas no atraviesan los entornos |
| Por entidad (filial, cliente, unidad de negocio) | Fuerte aislamiento de los datos y refacturación fácil | Sin vista de extremo a extremo entre entidades |
| Entorno único + Management zones | Trazado de extremo a extremo, una sola configuración | Permisos más complejos, sin cuota por equipo |
La regla empírica: separa los entornos cuando el aislamiento de los datos o la refacturación sean un requisito, y quédate en un mismo entorno (con Management zones) cuando las aplicaciones se comuniquen entre sí y quieras trazas distribuidas completas.
Entender las cuotas
En la CMC, cada entorno puede recibir límites por tipo de unidad. Estas cuotas corresponden al modelo de licencia clásico: no están disponibles con Dynatrace Platform Subscription (DPS). Normalmente encontrarás:
- Unidades de host: las consumen los OneAgent, con un peso que depende de la memoria del host y del modo de monitorización.
- Sesiones / unidades DEM: las consumen el Real User Monitoring y los monitores sintéticos.
- Unidades de ingesta (métricas personalizadas, logs, trazas sin agente) según el modelo.
Una cuota puede ser absoluta (tope fijo) o dejarse ilimitada, en cuyo caso el entorno toma del pool común. Cuando se alcanza el tope, el comportamiento depende del tipo de unidad: rechazo de nuevos hosts, parada de la captura de sesiones adicionales, etc. Comprueba con precisión este comportamiento en tu versión antes de fijar topes ajustados en producción.
Tutorial paso a paso
Paso 1 — Hacer el inventario de la licencia
En la CMC, abre la página de licencia para anotar el volumen total de cada tipo de unidad, la fecha de caducidad y el consumo actual. En modo conectado, esta información se sincroniza con Mission Control; en modo sin conexión (offline), asegúrate de que la clave de licencia importada esté al día.
Paso 2 — Crear un token de Cluster API
En la CMC, genera un Cluster API token con el permiso Service Provider API (ServiceProviderAPI), que exigen las llamadas sobre los entornos. Guárdalo en una caja fuerte de secretos: da acceso a la administración de todo el clúster.
Paso 3 — Listar los entornos existentes
curl -sS "https://{votre-domaine}/api/cluster/v2/environments" \
-H "Authorization: Api-Token {token-cluster}" | python3 -m json.tool
La respuesta da, para cada entorno, su identificador, su nombre, su estado y sus etiquetas; las cuotas y el consumo solo aparecen con el parámetro ?includeConsumptionInfo=true.
Paso 4 — Crear un entorno
Desde la CMC (menú Environments, y después la creación), o mediante la API:
curl -sS -X POST "https://{votre-domaine}/api/cluster/v2/environments" \
-H "Authorization: Api-Token {token-cluster}" \
-H "Content-Type: application/json" \
-d '{
"name": "{nom-environnement}",
"state": "ENABLED",
"tags": ["{entite}", "{stade}"]
}'
La respuesta devuelve el identificador del nuevo entorno. El esquema exacto del cuerpo (campos de etiquetas, de cuotas, de almacenamiento) varía según las versiones: consulta la documentación de la API Cluster de tu clúster, accesible desde la CMC.
Paso 5 — Definir las cuotas
En la CMC, abre el entorno e introduce los límites por tipo de unidad. La API Cluster v2 también permite actualizar la configuración de un entorno, cuotas incluidas:
curl -sS "https://{votre-domaine}/api/cluster/v2/environments/{id-environnement}?includeConsumptionInfo=true" \
-H "Authorization: Api-Token {token-cluster}" -o env.json
# Éditer la section des quotas dans env.json, puis :
curl -sS -X PUT "https://{votre-domaine}/api/cluster/v2/environments/{id-environnement}" \
-H "Authorization: Api-Token {token-cluster}" \
-H "Content-Type: application/json" \
-d @env.json
Trabajar con lectura, modificación y escritura evita sobrescribir sin querer otros parámetros del entorno.
Paso 6 — Configurar los permisos
En la CMC, crea grupos de usuarios (o mapea tus grupos LDAP/SAML) y asígnales permisos por entorno: acceso de lectura, administración, o restringido a determinadas Management zones. Un administrador de entorno no tiene, por defecto, acceso a la CMC.
Paso 7 — Vigilar el consumo
Consulta con regularidad la página de licencia de la CMC, que detalla el consumo por entorno. Para un seguimiento automatizado, consulta periódicamente la API Cluster y envía el resultado a tu herramienta de reporting:
curl -sS "https://{votre-domaine}/api/cluster/v2/environments?includeConsumptionInfo=true" \
-H "Authorization: Api-Token {token-cluster}" \
-o "/var/tmp/environnements-$(date +%F).json"
Gobernanza del día a día
- Conserva un margen sin asignar en el pool (por ejemplo, del 10 al 15 %) para urgencias y nuevos proyectos.
- Revisa las cuotas cada trimestre, a partir del consumo real y no de las peticiones iniciales.
- Documenta quién puede pedir un aumento de cuota y quién lo valida.
- Alerta antes de alcanzar un tope, no después: un umbral al 80 % deja tiempo para actuar.
Buenas prácticas
- Limita el número de entornos: cada uno añade configuración que mantener.
- Nombra los entornos de forma explícita y añade etiquetas de entidad y de fase.
- Fija cuotas para todos los entornos que no sean de producción, para proteger producción.
- Gestiona los tokens de Cluster API con el mismo rigor que las cuentas root.
- Planifica la capacidad del clúster (disco, memoria de los nodos) para la suma de los entornos y de sus retenciones.
- Automatiza la creación de entornos mediante la API para garantizar una configuración homogénea.
Preguntas frecuentes
¿Hay que crear un entorno por equipo?
No necesariamente. Separa los entornos cuando el aislamiento de los datos o la refacturación sean un requisito; cuando las aplicaciones se comunican entre sí, un único entorno dividido en Management zones conserva trazas distribuidas completas.
¿Qué ocurre cuando un entorno alcanza su cuota?
El comportamiento depende del tipo de unidad: rechazo de nuevos hosts, parada de la captura de sesiones adicionales, etc. Un entorno sin cuota toma del pool común hasta agotarlo, de ahí el interés de una alerta hacia el 80 %.
¿Un administrador de entorno tiene acceso a la CMC?
No, no por defecto. Los permisos se asignan por entorno a grupos de usuarios; el acceso a la CMC y los tokens de Cluster API corresponden a la administración de todo el clúster.
Conclusión
El multi-entorno es una de las grandes bazas de Dynatrace Managed, pero traslada al administrador la responsabilidad del arbitraje. Si eliges una estrategia de división coherente, asignas cuotas explícitas y automatizas la vigilancia mediante la API Cluster, evitas sorpresas con la licencia y ofreces a cada equipo un espacio aislado y predecible.
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.