Módulo 1 — Métricas de Grail: claves dt.*, dimensiones y retención en Dynatrace SaaS

Métricas de Grail explicadas: claves dt.*, dimensiones, comando timeseries, correspondencia de builtin: a dt.* y retención, con un ejercicio en DQL.
Module 1 — Métriques Grail : clés dt.*, dimensions et rétention dans Dynatrace SaaS

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 por dt., que señala una métrica proporcionada por Dynatrace;
  • el snake case sustituye al camel case: bytes_read en lugar de bytesRead;
  • el nombre describe con más precisión la medición: dt.host.disk.used.percent en lugar de usedPct.

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:

Extracto de la documentación Built-in Metrics on Grail: claves de Grail dt.host junto a sus claves Classic builtin

Tres casos requieren atención durante una migración:

  • Métricas preagregadas ausentes. builtin:host.net.bytesRx ya agregaba las interfaces de red por host. Grail gestiona la cardinalidad alta: se consulta directamente dt.host.net.nic.bytes_rx y se agrupa por host. Del mismo modo, builtin:host.mem.total no se ha mantenido.
  • Extensions 1.0. Las métricas builtin:tech.* procedentes de Extensions 1.0 aparecen con el prefijo legacy., por ejemplo legacy.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:service al prefijo service. 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 metrics para la exploración y timeseries para los gráficos y los cálculos.

Para ir más lejos

← 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.

Total
0
Shares
Leave a Reply

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

Previous Post
Parcours métriques Dynatrace SaaS : la formation en 6 modules

Curso de métricas de Dynatrace SaaS: la formación en 7 módulos

Next Post
Module 2 — Métriques hôte Grail : CPU, mémoire, disque et réseau dt.host.*

Módulo 2 — Métricas de host de Grail: CPU, memoria, disco y red dt.host.*

Related Posts