Migrar SLO a Grail: de los SLO clásicos a los nuevos SLO de Dynatrace

Migrar SLO a Grail sin perder el hilo: inventario por API, SLI reescritos en DQL, doble ejecución de comparación y paso de las alertas en SaaS.
Migrer SLO Grail : passer des SLO classiques aux nouveaux SLO Dynatrace

Tus SLO clásicos llevan años funcionando, pero sus expresiones de métricas se vuelven difíciles de mantener y el equipo quiere gestionarlo todo con DQL. Migrar SLO a Grail no se hace con un clic: cada objetivo debe reescribirse, compararse y pasarse sin perder el histórico del presupuesto de error (error budget). Este tutorial explica cómo migrar SLO a Grail uno a uno, sin romper tus alertas.

Objetivo: al terminar tendrás un inventario de tus SLO clásicos, su equivalente en DQL sobre Grail, un periodo de doble ejecución (double run) que demuestre que ambos cálculos coinciden y un plan para pasar las alertas. El contenido se refiere a Dynatrace SaaS: los nuevos SLO se basan en Grail, que no existe en Dynatrace Managed. En Managed te quedas con los SLO clásicos; la sección dedicada más abajo indica qué preparar.

Si partes de cero con los indicadores, lee antes cómo elegir tus SLI con DQL.

El problema: dos motores de SLO que divergen

Un SLO clásico calcula su ratio a partir de una expresión de métricas (por ejemplo builtin:service.errors.total.successCount dividido entre builtin:service.requestCount.total). Un SLO sobre Grail calcula el suyo a partir de una consulta DQL. Los dos motores no agregan necesariamente de la misma manera: resolución, tratamiento de los huecos de datos, alcance de las entidades. Sin comparación, corres el riesgo de pasar a un SLO que muestra 99,95 % donde el anterior mostraba 99,80 %, y de ocultar un consumo real de presupuesto.

Requisitos previos

  • Un entorno de Dynatrace SaaS sobre la plataforma Grail, con la aplicación Service-Level Objectives (el nombre exacto puede variar según la versión: compruébalo en docs.dynatrace.com).
  • Un token de API clásico con el scope de lectura de SLO (slo.read) para el inventario.
  • Los permisos para leer métricas en Grail y crear SLO en la nueva aplicación.
  • curl y jq en tu equipo.

Paso 1: inventariar los SLO clásicos

La API v2 de los SLO clásicos devuelve la lista paginada, con el objetivo, la ventana y la expresión de métricas.

export DT_ENV="https://VOTRE-ENV.live.dynatrace.com"
export DT_TOKEN="dt0c01.XXXX"   # scope slo.read

curl -s "$DT_ENV/api/v2/slo?pageSize=200&evaluate=false" \
  -H "Authorization: Api-Token $DT_TOKEN" \
| jq -r '.slo[] | [.id, .name, .target, .timeframe, .metricExpression] | @tsv' \
> inventaire-slo.tsv

wc -l inventaire-slo.tsv

Los campos críticos: target (el objetivo, por ejemplo 99.9), timeframe (por ejemplo -30d) y metricExpression, la fórmula que hay que traducir. Si la respuesta contiene un nextPageKey, vuelve a lanzar la llamada con ese parámetro.

Paso 2: clasificar antes de migrar

No lo migres todo. Clasifica cada línea del inventario en tres grupos:

  1. Migrar: SLO con seguimiento, vinculado a una alerta o a un dashboard.
  2. Fusionar: varios SLO que miden el mismo recorrido con filtros ligeramente distintos.
  3. Eliminar: SLO huérfano que nadie consulta. Cada SLO conservado cuesta mantenimiento: es toil.

Paso 3: migrar SLO a Grail reescribiendo el SLI en DQL

Tomemos un SLO clásico de tasa de éxito de un servicio. En Grail, las métricas de servicio se exponen con claves como dt.service.request.count y dt.service.request.failure_count. La siguiente consulta calcula el SLI en el mismo periodo:

timeseries {
    total    = sum(dt.service.request.count),
    failures = sum(dt.service.request.failure_count)
  },
  by: { dt.entity.service },
  filter: { in(dt.entity.service, "SERVICE-0123456789ABCDEF") }
| fieldsAdd sli = 100 * (total[] - failures[]) / total[]

Puntos que vigilar:

  • total[] - failures[] aplica la operación a cada intervalo de la serie: el SLI es, por tanto, una serie temporal, que es lo que espera un SLO personalizado.
  • El nombre del campo de salida importa. Las plantillas de SLO personalizado esperan un campo concreto (a menudo sli): comprueba la convención en la documentación de la aplicación antes de validar.
  • Sustituye el identificador de servicio fijo por un filtro sobre una etiqueta o una zona en cuanto haya varios servicios implicados.

Crea después el SLO en la aplicación: pega la consulta y conserva exactamente el mismo objetivo y la misma ventana que el SLO clásico. Cambiar el objetivo durante la migración inutilizaría la comparación.

Paso 4: la doble ejecución (double run)

Mantén los dos SLO activos durante al menos una ventana completa, idealmente dos. Cada día, compara los valores. Por el lado clásico, la API devuelve la evaluación:

curl -s "$DT_ENV/api/v2/slo/ID_DU_SLO?timeFrame=CURRENT" \
  -H "Authorization: Api-Token $DT_TOKEN" \
| jq '{name, evaluatedPercentage, errorBudget}'

Por el lado de Grail, reutiliza la consulta del paso 3 agregando sobre la ventana completa:

timeseries {
    total    = sum(dt.service.request.count),
    failures = sum(dt.service.request.failure_count)
  },
  from: now()-30d,
  filter: { in(dt.entity.service, "SERVICE-0123456789ABCDEF") }
| fieldsAdd t = arraySum(total), f = arraySum(failures)
| fieldsAdd sli = 100 * (t - f) / t
| fields sli

Tolera una diferencia pequeña (del orden de unas centésimas de punto) debida a las diferencias de agregación. Una diferencia mayor señala casi siempre un alcance distinto: un servicio añadido, un filtro de peticiones clave olvidado, o peticiones sintéticas contadas en un lado y no en el otro.

Paso 5: pasar las alertas

La migración no ha terminado hasta que la guardia (on-call) recibe las alertas del nuevo SLO. Retoma la lógica multiventana descrita en alertas de burn rate de SLO en Dynatrace, aplicada al SLO de Grail. Activa la nueva alerta, deja la antigua en paralelo unos días y desactiva después la antigua. Elimina el SLO clásico solo después de exportar su histórico, si tus informes mensuales dependen de él.

Si gestionas tus SLO como código, actualiza tus definiciones de Terraform en lugar de hacer clic en la interfaz: consulta SLO de Dynatrace con Terraform. Comprueba en la documentación del provider qué recurso corresponde a los nuevos SLO, porque difiere del de los SLO clásicos.

¿Y en Dynatrace Managed?

Dynatrace Managed no tiene Grail: los nuevos SLO no están disponibles en él. Aun así, puedes preparar una futura migración a SaaS:

  • exportar el inventario con la misma llamada a la API (la URL contiene entonces /e/ID-ENVIRONNEMENT);
  • limpiar los SLO huérfanos desde ahora;
  • documentar, para cada SLO, la intención de negocio en una frase. Sobrevivirá a la reescritura.

Cómo comprobar que funciona

  1. En la aplicación de SLO, el nuevo SLO muestra un estado y un error budget restante, sin mensaje de error de consulta.
  2. La tabla de comparación de la doble ejecución muestra una diferencia estable y pequeña en toda la ventana.
  3. En un Notebook, la consulta del paso 4 devuelve una sola fila con un sli coherente con la aplicación.
  4. Una prueba controlada (errores inyectados en preproducción) hace bajar los dos SLO de la misma manera y dispara la nueva alerta.

Buenas prácticas

  • Un objetivo sin cambios durante la migración: se cambia el motor o el objetivo, nunca los dos a la vez.
  • Migrar por lotes: empieza por los tres SLO más seguidos, no por los cincuenta.
  • Nombrar con claridad: un sufijo temporal como «(Grail)» evita confundir los dos SLO durante la doble ejecución.
  • Dejar rastro de las decisiones: anota en un ticket cada fusión o eliminación, con el motivo.
  • Revisar los dashboards: los paneles que apuntan al SLO antiguo deben seguir, consulta el dashboard de SLO para la dirección.

Preguntas frecuentes

¿Existe una herramienta de migración automática de SLO clásicos?

Las capacidades cambian según las versiones de Dynatrace SaaS. Consulta la documentación oficial para saber si tu entorno ofrece un asistente de conversión. Incluso con un asistente, la doble ejecución sigue siendo indispensable para validar las cifras.

¿Se pierde el histórico del error budget al migrar?

El nuevo SLO recalcula su SLI a partir de los datos presentes en Grail, según la retención de tus métricas. El histórico del SLO clásico no se transfiere tal cual. Expórtalo si lo necesitas para informes.

¿Se pueden mantener SLO clásicos y SLO de Grail a la vez?

Sí; durante la transición incluso se recomienda. A la larga, evita dos fuentes de verdad para un mismo objetivo: la guardia debe saber qué cifra manda.

Conclusión

Migrar SLO a Grail es, primero, clasificar; después reescribir cada SLI en DQL, comparar durante una ventana completa y solo entonces pasar las alertas. Esta disciplina evita «ganar» puntos de fiabilidad por un simple cambio de cálculo y mantiene honesto el error budget.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de su propietario. Las funciones de SaaS evolucionan rápido: comprueba su disponibilidad en tu entorno y en la documentación oficial.

Total
0
Shares
Leave a Reply

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

Previous Post
Tableau de bord SLO pour la direction : statut, budget restant et tendance dans Dynatrace

Dashboard de SLO para la dirección: estado, presupuesto restante y tendencia en Dynatrace

Next Post
SLO parcours utilisateur : mesurer ce que vit le client avec RUM et synthétique

SLO de recorrido de usuario: mide lo que vive el cliente con RUM y sintético

Related Posts