SLO Dynatrace Managed: configuración, límites y API (tutorial)

SLO Dynatrace Managed: define el SLI con un metric selector, crea el SLO con la API v2, comprueba el error budget y conoce los límites frente a SaaS.
SLO Dynatrace Managed : configuration, limites et API (tutoriel)

Operas un clúster on-premise y quieres objetivos de fiabilidad medibles, no solo dashboards. Los SLO Dynatrace Managed existen, pero no funcionan como los nuevos SLO de la plataforma SaaS: sin Grail, sin DQL, todo se apoya en metric selectors. Muchos equipos descubren estas diferencias en el momento de conectar las alertas.

Objetivo: al terminar este tutorial tendrás un SLO de disponibilidad sobre un servicio crítico, creado primero con la interfaz y después con la API Environment v2, versionado como JSON, y sabrás comprobar su estado y su error budget. El contenido se aplica a Dynatrace Managed. Las diferencias con Dynatrace SaaS se señalan en una sección específica.

Si todavía no has elegido tus indicadores, empieza por elegir tus SLI: un SLO solo es útil si el SLI refleja la experiencia del usuario.

El problema: un SLO Dynatrace Managed no es un SLO de Grail

En el SaaS reciente, un SLO se apoya en una consulta DQL y en los datos de Grail. En Managed, un SLO es un objeto de configuración del entorno, evaluado a partir de una expresión de métrica (metric selector) sobre las métricas clásicas, por ejemplo builtin:service.*. Consecuencias prácticas:

  • el SLI debe poder expresarse con las métricas disponibles en el entorno (integradas, calculadas o ingeridas);
  • la ventana de evaluación es un intervalo relativo (por ejemplo -1w), no un calendario libre;
  • el período de retención de las métricas del clúster limita la profundidad de historial aprovechable.

Requisitos previos

  • Un entorno Dynatrace Managed actualizado, con al menos un servicio monitorizado por OneAgent.
  • Un usuario con permiso para modificar la configuración del entorno.
  • Un token de API de entorno con los scopes slo.read y slo.write (y metrics.read para la comprobación). Los nombres exactos de los scopes figuran en la página de creación de tokens: compruébalos en tu versión.
  • curl y jq en tu equipo.

En los ejemplos, la URL de la API de Managed tiene la forma https://{votre-cluster}/e/{environment-id}/api/v2/.

Paso 1: definir el SLI con un metric selector

Tomemos un SLI de disponibilidad: el porcentaje de peticiones de servidor sin error. Prueba primero la expresión en el explorador de datos o con la API de métricas:

export DT_ENV="https://cluster.example.com/e/abc12345"
export DT_TOKEN="dt0c01.XXXX"

curl -s -G "$DT_ENV/api/v2/metrics/query" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  --data-urlencode 'metricSelector=(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())' \
  --data-urlencode 'entitySelector=type(SERVICE),entityId(SERVICE-0123456789ABCDEF)' \
  --data-urlencode 'from=-1w' | jq '.result[0].data[0].values[-5:]'

Puntos críticos: los dos operandos deben referirse a la misma entidad, y splitBy() sin argumento lo agrega todo. Si la consulta devuelve valores vacíos, la métrica no existe con ese nombre en tu versión: lístalas con GET /api/v2/metrics?text=service.errors.

Paso 2: crear el SLO Dynatrace Managed desde la interfaz

En el menú, abre Service-level objectives (la etiqueta puede variar según la versión) y añade un SLO. Rellena:

  1. el nombre y un nombre de métrica corto (sirve para construir las métricas func:slo.*);
  2. la expresión de métrica del paso 1;
  3. el filtro de entidad (el servicio afectado);
  4. el objetivo (por ejemplo 99,5) y el umbral de advertencia (por ejemplo 99,8);
  5. la ventana de evaluación (por ejemplo 7 días).

El asistente también permite partir de plantillas predefinidas. Es práctico para una primera prueba, pero mantén la expresión explícita para poder revisarla.

Paso 3: crear el mismo SLO con la API

Para evitar la deriva de configuración entre entornos, describe el SLO en un archivo versionado:

{
  "enabled": true,
  "name": "checkout - disponibilite",
  "customDescription": "Requetes serveur sans erreur, service checkout",
  "metricName": "checkout_availability",
  "metricExpression": "(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())",
  "evaluationType": "AGGREGATE",
  "filter": "type(\"SERVICE\"),entityId(\"SERVICE-0123456789ABCDEF\")",
  "target": 99.5,
  "warning": 99.8,
  "timeframe": "-1w"
}
curl -s -X POST "$DT_ENV/api/v2/slo" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d @slo-checkout.json -i | head -n 1

Una respuesta 201 confirma la creación. El esquema exacto del cuerpo puede cambiar de una versión de clúster a otra: compáralo con la referencia de la API de SLO en docs.dynatrace.com antes de industrializarlo. Para gestionar varios SLO, la vía más robusta sigue siendo Terraform, detallada en SLO de Dynatrace con Terraform.

Paso 4: conectar una alerta

Un SLO sin alerta sigue siendo solo una cifra. En Managed existen dos enfoques: una alerta sobre el estado o el error budget, y una alerta sobre el burn rate mediante un evento de métrica sobre las métricas func:slo.*. La segunda es la más útil para la guardia (on-call) y se describe paso a paso en alertas de burn rate de SLO. Después, enruta la alerta con un perfil de alertas dedicado, como se explica en alertas, perfiles e integraciones.

Cómo comprobar que funciona

  1. Lista los SLO y obtén el identificador:
    curl -s "$DT_ENV/api/v2/slo?pageSize=25&evaluate=true" \
      -H "Authorization: Api-Token $DT_TOKEN" \
      | jq '.slo[] | {id, name, status, evaluatedPercentage, errorBudget}'
  2. Comprueba que evaluatedPercentage se acerca al valor obtenido en el paso 1. Sin evaluate=true, la lista no evalúa los SLO (el tamaño de página queda entonces limitado a 25). Una diferencia importante suele indicar un filtro de entidad distinto.
  3. Si el estado sigue vacío o en error, el campo error de la respuesta suele indicar la causa (expresión inválida, entidad ausente).
  4. En la interfaz, la página del SLO debe mostrar el estado, el error budget restante y la tendencia.

Límites que conviene conocer en Managed

  • Sin DQL: un SLI que exige cruzar logs y trazas debe convertirse antes en una métrica (métrica calculada o ingesta).
  • Retención: la resolución de las métricas disminuye con la antigüedad de los datos según la política del clúster; una ventana de 30 días sigue siendo posible, pero la precisión depende de tu configuración.
  • Carga: cada SLO se evalúa con regularidad. Decenas de SLO con expresiones pesadas cargan el clúster; prefiere expresiones sencillas.
  • Funciones de SaaS ausentes: los SLO de Grail, Site Reliability Guardian en su forma de aplicación de plataforma y los Workflows no están disponibles en Managed. Comprueba la matriz de disponibilidad en la documentación.

Diferencias con Dynatrace SaaS

En SaaS, los SLO clásicos siguen disponibles en los entornos correspondientes, pero los nuevos SLO se apoyan en DQL y Grail, lo que permite SLI sobre cualquier dato, incluido OpenTelemetry. Si preparas una migración, mantén tus SLI sencillos y documentados: se traducirán con más facilidad. Para el lado SaaS, consulta SLO con OpenTelemetry y DQL.

Buenas prácticas

  • Un SLO por recorrido de usuario crítico, no uno por microservicio.
  • Umbral de advertencia por encima del objetivo para reaccionar antes de agotar el presupuesto.
  • Archivos JSON o Terraform versionados y revisados como código: menos toil, menos errores manuales.
  • Nombre de métrica estable: renombrarlo rompe las alertas y los dashboards que dependen de él.
  • Revisión mensual del error budget con el equipo de producto, en modo blameless (sin culpa).

Preguntas frecuentes

¿Se pueden usar métricas de OpenTelemetry para un SLO en Managed?

Sí, si se ingieren como métricas en el entorno y se pueden consultar con un metric selector. Comprueba antes la consulta con la API de métricas.

¿Qué ventana de evaluación elegir?

Siete días van bien para el seguimiento de un equipo. Treinta días encajan mejor con un compromiso contractual, siempre que la retención de tu clúster lo permita.

¿Hace falta un token por equipo?

Es lo recomendable: un token por pipeline, con solo los scopes de SLO necesarios, limita el impacto de una filtración y facilita la auditoría.

Conclusión

Los SLO en Managed exigen más rigor con el SLI, pero ofrecen una base sólida: expresión de métrica probada, objeto versionado mediante la API y alerta sobre el burn rate. Empieza por un servicio crítico, mide durante una semana y después amplía.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Las pantallas y los campos de la API pueden variar según la versión de tu clúster. Comprueba siempre los valores (puertos, versiones, tamaños) 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
Postmortem sans blâme avec Dynatrace : modèle de document et requêtes DQL

Postmortem sin culpa con Dynatrace: plantilla de documento y consultas DQL

Next Post
SLO Dynatrace Grafana : le comparatif avec Prometheus mis en pratique

Comparativa SLO Dynatrace Grafana: el contraste con Prometheus puesto en práctica

Related Posts