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

Dynatrace AWS paso a paso: rol IAM con external ID, métricas de CloudWatch, logs mediante Data Firehose y consultas DQL para verificar, en SaaS y Managed.
Intégration Dynatrace AWS : CloudWatch, métriques et logs pas à pas

Tus workloads se ejecutan en EC2, RDS y Lambda, pero la guardia (on-call) sigue saltando entre la consola de CloudWatch y Dynatrace. Conectar Dynatrace AWS a tus cuentas reúne las métricas de CloudWatch y los logs en un mismo lugar, junto a las trazas y a las entidades que OneAgent ya ha descubierto.

El coste de esta dispersión es real: cada cambio de herramienta alarga el MTTR, y una base RDS saturada sigue siendo invisible para los SLO mientras sus métricas no se correlacionen con el servicio que depende de ella. Una integración limpia elimina ese hueco de cobertura.

Objetivo de este tutorial: conectar una cuenta de AWS con un rol IAM de solo lectura, enviar después grupos de logs de CloudWatch a Dynatrace mediante Amazon Data Firehose y verificarlo todo con DQL. El contenido vale para Dynatrace SaaS; las diferencias para Dynatrace Managed se señalan en cada paso.

Qué cubre la integración de Dynatrace AWS

La integración se apoya en dos flujos distintos. Confundirlos es la primera fuente de tickets.

Flujo Mecanismo Qué llega a Dynatrace
Métricas y metadatos Dynatrace consulta la API de CloudWatch asumiendo un rol IAM de tu cuenta Métricas de los servicios de AWS, entidades (instancias, bases de datos, funciones), etiquetas
Logs Una suscripción de CloudWatch Logs envía a un flujo de Amazon Data Firehose, que envía a la API de ingesta de logs Registros de logs en Grail, con el grupo de logs de origen

El primer flujo funciona en modo pull: Dynatrace lee. El segundo funciona en modo push: AWS envía. Por tanto, los permisos no son los mismos, y un problema en uno nunca explica un hueco en el otro.

Requisitos previos

  • Una cuenta de AWS con permiso para crear roles IAM y pilas de CloudFormation (AWS CLI configurada o CloudShell).
  • Un entorno de Dynatrace SaaS y permiso para modificar los ajustes del entorno.
  • Un token de API de Dynatrace con el scope de ingesta de logs (logs.ingest, «Ingest logs» en la interfaz), guardado en una variable, nunca en un repositorio.
  • En Managed: un ActiveGate capaz de llegar a AWS, porque es él quien consulta CloudWatch, y una URL de ingesta de logs que pase por ese ActiveGate.

Paso 1: crear el rol IAM de monitorización

Dynatrace no pide una clave de acceso de larga duración: asume un rol mediante sts:AssumeRole, protegido por un external ID. Al crear la conexión de AWS en los ajustes de Dynatrace, la interfaz te proporciona ese identificador. Cópialo antes de pasar al lado de AWS.

Crea después la política de confianza del rol. La cuenta de AWS de Dynatrace que figura a continuación es la de la documentación para SaaS; compruébala en tu pantalla de conexión, que es la que manda.

cat > trust.json <<'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": { "AWS": "arn:aws:iam::314146291599:root" },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": { "sts:ExternalId": "<external-id-fourni-par-dynatrace>" }
      }
    }
  ]
}
EOF

aws iam create-role \
  --role-name DynatraceMonitoringRole \
  --assume-role-policy-document file://trust.json

La línea crítica es la condición sts:ExternalId: sin ella, cualquier cliente del mismo proveedor podría intentar asumir tu rol (el llamado problema del «confused deputy»). No la quites nunca para «desbloquear» una conexión.

En Managed, el principal no es la cuenta de Dynatrace: es el rol que lleva el ActiveGate que se ejecuta en AWS. Sigue el procedimiento de Managed de la documentación para saber qué cuenta y qué nombre de rol autorizar.

Paso 2: dar los permisos de lectura de CloudWatch

Adjunta al rol una política de solo lectura. La base mínima cabe en unas pocas acciones; la documentación ofrece una política completa por servicio monitorizado.

cat > policy.json <<'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:GetMetricData",
        "cloudwatch:GetMetricStatistics",
        "cloudwatch:ListMetrics",
        "sts:GetCallerIdentity",
        "tag:GetResources",
        "tag:GetTagKeys",
        "ec2:DescribeAvailabilityZones",
        "ec2:DescribeInstances",
        "rds:DescribeDBInstances",
        "lambda:ListFunctions",
        "lambda:ListTags"
      ],
      "Resource": "*"
    }
  ]
}
EOF

aws iam put-role-policy \
  --role-name DynatraceMonitoringRole \
  --policy-name DynatraceMonitoringPolicy \
  --policy-document file://policy.json

Las acciones tag:* importan más de lo que parece: sin ellas, las etiquetas de AWS no llegan, y pierdes el filtrado por equipo o por entorno que luego sirve para enrutar las alertas.

Paso 3: finalizar la conexión y elegir los servicios

Vuelve a Dynatrace, pega el ARN del rol y el identificador de la cuenta de AWS, y guarda. Selecciona después los servicios que quieres monitorizar y, si hace falta, limita la recogida por región o por etiqueta. Empieza por poco: EC2, RDS, Lambda y los balanceadores de carga cubren la mayoría de los incidentes.

Cada servicio adicional multiplica las llamadas a CloudWatch, que factura AWS, y el volumen de métricas en Dynatrace. El filtrado por etiqueta (por ejemplo monitoring=dynatrace) evita pagar por recursos de entornos de pruebas.

Paso 4: enviar los logs de CloudWatch mediante Data Firehose

Dynatrace publica una plantilla de CloudFormation que crea el flujo de Firehose, el bucket S3 de respaldo para los envíos fallidos y el rol que usa la suscripción. Despliégala desde una shell con AWS CLI o CloudShell:

DYNATRACE_API_URL=https://<environment-id>.live.dynatrace.com
DYNATRACE_API_KEY=<token-logs-ingest>
STACK_NAME=dynatrace-log-delivery-stream

wget -O dynatrace-firehose-log-stream.yaml \
  https://assets.cloud.dynatrace.com/awslogstreaming/dynatrace-firehose-log-stream.yaml

aws cloudformation deploy \
  --capabilities CAPABILITY_NAMED_IAM \
  --template-file ./dynatrace-firehose-log-stream.yaml \
  --stack-name $STACK_NAME \
  --parameter-overrides DtApiUrl=$DYNATRACE_API_URL DtApiToken=$DYNATRACE_API_KEY

En Managed o detrás de un ActiveGate, la URL tiene la forma https://<activegate>/e/<environment-id>. Firehose exige un certificado válido: un ActiveGate con certificado autofirmado no será aceptado.

Suscribe después los grupos de logs que te interesen con el script que proporciona Dynatrace:

wget -O dynatrace-firehose-logs.sh \
  https://assets.cloud.dynatrace.com/awslogstreaming/dynatrace-firehose-logs.sh
chmod +x dynatrace-firehose-logs.sh

./dynatrace-firehose-logs.sh subscribe \
  --log-groups /aws/lambda/checkout /aws/rds/instance/orders/postgresql \
  --stack-name $STACK_NAME \
  --filter-pattern "?ERROR ?WARN"

--filter-pattern es tu primera palanca de costes: filtra en origen, antes de Firehose. Sin él, sale todo el grupo de logs, incluido el ruido de debug. Atención: CloudWatch limita el número de filtros de suscripción por grupo; si otra herramienta ya usa uno, el script devuelve una LimitExceededException.

Cómo comprobar que funciona

En AWS, abre la pila de CloudFormation: la pestaña Events no debe mostrar ningún fallo, y la pestaña Outputs da el ARN del flujo de Firehose. En las métricas del flujo, DeliveryToHttpEndpoint.Success debe estar cerca de 1.

En Dynatrace, abre un notebook y verifica primero los logs, grupo por grupo:

fetch logs, from: now() - 1h
| filter isNotNull(aws.log_group)
| summarize count(), by: {aws.log_group}

Después las métricas, por ejemplo la CPU de las instancias RDS:

timeseries avg(dt.cloud.aws.rds.cpu.usage)

Las métricas de CloudWatch llegan con unos minutos de retraso, porque el propio CloudWatch las publica en diferido. Un gráfico vacío tras cinco minutos no es un fallo; tras treinta, revisa la política IAM. Para más consultas de control, consulta nuestros ejemplos de consultas DQL de explotación.

Buenas prácticas

  • Un rol IAM por cuenta de AWS, con el mismo nombre en todas partes: la resolución de problemas se vuelve mecánica.
  • Filtra por etiqueta y por región desde el principio en lugar de activarlo todo y recortar después.
  • Conserva el bucket S3 de respaldo de Firehose y vigila su tamaño: crece cuando falla la ingesta.
  • Rota el token de ingesta y actualiza el parámetro de la pila; ante un 401, sigue nuestra guía para resolver problemas con un token de API de Dynatrace.
  • Alerta por la ausencia de logs de un grupo crítico, no solo por los errores: consulta detectar el silencio en la ingesta de logs.

Preguntas frecuentes

¿Hay que instalar OneAgent si la integración con AWS está activa?

Sí, para los hosts y las aplicaciones. La integración de CloudWatch ve los recursos desde fuera, con la granularidad de CloudWatch. OneAgent aporta los procesos, las trazas distribuidas y las métricas al segundo. Las dos se complementan: Dynatrace relaciona la instancia EC2 que ve CloudWatch con el host que ve OneAgent.

¿Qué diferencia hay entre SaaS y Managed en esta integración?

En SaaS, Dynatrace consulta AWS desde su infraestructura y el rol confía en su cuenta. En Managed, es tu ActiveGate quien consulta AWS: debe ejecutarse en AWS para la autenticación por rol, y los logs de Firehose pasan por una URL de ActiveGate con un certificado válido. Para elegir el ActiveGate, consulta Environment ActiveGate o Cluster ActiveGate.

¿Por qué algunos grupos de logs no llegan nunca?

Se repiten tres causas: el grupo no está suscrito (revisa los filtros de suscripción en CloudWatch), el patrón de filtro lo excluye todo, o Firehose falla hacia Dynatrace y deja los lotes en el bucket S3 de respaldo. Empieza por ese bucket: si contiene archivos recientes, el problema está en el token o en la URL.

Conclusión

Un rol IAM de solo lectura, una pila de Firehose y unas pocas suscripciones bastan para traer CloudWatch a Dynatrace. La ganancia no está en el número de gráficos, sino en la correlación: la base RDS saturada aparece por fin junto al servicio que se ralentiza, y la guardia busca en una sola herramienta. Empieza por dos o tres servicios críticos, verifica con DQL y amplía después. El procedimiento de referencia está en docs.dynatrace.com.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. 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
Provider Terraform Dynatrace : alerting, management zones et tableaux de bord

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

Next Post
Intégration Dynatrace Azure : Azure Monitor et logs pas à pas

Integración de Dynatrace Azure: Azure Monitor y logs paso a paso

Related Posts