Dashboard Dynatrace Managed: tiles, Data Explorer y JSON, con 3 ejemplos completos

Construye un dashboard Dynatrace Managed útil: selectores builtin exactos, management zones, exportación JSON vía API y 3 ejemplos completos para copiar.
Dashboard Dynatrace Managed : tuiles, Data Explorer et JSON, avec 3 exemples complets

Durante un incidente, la guardia (on-call) abre un dashboard Dynatrace Managed y se encuentra con veinte tiles sin jerarquía: gráficos por defecto, hosts de todos los entornos mezclados y ninguna referencia a los SLO. Se pierden diez minutos buscando la vista correcta, y el MTTR se alarga otro tanto.

Esta guía muestra cómo construir dashboards clásicos útiles en Dynatrace Managed: tiles nativos, gráficos del Data Explorer con metric selectors builtin: exactos, filtrado por management zone y, después, exportación e importación en JSON con la API Configuration para versionarlos.

Objetivo: salir con tres dashboards completos, descritos tile por tile (salud de la aplicación, hosts, vista de operaciones), y un método para aprovisionarlos sin clics. El contenido se dirige a Dynatrace Managed; los dashboards clásicos y la API Configuration también existen en Dynatrace SaaS, donde solo cambia la URL.

Requisitos previos

  • Un entorno Dynatrace Managed con OneAgent desplegado en los hosts y servicios que se quieren seguir.
  • Management zones ya creadas (consulta management zones y tagging): sirven de filtro para cada dashboard.
  • Para la API: un token con el scope ReadConfig (lectura y exportación) y WriteConfig (creación, actualización, validación).
  • La URL del entorno en formato Managed: https://{tu-dominio}/e/{id-entorno}.
  • SLO ya definidos si quieres el tile SLO del ejemplo 3.

Los bloques de un dashboard Dynatrace Managed

Un dashboard clásico es una cuadrícula de tiles. Cada uno tiene un tipo (tileType), una posición (bounds: top, left, width, height en píxeles) y, si hace falta, un filtro propio (tileFilter) que sustituye al filtro del dashboard.

Tipo de tile Uso
HEADER Título de sección, para estructurar la cuadrícula
HOSTS, SERVICES, APPLICATIONS Salud global de una familia de entidades, filtrable por management zone
DATA_EXPLORER Gráfico construido en el Data Explorer a partir de un metric selector
OPEN_PROBLEMS Problemas abiertos detectados por Davis
SLO Estado y presupuesto de error de un SLO
MARKDOWN Texto libre: enlace al runbook, contactos de guardia

A nivel del dashboard, dashboardMetadata.dashboardFilter fija la management zone y el rango temporal por defecto (por ejemplo l_2_HOURS o l_72_HOURS). El campo dynamicFilters.filters añade filtros que el lector cambia al vuelo, como SERVICE_TYPE, HOST_TAG_KEY:<tag> o KUBERNETES_CLUSTER.

Construir un tile con el Data Explorer

  1. Abre Data Explorer desde el menú y busca la métrica (por ejemplo CPU usage %).
  2. Elige la agregación, la división (Split by) y los filtros, o cambia al editor avanzado para escribir directamente el selector.
  3. Elige la visualización (gráfico, valor único, tabla, top list), luego Pin to dashboard y el dashboard de destino.
  4. En el dashboard, edita el tile para darle un nombre claro y, si hace falta, una management zone propia.

El selector sigue la sintaxis de Metrics v2: clave de métrica y después transformaciones encadenadas con :. Ejemplo documentado: builtin:host.cpu.user:sort(value(max,descending)):limit(10) para los diez hosts más cargados. Para profundizar en la exploración, consulta el módulo de exploración de datos.

Ejemplo 1: salud de la aplicación

Objetivo: saber en diez segundos si los servicios de una aplicación cumplen sus SLI (latencia, errores, rendimiento). Filtro del dashboard: la management zone de la aplicación, rango Last 2 hours.

Tile Tipo Selector o ajuste
«Servicios» HEADER Título de sección
Salud de los servicios SERVICES Filtro: management zone de la aplicación
Tiempo de respuesta mediano DATA_EXPLORER, gráfico builtin:service.response.time:splitBy("dt.entity.service"):median
Tiempo de respuesta p90 DATA_EXPLORER, gráfico builtin:service.response.time:splitBy("dt.entity.service"):percentile(90)
Tasa de errores DATA_EXPLORER, top list builtin:service.errors.total.rate:splitBy("dt.entity.service"):avg:sort(value(avg,descending)):limit(10)
Rendimiento (throughput) DATA_EXPLORER, gráfico builtin:service.requestCount.total:splitBy("dt.entity.service"):auto

Líneas críticas: builtin:service.response.time se expresa en microsegundos y el Data Explorer convierte la visualización. La tasa de errores builtin:service.errors.total.rate ya es un porcentaje y solo acepta auto y avg. El contador builtin:service.requestCount.total solo acepta auto y value: no le apliques avg. El p90 se acerca más a la experiencia real que una media.

Ejemplo 2: hosts

Objetivo: detectar los hosts saturados antes de que provoquen un problema. Filtro: la management zone del equipo de infraestructura, rango Last 24 hours.

Tile Tipo Selector o ajuste
Salud de los hosts HOSTS Filtro: management zone
Top 10 CPU DATA_EXPLORER, top list builtin:host.cpu.usage:splitBy("dt.entity.host"):avg:sort(value(avg,descending)):limit(10)
Top 10 memoria DATA_EXPLORER, top list builtin:host.mem.usage:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10)
Discos más llenos DATA_EXPLORER, tabla builtin:host.disk.usedPct:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10)
Disponibilidad DATA_EXPLORER, gráfico builtin:host.availability (agregación por defecto)

Las tres métricas de recursos están en porcentaje y aceptan avg, max y min. Usa max para la memoria y el disco: una media oculta el pico que tumba un proceso. En el Data Explorer, añade un valor umbral al 85 % para colorear los excesos.

Ejemplo 3: vista de operaciones del entorno

Objetivo: la página de inicio de la guardia. Sin filtro de management zone, o con una zona «Production», rango Last 2 hours.

Tile Tipo Ajuste
Problemas abiertos OPEN_PROBLEMS Filtro: management zone Production
SLO de disponibilidad del front SLO SLO asignado al tile, con presupuesto de error
SLO de latencia de la API SLO SLO asignado al tile
Errores, todos los servicios DATA_EXPLORER, valor único builtin:service.errors.total.rate:splitBy():avg
Hosts no disponibles DATA_EXPLORER, top list builtin:host.availability:splitBy("dt.entity.host")
Runbook MARKDOWN Enlace al procedimiento y al canal de guardia

El tile OPEN_PROBLEMS refleja lo que Davis ha abierto; es el equivalente visual de las notificaciones de tus perfiles de alerting. Para monitorizar el propio clúster Managed (nodos, almacenamiento, ActiveGates), mantén un dashboard aparte y apóyate en la monitorización de la salud del clúster.

Exportar e importar un dashboard en JSON

Paso 1: listar y exportar

export DT_URL="https://{votre-domaine}/e/{id-environnement}"
# Lister (scope ReadConfig) : renvoie id, name, owner
curl -s "$DT_URL/api/config/v1/dashboards" \
  -H "Authorization: Api-Token $DT_TOKEN" | jq '.dashboards[] | {id, name, owner}'

# Exporter un dashboard
curl -s "$DT_URL/api/config/v1/dashboards/<id>" \
  -H "Authorization: Api-Token $DT_TOKEN" > sante-app.json

La lista devuelve todos los dashboards, sean cuales sean los permisos en la interfaz. La mejor forma de obtener la estructura exacta de un tile DATA_EXPLORER es exportarlo después de construirlo en la interfaz.

Paso 2: un JSON mínimo válido

{
  "dashboardMetadata": {
    "name": "Exploitation - Production",
    "owner": "sre-team",
    "shared": true,
    "dashboardFilter": {
      "timeframe": "l_2_HOURS",
      "managementZone": { "id": "3438779970106539862", "name": "Production" }
    }
  },
  "tiles": [
    {
      "name": "Hôtes", "tileType": "HEADER", "configured": true,
      "bounds": { "top": 0, "left": 0, "width": 304, "height": 38 },
      "tileFilter": {}
    },
    {
      "name": "Santé des hôtes", "tileType": "HOSTS", "configured": true,
      "chartVisible": true,
      "bounds": { "top": 38, "left": 0, "width": 304, "height": 304 },
      "tileFilter": {}
    }
  ]
}

dashboardMetadata (con name y owner) y tiles son obligatorios. Antes de importar una exportación, elimina id y el bloque metadata, que sirven para depurar: el identificador lo asigna Dynatrace.

Paso 3: validar y después crear o actualizar

# Valider sans créer (scope WriteConfig) : 204 = valide
curl -s -o /dev/null -w "%{http_code}\n" -X POST \
  "$DT_URL/api/config/v1/dashboards/validator" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/json" -d @sante-app.json

# Créer
curl -s -X POST "$DT_URL/api/config/v1/dashboards" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/json" -d @sante-app.json

# Mettre à jour un dashboard existant
curl -s -X PUT "$DT_URL/api/config/v1/dashboards/<id>" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/json" -d @sante-app.json

Un 400 devuelve un ErrorEnvelope cuyos constraintViolations señalan el campo erróneo. Las management zones tienen identificadores propios de cada entorno: adáptalos al pasar de un entorno a otro.

Uso compartido y permisos

El campo shared hace visible el dashboard para los demás usuarios; sharingDetails (linkShared, published) regula el uso compartido por enlace y la publicación. El propietario (owner) conserva la edición. Un dashboard compartido no da acceso a los datos: cada lector solo ve lo que sus permisos de management zone autorizan. Los dashboards con tiles de un entorno remoto solo puede modificarlos por API un administrador (respuesta 403 en caso contrario).

Aprovisionar con Terraform o Monaco

El provider Terraform de Dynatrace gestiona los dashboards clásicos con el recurso dynatrace_json_dashboard, que toma el JSON del dashboard. Su herramienta de exportación los excluye por defecto: nómbralos explícitamente. Con Monaco, los dashboards son un tipo de configuración específico; desde Monaco CLI 1.208, owner no puede ser nulo y sharingDetails ya no se admite. Consulta la documentación del provider para la sintaxis exacta de tu versión.

Cómo comprobar que funciona

  • La llamada al validador devuelve 204 y el POST devuelve el identificador del nuevo dashboard.
  • El GET de lista muestra el dashboard con el owner correcto.
  • En la interfaz, menú Dashboards: el dashboard aparece, el filtro de management zone se muestra arriba y cada tile del Data Explorer muestra datos en el rango elegido.
  • Con una cuenta limitada a otra management zone, el dashboard compartido solo muestra las entidades autorizadas.

Buenas prácticas

  • Un dashboard, una pregunta: «¿va bien la aplicación?», no «todo sobre todo».
  • Pon los SLI arriba a la izquierda y los detalles debajo.
  • Prefiere percentiles y máximos a las medias para la latencia y la saturación.
  • Limita las top lists a 10 entidades con limit(10): más es ruido.
  • Versiona el JSON y aplícalo con un pipeline; un dashboard modificado a mano se desvía enseguida.
  • Añade un tile Markdown con el runbook: reduce el tiempo hasta la primera acción.

Preguntas frecuentes

¿Son iguales los dashboards de Dynatrace Managed y los de SaaS?

Los dashboards clásicos y la API /api/config/v1/dashboards existen en ambos. En SaaS se suma la nueva aplicación Dashboards basada en Grail y DQL, que no afecta a Managed.

¿Por qué está vacío mi tile del Data Explorer?

Lo más habitual es que la management zone del tile o del dashboard excluya las entidades, o que la métrica no acepte la agregación elegida. Prueba el selector solo en el Data Explorer y vuelve a aplicar después el filtro.

¿Puedo copiar un dashboard entre dos entornos Managed?

Sí: GET de exportación, eliminación de id y metadata, sustitución de los identificadores de management zone, SLO y entidades, y después validación y POST en el entorno de destino.

Conclusión

Un buen dashboard Dynatrace Managed se construye en torno a los SLI: latencia, errores, rendimiento, saturación y problemas abiertos. Con selectores exactos, management zones bien definidas y un JSON versionado, tus tres dashboards se vuelven reproducibles y útiles justo cuando la guardia los necesita. Referencia oficial: API Dashboards de Dynatrace Managed.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Los ejemplos se ofrecen a título indicativo: comprueba siempre los valores en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

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

Previous Post
Dashboard Dynatrace SaaS : construire des tableaux de bord DQL sur Grail, avec 3 exemples complets

Dashboard Dynatrace SaaS: construir dashboards DQL sobre Grail, con 3 ejemplos completos

Next Post
MCP Dynatrace SaaS : installer, authentifier et connaître ses outils

MCP de Dynatrace SaaS: instalar, autenticar y conocer sus herramientas

Related Posts