Curso: Métricas de Dynatrace SaaS · Módulo 1/7 — las métricas de Grail · Duración: ~40 min · Nivel: principiante a intermedio
Objetivos:
- Leer una clave de métrica
dt.*y saber qué mide. - Entender el papel de las dimensiones y del comando DQL
timeseries. - Hacer corresponder una clave clásica
builtin:con su clave de Grail. - Conocer la resolución, la retención y los permisos de las métricas en Grail.
Requisitos previos: un entorno de Dynatrace SaaS con al menos un OneAgent, la aplicación Notebooks y nociones de DQL.
Las métricas de Grail son las series temporales que Dynatrace SaaS guarda en Grail, junto a los logs, los spans y los eventos. Este primer módulo del curso de métricas de Dynatrace SaaS fija el vocabulario: claves dt.*, dimensiones, agregaciones, correspondencia con las claves antiguas y tiempo de conservación.
Para un SRE, una métrica es la materia prima de un SLI. Si lees mal una clave o una unidad, tu SLO mide algo distinto de lo que crees, y la guardia (on-call) paga la diferencia. Dedicar una hora a entender el modelo evita semanas de dashboards engañosos.
Este módulo vale para Dynatrace SaaS (plataforma con Grail). Dynatrace Managed no tiene ni Grail ni DQL: sus métricas se manejan con el metric selector, tratado en el curso de métricas de Dynatrace Managed.
¿Qué son las métricas de Grail?
Una métrica en Grail es una sucesión de mediciones numéricas con marca de tiempo, identificada por una clave y descrita por dimensiones. OneAgent produce automáticamente las métricas integradas (built-in); otras llegan por OpenTelemetry, por la API de ingesta o por extracción a partir de logs y spans (módulo 7).
La documentación resume lo que Grail aporta a las métricas:
- una resolución de un minuto conservada 15 meses;
- un enriquecimiento con el contexto (host, proceso, Kubernetes, cloud);
- una cardinalidad sin límite fijo, útil para despliegues de Kubernetes muy dinámicos;
- la posibilidad de crear series a partir de logs, spans u otros datos.
El consumo de métricas en Grail depende del modelo Dynatrace Platform Subscription (DPS). Revisa tu contrato antes de ingerir métricas personalizadas de forma masiva.
Anatomía de una clave dt.*
Las claves que proporciona Dynatrace siguen tres reglas de nombres, descritas en la página «Built-in Metrics on Grail»:
- el prefijo
builtin:se sustituye pordt., que señala una métrica proporcionada por Dynatrace; - el snake case sustituye al camel case:
bytes_readen lugar debytesRead; - el nombre describe con más precisión la medición:
dt.host.disk.used.percenten lugar deusedPct.
Lee una clave de izquierda a derecha, de lo más general a lo más preciso: dt.host.memory.avail.percent designa la memoria disponible de un host, en porcentaje. Las métricas que crees tú no empiezan por dt.: ese prefijo está reservado.
Correspondencia de builtin: a dt.*
Si vienes de Dynatrace Managed o de Metrics Classic, tus consultas, alertas y dashboards usan claves builtin:. La documentación publica la tabla de correspondencia completa. Este es un extracto real:

Tres casos requieren atención durante una migración:
- Métricas preagregadas ausentes.
builtin:host.net.bytesRxya agregaba las interfaces de red por host. Grail gestiona la cardinalidad alta: se consulta directamentedt.host.net.nic.bytes_rxy se agrupa por host. Del mismo modo,builtin:host.mem.totalno se ha mantenido. - Extensions 1.0. Las métricas
builtin:tech.*procedentes de Extensions 1.0 aparecen con el prefijolegacy., por ejemplolegacy.cassandra.KeyCache.Hit.Rate. Excepción: las métricas de proceso genéricas (builtin:tech.generic.*) y WebSphere. - Servicios. Una treintena de claves de servicio clásicas convergen en tres métricas por endpoint, filtradas por dimensiones (módulo 3). Las métricas calculadas de servicio pasan del prefijo
calc:serviceal prefijoservice.una vez activadas en Grail.
La guía para migrar de Managed a SaaS sitúa esta correspondencia dentro de un proyecto de migración completo.
Dimensiones, agregaciones y timeseries
Una dimensión es un par clave-valor adjunto a cada punto: dt.entity.host, dt.smartscape.host, endpoint.name, k8s.namespace.name… Sirve para filtrar y dividir la serie. Una misma clave de métrica con valores de dimensión distintos forma otras tantas series diferentes.
Una métrica se lee con el comando DQL timeseries, un comando inicial que carga, filtra y agrega en un solo paso. Acepta las agregaciones sum, avg, min, max, count, percentile, percentRank y countDistinct, y parámetros como by:, filter:, interval:, from: o rollup: (min, max, sum, avg, total).
El resultado es homogéneo: todas las series comparten el mismo timeframe y el mismo interval, y cada celda contiene un array de valores, uno por intervalo. Sin interval:, Dynatrace elige un paso adecuado al periodo, alineado con un valor conocido (1, 2, 5, 10 minutos, 1 hora…). Los fundamentos del lenguaje están en el módulo DQL fundamentos; el módulo 7 de este curso profundiza en timeseries.
Explorar las métricas disponibles
El comando metrics lista las series existentes, sin valores ni marcas de tiempo. Sirve para descubrir claves y dimensiones, en los últimos diez días como máximo y con un límite de 100 000 series por consulta. Para obtener los metadatos (descripción, dimensiones), la documentación remite también al archivo de lookup /dt/platform/metrics.metadata.
Ejercicio práctico
Paso 1 — Listar las claves de un host
En un notebook, obtén el identificador de un host monitorizado (formato HOST-…) y ejecuta el ejemplo de la documentación:
metrics
| filter dt.entity.host == "HOST-6DF6DE092963F2AB"
| dedup metric.key
Resultado esperado: una lista de claves dt.host.*, dt.process.* y otras, enviadas por ese host.
Paso 2 — Trazar una primera serie
timeseries usage = avg(dt.host.cpu.usage)
La consulta devuelve una sola serie: la media del uso de CPU de todos los hosts. Muéstrala como curva.
Paso 3 — Dividir por dimensión
timeseries usage = avg(dt.host.cpu.usage), by: {dt.smartscape.host}
| fieldsAdd host_name = getNodeName(dt.smartscape.host)
Resultado esperado: una serie por host, con su nombre legible. Compara el número de filas con el número de hosts del entorno.
Paso 4 — Fijar el intervalo y el periodo
timeseries usage = avg(dt.host.cpu.usage), by: {dt.smartscape.host}, interval: 1h, from: -7d
Observa la columna interval: vale una hora, y cada array contiene unos 168 valores.
Cómo comprobar que funciona
Si timeseries devuelve un error de acceso en lugar de un resultado, revisa tus permisos: la lectura de métricas requiere storage:metrics:read y storage:buckets:read. Un resultado vacío en dt.host.cpu.usage significa por lo general que ningún OneAgent envía datos en el periodo elegido: amplía from: antes de buscar más lejos.
Buenas prácticas
- Comprueba cada clave en la tabla de la documentación antes de ponerla en una alerta: una clave inexistente no lanza ningún error, solo devuelve un resultado vacío.
- Anota la unidad junto al SLI:
dt.service.request.response_time, por ejemplo, se expresa en microsegundos. - Divide por el menor número posible de dimensiones: cada dimensión multiplica el número de series que hay que leer y mostrar.
- Reserva
metricspara la exploración ytimeseriespara los gráficos y los cálculos.
Para ir más lejos
- Métricas de histograma y OpenPipeline, para los percentiles de tus propias métricas
- Dashboard de Dynatrace SaaS: ejemplos DQL
- Documentación oficial: Built-in Metrics on Grail y DQL metric commands
← Presentación del curso · Índice del curso · Módulo 2: métricas de host en Grail →
Preguntas frecuentes
¿Siguen funcionando las claves builtin: en Dynatrace SaaS?
Siguen siendo utilizables con Metrics Classic (API Metrics v2, Data Explorer). En DQL y en Grail hay que emplear las claves dt.* correspondientes, de ahí el interés de la tabla de correspondencia.
¿Cuánto tiempo se conservan las métricas en Grail?
La documentación anuncia una resolución de un minuto durante 15 meses. Las reglas de retención propias de tu cuenta y de tus buckets conviene comprobarlas en los ajustes del entorno.
¿Hay que usar dt.entity.host o dt.smartscape.host?
Ambas dimensiones aparecen en la documentación. Los ejemplos recientes usan dt.smartscape.host con getNodeName(); los ejemplos de referencia de timeseries usan todavía dt.entity.host. Elige una y mantén la coherencia dentro de un mismo dashboard.
Ya sabes leer una clave dt.*, encontrarla a partir de una clave builtin: y trazarla con timeseries. El módulo siguiente aplica estas bases a las métricas de host, las más usadas durante una guardia.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Este curso no sustituye las formaciones y certificaciones oficiales de Dynatrace University. Comprueba siempre las claves de métricas en la documentación oficial correspondiente a tu entorno.