Tus equipos ya exponen métricas en formato Prometheus: un exporter de Redis, un endpoint /metrics en cada microservicio, las métricas de un ingress. Ignorarlas equivale a tirar SLI que ya están listos. Conectar Prometheus Dynatrace a tu clúster de Kubernetes las lleva a la misma plataforma que las trazas y los logs, sin reescribir una línea de código.
Desde el punto de vista del SRE, lo que está en juego es sencillo: un SLO de latencia calculado sobre un histograma de Prometheus solo tiene valor si se correlaciona con el despliegue, el pod y la traza que lo explican. Si no, la guardia (on-call) cruza los datos a mano y el MTTR se alarga.
Objetivo de este tutorial: recuperar métricas de Prometheus en Dynatrace de dos maneras, mediante anotaciones de pods leídas por el ActiveGate y mediante un OpenTelemetry Collector, y comprobar la ingesta. El contenido vale para Dynatrace SaaS y Dynatrace Managed; se señalan las diferencias.
Dos métodos para Prometheus Dynatrace en Kubernetes
| Método | Cuándo elegirlo | Límites |
|---|---|---|
Anotaciones metrics.dynatrace.com/* leídas por el ActiveGate |
Clúster ya monitorizado con Dynatrace Operator, pocos exporters | Topes documentados: 1000 pods exporters, 1000 métricas por pod |
OpenTelemetry Collector con el receptor prometheus |
Despliegue nuevo, clúster grande, necesidad de filtrar o enriquecer | Un componente más que operar y monitorizar |
La documentación recomienda ahora el Collector para los despliegues nuevos y para cualquier clúster que se acerque a los topes del ActiveGate. Los dos métodos pueden coexistir durante una migración, siempre que no se haga scraping dos veces del mismo pod.
Requisitos previos
- Un clúster de Kubernetes y
kubectlcon derechos de administración. - Método 1: Dynatrace Operator desplegado con un ActiveGate en el clúster; consulta conectar Dynatrace Operator a un clúster.
- Método 2: un token de API con el scope de ingesta de métricas (
metrics.ingest), guardado en un secreto de Kubernetes. - Un exporter que ya responda:
curl http://<pod-ip>:9121/metricsdebe devolver texto.
Método 1: anotaciones leídas por el ActiveGate
Paso 1: activar la recopilación
En los ajustes de monitorización del clúster de Kubernetes en Dynatrace, activa la monitorización de namespaces, servicios, workloads y pods, y después la opción de monitorización de los exporters de Prometheus anotados. Sin este ajuste, las anotaciones se ignoran.
Paso 2: anotar el pod del exporter
apiVersion: apps/v1
kind: Deployment
metadata:
name: redis-exporter
spec:
selector:
matchLabels: { app: redis-exporter }
template:
metadata:
labels: { app: redis-exporter }
annotations:
metrics.dynatrace.com/scrape: "true"
metrics.dynatrace.com/port: "9121"
metrics.dynatrace.com/path: "/metrics"
metrics.dynatrace.com/filter: |
{
"mode": "include",
"names": ["redis_up", "redis_connected_clients", "redis_db_keys"]
}
spec:
containers:
- name: exporter
image: oliver006/redis_exporter:v1.62.0
ports:
- containerPort: 9121
Las líneas críticas: las anotaciones se colocan en la plantilla del pod, no en el propio Deployment. port es obligatorio y path vale /metrics por defecto. El filter en modo include es tu barrera de seguridad (guardrail) de volumen: un exporter suele exponer cientos de series de las que solo sirven tres.
Si una NetworkPolicy protege el namespace, autoriza el tráfico desde el pod del ActiveGate del namespace dynatrace. Es la causa número uno de las métricas ausentes.
Método 2: un OpenTelemetry Collector que hace scraping
Paso 1: el secreto
kubectl create namespace otel
kubectl -n otel create secret generic dynatrace-otelcol-dt-api-credentials \
--from-literal=DT_ENDPOINT=https://<environment-id>.live.dynatrace.com/api/v2/otlp \
--from-literal=DT_API_TOKEN=<token-metrics-ingest>
En Managed, el endpoint OTLP pasa por un ActiveGate: https://<activegate>:9999/e/<environment-id>/api/v2/otlp.
Paso 2: la configuración del Collector
receivers:
prometheus:
config:
scrape_configs:
- job_name: redis-exporter
scrape_interval: 60s
kubernetes_sd_configs:
- role: pod
relabel_configs:
- source_labels: [__meta_kubernetes_pod_label_app]
action: keep
regex: redis-exporter
- source_labels: [__meta_kubernetes_namespace]
target_label: k8s_namespace_name
processors:
cumulative_to_delta:
max_staleness: 25h
exporters:
otlp_http:
endpoint: ${env:DT_ENDPOINT}
headers:
Authorization: "Api-Token ${env:DT_API_TOKEN}"
service:
pipelines:
metrics:
receivers: [prometheus]
processors: [cumulative_to_delta]
exporters: [otlp_http]
Por qué cumulative_to_delta: los contadores de Prometheus son acumulativos y Dynatrace espera OTLP con temporalidad delta. Sin este procesador, los contadores se rechazan. El detalle está en la temporalidad de las métricas OTLP. La documentación de Dynatrace añade también el procesador metric_start_time con su distribución del Collector (v0.41.0 o superior); según tu imagen, los nombres antiguos otlphttp y cumulativetodelta siguen aceptándose como alias.
El receptor prometheus con kubernetes_sd_configs necesita un ServiceAccount autorizado para listar los pods (get, list, watch). Para el despliegue del propio Collector (Helm, RBAC, recursos), sigue nuestro tutorial OpenTelemetry Collector en Kubernetes. En un clúster grande, un único Collector se convierte en un cuello de botella: el Target Allocator del operador de OpenTelemetry reparte los destinos entre varias réplicas.
Cómo comprobar que funciona
Para el método 2, lee primero los logs del Collector:
kubectl -n otel logs deploy/otel-collector | grep -iE "error|scrape|refused"
No debe aparecer ninguna línea 401 o 403; si aparece, revisa el scope del token. El Collector expone además sus propias métricas: otelcol_receiver_accepted_metric_points debe ir creciendo.
En Dynatrace SaaS, abre un notebook y muestra una métrica del exporter:
timeseries clients = avg(redis_connected_clients)
Si la clave no aparece con ese nombre, busca «redis» en el explorador de métricas: según el método de ingesta y el tipo de métrica, Dynatrace puede añadir un sufijo a la clave (está documentado para contadores, histogramas y summaries). En Managed, usa el explorador de datos con la misma búsqueda.
Buenas prácticas
- Filtra en el origen: lista
includeen el método 1,metric_relabel_configso procesadorfilteren el método 2. - Mantén un intervalo de scrape de 60 s salvo necesidad concreta: dividir el intervalo por cuatro multiplica el volumen por cuatro.
- No hagas nunca scraping de un pod con los dos métodos a la vez: duplicarías las series y falsearías los SLO.
- Para SLO de latencia, ingiere los histogramas y lee las métricas de histograma con OpenPipeline.
- Monitoriza el propio Collector: un scrape que falla en silencio se parece a un servicio sin tráfico.
Preguntas frecuentes
¿Hay que mantener un servidor Prometheus?
No, ninguno de los dos métodos lo necesita: el ActiveGate o el Collector hacen scraping directamente de los exporters. Si mantienes Prometheus para otros usos, evita duplicar sin motivo las mismas series en las dos herramientas.
¿Funcionan las anotaciones con Dynatrace Managed?
Sí, el método por anotaciones se apoya en el ActiveGate y en el módulo de Kubernetes, presentes tanto en Managed como en SaaS. Las opciones de autenticación de cliente (certificados, secretos) exigen un ActiveGate desplegado en el clúster monitorizado.
Mis contadores muestran valores raros, ¿por qué?
Dynatrace almacena los contadores de Prometheus en delta: ves el incremento entre dos scrapes, no el valor bruto del contador. Es lo esperado. En el lado del Collector, un contador que se reinicia sin cumulative_to_delta bien configurado produce huecos.
Conclusión
Para unos pocos exporters en un clúster que ya tiene Dynatrace Operator, las anotaciones bastan. Para un clúster nuevo o con grandes volúmenes, un OpenTelemetry Collector con el receptor prometheus ofrece más control. En ambos casos, filtra pronto, comprueba en los logs y después en DQL, y asocia tus SLI a los SLO existentes. La referencia está en docs.dynatrace.com y, para el receptor, en opentelemetry.io.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Los nombres de pantallas y los procedimientos evolucionan: comprueba siempre la documentación oficial antes de hacer un cambio en producción. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.