Terraform Dynatrace: alertas, management zones y dashboards con el provider

Terraform Dynatrace paso a paso: provider, management zone, perfil de alerta, dashboard, exportación de lo existente y detección de deriva, SaaS y Managed.
Provider Terraform Dynatrace : alerting, management zones et tableaux de bord

Tu infraestructura ya está descrita en Terraform: redes, clústeres, bases de datos. Pero la observabilidad sigue configurándose a mano, pantalla por pantalla. Con el provider de Terraform Dynatrace, los perfiles de alerta, las management zones y los dashboards se incorporan al mismo repositorio, al mismo plan y a la misma revisión de código que el resto de la plataforma.

Para el equipo SRE, la ganancia es directa: un servicio nuevo llega con sus alertas y su dashboard en la misma merge request, desaparece la deriva entre entornos y la vuelta atrás se hace con git revert. Menos toil, menos alertas huérfanas, un MTTR que ya no depende de la memoria de nadie.

Objetivo de este tutorial: configurar el provider, crear una management zone, un perfil de alerta y un dashboard, y después importar lo existente con la herramienta de exportación. El provider se dirige a Dynatrace SaaS y a Dynatrace Managed; algunos recursos, como los documentos de la plataforma (los nuevos dashboards), están reservados a SaaS. Cada paso lo indica.

Requisitos previos

  • Terraform instalado (versión reciente) y un backend de estado compartido (S3, GCS, Terraform Cloud…): el estado nunca debe quedarse en un equipo personal.
  • Un token de API con settings.read y settings.write para los recursos de Settings 2.0 (alertas, management zones), más ReadConfig y WriteConfig para los dashboards clásicos.
  • En SaaS, para los documentos: un cliente OAuth con los permisos document:documents:read, document:documents:write, document:documents:delete y document:trash.documents:delete.

Si tus SLO ya se gestionan con Terraform, el procedimiento es el mismo; aquí nos centramos en las alertas y en la estructura del entorno.

Configurar el provider de Terraform Dynatrace

Paso 1: declarar el provider

# providers.tf
terraform {
  required_providers {
    dynatrace = {
      source  = "dynatrace-oss/dynatrace"
      version = "~> 1.0"
    }
  }
}

provider "dynatrace" {}

El bloque provider queda vacío: la URL y el token se leen de variables de entorno, nunca se escriben 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"

# SaaS uniquement, pour dynatrace_document
export DT_CLIENT_ID="dt0s02.XXXX"
export DT_CLIENT_SECRET="dt0s02.XXXX.YYYY"
export DT_ACCOUNT_ID="urn:dtaccount:<uuid>"

terraform init

Paso 2: crear una management zone

Una management zone limita la vista y las alertas a un perímetro. Aquí, todo lo que pertenece al clúster de Kubernetes prod-eu, monitorizado por Dynatrace Operator (consulta Conectar Dynatrace Operator a un clúster):

# zones.tf
resource "dynatrace_management_zone_v2" "prod_eu" {
  name = "k8s-prod-eu"
  rules {
    rule {
      type            = "ME"
      enabled         = true
      entity_selector = ""
      attribute_rule {
        entity_type = "CLOUD_APPLICATION_NAMESPACE"
        attribute_conditions {
          condition {
            case_sensitive = false
            key            = "KUBERNETES_CLUSTER_NAME"
            operator       = "EQUALS"
            string_value   = "prod-eu"
          }
        }
      }
    }
  }
}

type = "ME" designa una regla sobre entidades monitorizadas (monitored entities). La elección de las reglas y de las etiquetas que estructuran tus zonas se detalla en Management zones y etiquetado automático.

Paso 3: crear un perfil de alerta

# alerting.tf
resource "dynatrace_alerting" "paiement" {
  name            = "Paiement - production"
  management_zone = ""
  rules {
    rule {
      include_mode     = "INCLUDE_ALL"
      tags             = ["team:paiement", "env:production"]
      delay_in_minutes = 0
      severity_level   = "AVAILABILITY"
    }
    rule {
      include_mode     = "INCLUDE_ALL"
      tags             = ["team:paiement", "env:production"]
      delay_in_minutes = 10
      severity_level   = "PERFORMANCE"
    }
  }
}

Líneas críticas: severity_level elige la familia de problemas y delay_in_minutes el retraso antes de notificar. Una indisponibilidad notifica de inmediato; una degradación de rendimiento espera diez minutos, lo que filtra los picos breves y reduce el ruido de la guardia (on-call). El perfil filtra por etiquetas en lugar de por zona, como recomienda la documentación del provider. Después, vincúlalo a una integración de notificación (consulta Perfiles de alerta e integraciones de notificación).

Paso 4: crear un dashboard

En SaaS, los dashboards de la plataforma son documentos:

# dashboards.tf (SaaS)
resource "dynatrace_document" "paiement" {
  type    = "dashboard"
  name    = "Paiement - santé"
  content = file("${path.module}/dashboards/paiement.json")
}

Lo más sencillo para obtener el JSON es construir el dashboard en la interfaz, descargar su contenido y colocarlo en dashboards/. Así el repositorio conserva una copia legible de cada tile y de cada consulta DQL.

En Managed (y para los dashboards clásicos en SaaS), usa el recurso dynatrace_json_dashboard:

resource "dynatrace_json_dashboard" "paiement" {
  contents = file("${path.module}/dashboards/paiement-classic.json")
}

Paso 5: planificar y aplicar

terraform fmt -check
terraform validate
terraform plan -out=tfplan
terraform apply tfplan

Lee el plan como una revisión de código: una línea -/+ (destrucción y recreación) sobre un perfil de alerta en producción merece una pregunta antes del apply.

Paso 6: importar lo existente

El binario del provider incluye una herramienta de exportación que genera HCL a partir de un entorno existente. Se invoca directamente, no mediante terraform:

./terraform-provider-dynatrace -export dynatrace_alerting dynatrace_management_zone_v2

Añade -import-state para generar también el estado, de modo que Terraform considere los objetos como ya gestionados. Revisa el código generado antes de fusionarlo: refleja lo existente, incluidas sus incoherencias. Los dashboards están excluidos de la exportación por defecto y hay que pedirlos explícitamente.

Cómo comprobar que funciona

  • terraform apply termina con Apply complete! y el número de recursos esperado.
  • Un segundo terraform plan muestra No changes: el entorno coincide con el código.
  • En Dynatrace, la management zone k8s-prod-eu aparece en los ajustes y filtra bien los namespaces del clúster; el perfil «Paiement – production» lista sus dos reglas.
  • Mediante la API, el perfil existe bajo el esquema builtin:alerting.profile:
curl -s -H "Authorization: Api-Token $DYNATRACE_API_TOKEN" \
  "$DYNATRACE_ENV_URL/api/v2/settings/objects?schemaIds=builtin:alerting.profile&fields=value" \
  | jq '.items[].value.name'

Buenas prácticas

  • Detección de deriva: ejecuta terraform plan cada noche en CI. Un plan no vacío señala una modificación hecha a mano.
  • Una sola herramienta por objeto: un perfil gestionado por Terraform no debe estar gestionado también por Monaco ni por la interfaz.
  • Módulos por equipo: un módulo «servicio» que cree zona, perfil y dashboard a partir de unas pocas variables garantiza que cada servicio nuevo arranque con unas alertas correctas.
  • Secretos fuera del código: variables de entorno en CI, estado cifrado, ningún token en un .tfvars versionado.
  • Datos sensibles en el estado: el estado puede contener valores de configuración; restringe su acceso como si fuera un secreto.

Preguntas frecuentes

¿Funciona el provider de Terraform Dynatrace con Managed?

Sí para la mayoría de los recursos de configuración y Settings 2.0, con una URL de la forma https://<dominio>/e/<env-id>. Los recursos de la plataforma SaaS, como dynatrace_document, no se aplican a Managed.

¿Por qué mi plan quiere recrear un recurso sin cambios?

A menudo porque un campo calculado en el servidor difiere del valor escrito (orden de una lista, valor por defecto). Alinea el código con el valor devuelto por la exportación y vuelve a lanzar el plan.

¿Hay que preferir Monaco?

Si tus equipos ya viven en Terraform, quédate con Terraform: una sola cadena de herramientas, un único proceso de revisión. Monaco sigue siendo pertinente para equipos centrados en Dynatrace que quieran un modelo más ligero.

Conclusión

Con Terraform Dynatrace, las alertas y la estructura del entorno siguen el mismo ciclo que la infraestructura: código, plan, revisión, apply. Empieza exportando lo existente, estabiliza un primer módulo para un servicio y después activa la detección de deriva. La observabilidad se vuelve reproducible, y un entorno nuevo queda listo con un solo apply.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Los recursos y atributos del provider evolucionan: compruébalos en la documentación del provider y en la documentación oficial, según tu versión.

Total
0
Shares
Leave a Reply

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

Previous Post
Dynatrace Monaco : la configuration en code, pas à pas

Dynatrace Monaco: la configuración como código, paso a paso

Next Post
Intégration Dynatrace AWS : CloudWatch, métriques et logs pas à pas

Integración de Dynatrace AWS: CloudWatch, métricas y logs paso a paso

Related Posts