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.