SLO Dynatrace Terraform: un SLO para cada servicio, generado en masa

SLO Dynatrace Terraform: genera un SLO de disponibilidad por servicio desde un archivo YAML con for_each, revisado en merge request, en SaaS y Managed.
SLO Dynatrace Terraform : un SLO pour chaque service, généré en masse

Tres SLO creados a mano son manejables. Ochenta servicios, cada uno con un SLO de disponibilidad, son toil: clics repetidos, objetivos que divergen y SLO olvidados con cada servicio nuevo. Una configuración de SLO Dynatrace Terraform convierte ese trabajo manual en una lista versionada y revisada en una merge request.

El objetivo de este tutorial: generar un SLO de disponibilidad por servicio a partir de un único archivo de configuración, con el provider de Terraform para Dynatrace y un bucle for_each, y después verificar el resultado. El contenido se apoya en los SLO clásicos (Settings 2.0), disponibles en Dynatrace Managed y en Dynatrace SaaS. Una sección señala la opción de los nuevos SLO de Grail en SaaS.

Antes de automatizar, asegúrate de que tus indicadores tienen sentido: consulta cómo elegir tus SLI.

El principio

  • Un archivo services.yaml lista los servicios y su objetivo.
  • Terraform lee ese archivo con yamldecode y crea un recurso SLO por entrada.
  • Añadir un servicio es añadir tres líneas y pasar una revisión de código. Borrar una línea elimina el SLO.

Requisitos previos

  • Terraform 1.5 o posterior.
  • El provider dynatrace-oss/dynatrace (registro de Terraform).
  • Un token de API con los scopes que exige el recurso dynatrace_slo_v2: slo.read, slo.write, settings.read y settings.write. Comprueba la lista en la documentación del provider.
  • Servicios con una etiqueta (tag) común, por ejemplo service:checkout, aplicada por tus reglas de tagging (consulta management zones y tagging).

SLO Dynatrace Terraform: la generación paso a paso

Paso 1: configurar el provider

terraform {
  required_providers {
    dynatrace = {
      source = "dynatrace-oss/dynatrace"
    }
  }
}

provider "dynatrace" {}

El provider lee la URL y el token del entorno. No los escribas nunca en el código:

# SaaS
export DYNATRACE_ENV_URL="https://<env-id>.live.dynatrace.com"
# Managed
export DYNATRACE_ENV_URL="https://<votre-domaine>/e/<env-id>"
export DYNATRACE_API_TOKEN="dt0c01.XXXX"

Fija una versión del provider (version = "~> 1.x" con la versión probada) para evitar un cambio de esquema imprevisto.

Paso 2: describir los servicios en un archivo

# services.yaml
checkout:
  tag: "service:checkout"
  target: 99.9
  warning: 99.95
cart:
  tag: "service:cart"
  target: 99.5
  warning: 99.7
search:
  tag: "service:search"
  target: 99.5
  warning: 99.7

Este archivo se convierte en el catálogo de tus objetivos. El product owner puede revisarlo sin conocer Terraform.

Paso 3: escribir el recurso con for_each

locals {
  services = yamldecode(file("${path.module}/services.yaml"))
}

resource "dynatrace_slo_v2" "availability" {
  for_each = local.services

  name               = "Disponibilité ${each.key}"
  enabled            = true
  custom_description = "Requêtes serveur sans erreur / requêtes. Géré par Terraform."
  evaluation_type    = "AGGREGATE"
  evaluation_window  = "-30d"
  filter             = "type(\"SERVICE\"),tag(\"${each.value.tag}\")"
  metric_name        = "availability_${replace(each.key, "-", "_")}"
  metric_expression  = "(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())"
  target_success     = each.value.target
  target_warning     = each.value.warning

  error_budget_burn_rate {
    burn_rate_visualization_enabled = true
    fast_burn_threshold             = 14.4
  }
}

Líneas críticas:

  • for_each = local.services: una instancia por clave del YAML, direccionada por su nombre (dynatrace_slo_v2.availability["checkout"]). A diferencia de count, quitar un servicio no desplaza a los demás.
  • filter: el selector de entidades restringe el SLO a los servicios que llevan la etiqueta. Las comillas internas van escapadas.
  • metric_name: debe ser único; sirve para exponer el SLO como métrica.
  • fast_burn_threshold: alineado con la alerta rápida descrita en alertas de burn rate de SLO.

Los nombres de los atributos dependen de la versión del provider. Lo más seguro: crea un SLO a mano, expórtalo con la herramienta de exportación del provider y compáralo después con tu código.

Paso 4: planificar y aplicar

terraform init
terraform plan -out slo.plan
terraform apply slo.plan

El plan debe anunciar exactamente una creación por servicio del YAML. Revísalo en la merge request antes del apply, idealmente desde un pipeline de CI.

¿Y los nuevos SLO de Grail en SaaS?

En SaaS, los SLO de la aplicación Service-Level Objectives (basados en DQL) se gestionan con otro recurso del provider, distinto de dynatrace_slo_v2. Su nombre y sus atributos han cambiado entre versiones: consulta la documentación del provider antes de usarlo. El patrón for_each sigue siendo el mismo; solo cambia la definición del SLI, con una consulta DQL como las de crear un SLO OpenTelemetry.

El mismo patrón se extiende a un segundo tipo de SLI. Añade un campo opcional latency_ms en el YAML y filtra después el mapa para crear el SLO de latencia solo en los servicios que lo declaran:

locals {
  latency_services = {
    for name, svc in local.services : name => svc
    if try(svc.latency_ms, null) != null
  }
}

Un segundo recurso dynatrace_slo_v2 con for_each = local.latency_services retoma entonces la estructura del paso 3, con una expresión de métrica de latencia adaptada a tu versión (comprueba en la documentación las métricas de tiempo de respuesta disponibles). El catálogo sigue siendo único: un servicio, una entrada, todos sus objetivos.

Cómo comprobar que funciona

  1. terraform state list muestra un recurso por servicio: dynatrace_slo_v2.availability["cart"], etc.
  2. Un segundo terraform plan anuncia «No changes». Si no, la API normaliza algún atributo: alinea tu código con el valor devuelto.
  3. En la pantalla Service-level objectives, cada SLO muestra un estado y un error budget, y no «no data». Un «no data» indica casi siempre una etiqueta ausente o mal escrita en filter.

Buenas prácticas

  • Guarda el estado de Terraform en un backend remoto con bloqueo, nunca en un equipo personal.
  • Prohíbe la modificación manual de los SLO gestionados: la mención «Géré par Terraform» en la descripción ayuda al equipo.
  • Ejecuta terraform plan cada noche en CI para detectar derivas.
  • Mantén los objetivos en el YAML, no en el HCL: la conversación gira en torno a los objetivos, no al código.
  • Para el resto de la automatización, consulta automatizar con la API del clúster.

Preguntas frecuentes

¿Se pueden importar SLO ya creados a mano?

Sí, con un bloque import (Terraform 1.5+) o con terraform import, usando el identificador del ajuste. Añade primero la entrada en el YAML para que exista la dirección.

¿Cómo generar la lista de servicios automáticamente?

El provider ofrece una fuente de datos de entidades que lista los servicios. Es práctico, pero un SLO por servicio sin revisión humana produce enseguida SLO sin responsable. Es preferible un YAML revisado.

¿Funciona este código en Managed sin conexión?

Sí, si la máquina que ejecuta Terraform alcanza la API del clúster y dispone del provider en un mirror local.

Conclusión

Un archivo YAML, un recurso y un bucle for_each bastan para dar un SLO a cada servicio, con revisión de código e historial. El toil desaparece y cada servicio nuevo llega con su objetivo desde el primer día.

Siguiente paso aconsejado: conectar este repositorio a tu pipeline de CI, con un plan automático en cada merge request y un apply manual tras la validación. Empieza por tres servicios piloto, comprueba que los SLO muestran datos reales y abre después el catálogo a los demás equipos.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. 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
Choisir ses SLI : la méthode pratique, des requêtes DQL aux objectifs

Elegir SLI: el método práctico, de las consultas DQL a los objetivos

Next Post
Budget d'erreur release gate : bloquer une mise en production avec Dynatrace (SaaS et Managed)

Release gate de presupuesto de error: bloquear un paso a producción con Dynatrace (SaaS y Managed)

Related Posts