Amazon Elastic Compute Cloud (Amazon EC2) es un servicio web que proporciona capacidad informática redimensionable en la nube. Está diseñado para facilitar la computación en la nube a escala web para los desarrolladores.
Habilita esta integración para ver en Datadog todas tus métricas EC2 y eventos adicionales, como mantenimientos programados.
Configuración
Instalación
Si aún no lo has hecho, configura la integración Amazon Web Services.
Configuración
En la página de la integración AWS, asegúrate de que EC2 está habilitado en la pestaña Metric Collection.
Añade los siguientes permisos requeridos a tu política IAM de Datadog para poder recopilar métricas de Amazon EC2. Para obtener más información, consulta las políticas de EC2 en el sitio web de AWS.
| Permiso AWS | Descripción |
|---|
ec2:DescribeInstanceStatus | Utilizado por la integración ELB para confirmar el estado de una instancia. Utilizado por la integración EC2 para describir el estado de todas las instancias. |
ec2:DescribeSecurityGroups | Añade nombres de SecurityGroup y etiquetas (tags) personalizados a instancias EC2. |
ec2:DescribeInstances | Añade etiquetas a las instancias EC2 y métricas CloudWatch EC2. |
Instala la integración Amazon EC2 en Datadog.
Nota: Si quieres monitorizar un subconjunto de tus instancias EC2 con Datadog, asigna una etiqueta AWS, como por ejemplo datadog:true, a esas instancias EC2. A continuación, especifica esa etiqueta en el cuadro de texto Limitar la recopilación de métricas a recursos específicos en la pestaña Recopilación de métricas de la página de tu integración AWS en Datadog.
Autosilenciado en EC2
Datadog puede silenciar de forma proactiva los monitores relacionados con el apagado manual de instancias EC2 y con el cierre de instancias activadas por el autoescalado de AWS, en función del estado de los hosts de la API CloudWatch. Las instancias EC2 autosilenciadas se enumeran en la página de tiempo de inactividad del monitor seleccionando la opción Mostrar automáticamente hosts silenciados.
Ten en cuenta que la integración EC2 debe estar instalada para que el autosilenciado surta efecto. Si la recopilación de métricas se limita a hosts con etiquetas, sólo se autosilenciarán las instancias que coincidan con esas etiquetas.
Para silenciar los monitores de apagados esperados de instancias EC2, selecciona la casilla Autosilenciado de EC2 en la página de la integración AWS:
Instalar el Agent
Datadog proporciona dos enfoques para configurar el Datadog Agent en instancias de EC2. Consulta ¿Por qué debería instalar Datadog Agent en mis instancias en la nube? para conocer las ventajas de instalar el Agent en tus instancias de Amazon EC2.
Instalación del Agent a través de la interfaz de usuario de Amazon Systems Manager (recomendado)
Sigue los pasos que se indican a continuación para instalar el Datadog Agent en instancias de EC2 con AWS Systems Manager.
Configura el rol de IAM en tus instancias EC2 para que el permiso AmazonSSMManagedInstanceCore esté habilitado.
Navega hasta la pestaña del documento de AWS SSM.
Busca datadog. Nota: Puede que necesites buscar el documento correspondiente a tu región cambiando de región en la barra de navegación superior de la consola de AWS Management.
Elige el documento Linux o Windows, según tus necesidades.
- Linux: datadog-agent-installation-linux
- Windows: datadog-agent-installation-windows
- Rellena los parámetros del comando.
- Selecciona las instancias de destino en las que quieres instalar el Agent.
- Haz clic en Run (Ejecutar).
- Espera a que finalice la confirmación y luego consulta la lista de infraestructuras en Datadog.
Instalación alternativa personalizada del Agent
Almacén de parámetros
En el Almacén de parámetros, crea un parámetro con:
- Nombre:
dd-api-key-for-ssm - Descripción: (opcional)
- Tipo:
SecureString - Fuente de claves KMS:
My current account - ID de clave KMS: Utiliza el valor predeterminado seleccionado
- Valor: tu clave de API de Datadog
Documentos
En el gestor de sistemas, crea un nuevo Documento:
- Nombre:
dd-agent-install - Tipo de destino: (opcional)
- Tipo de documento:
Command document - Contenido:
JSON
Si te encuentras en un sitio US de Datadog, utiliza el archivo dd-agent-install-us-site.json, actualizado con tu <AWS_REGION> en runCommand, como us-east-1. Si te encuentras en un sitio EU de Datadog, utiliza el archivo dd-agent-install-eu-site.json.
Ejecutar comando
En Run Command (Ejecutar comando), haz clic en el botón Run command (Ejecutar comando) y sigue los pasos que se indican a continuación:
- Documento de comando:
- Haz clic en la casilla de búsqueda y selecciona Propietario -> Propiedad mía.
- Haz clic en el botón de opción situado junto a tu documento.
- Si es necesario, elige la versión del documento.
- Destinos:
- Selecciona la instancia EC2 de destino.
- Opciones de resultados (opcional):
- Selecciona la casilla Resultado de CloudWatch para registrar cualquier problema.
- Otras secciones (opcional):
- Modifica otras secciones, según sea necesario para tu configuración.
Haz clic en el botón Run (Ejecutar) y aparecerá una página de confirmación que muestra el estado. Espera a que finalice y luego consulta la lista de infraestructuras en Datadog.
Instalación del Agent a través de EC2 Image Builder
Datadog publica un componente de EC2 Image Builder para el Datadog Agent a través de AWS Marketplace. Los usuarios pueden suscribirse al producto y utilizar el componente Image Builder para crear una AMI personalizada.
Sigue estos pasos para crear una Amazon Machine Image personalizada con el Datadog Agent y aprovisionar instancias de EC2 con un Datadog Agent preinstalado.
Para la versión inicial, el componente se probó con Amazon Linux 2023. Debería funcionar con cualquier distribución de Linux compatible con el Datadog Agent
Crear una suscripción
- Accede a la consola de EC2 Image Builder y ve a ‘Discover products’ (Descubrir productos).
- Selecciona la pestaña Components (Componentes) y busca _Datadog Agent _.
- Haz clic en View subscription options (Ver opciones de suscripción) y sigue las instrucciones para crear una suscripción.
Consulta Gestión de suscripciones de AWS Marketplace para obtener más información.
Crear una receta de imagen
- Navega hasta Image recipes (Recetas de imágenes) en la consola de EC2 Image Builder.
- Crea una nueva receta con la siguiente configuración:
- Imagen de base:
arn:aws:imagebuilder:us-east-1:aws:image/amazon-linux-2023-x86/x.x.x. - Componente:
arn:aws:imagebuilder:us-east-1:aws-marketplace:component/datadog-agent-for-linux-prod-wwo2b4p7dgrkk/0.1.0/1 - Opcionalmente, configura los parámetros del componente. Este documento asume que se utilizan los valores por defecto.
Consulta Recetas de EC2 Image Builder para obtener más detalles.
Crear un canal de imágenes y construir la imagen
Requisitos previos:
- El rol por defecto
EC2InstanceProfileForImageBuilder requiere los siguientes permisos adicionales:imagebuilder:GetMarketplaceResource para obtener el componente Datadog Agent de Marketplace.secretsmanager:GetSecretValue para recuperar las claves de API y de aplicación almacenadas en el almacén de secretos.
- Crea un secreto llamado
mp-ib-datadog-agent-secret que almacene la API de Datadog y las claves de aplicación asignadas a dd-api-key y dd-app-key respectivamente.
Procede a la creación de pipelines y a la creación de imágenes:
- Ve a Image pipelines (Pipelines de imagen) en la consola de EC2 Image Builder.
- Crea un pipeline para la receta. Este es un asistente de varios pasos; el siguiente aborda el escenario más simple:
- Paso 1: indica el nombre del pipeline y establece el programa de creación en manual.
- Paso 2: elige la receta creada en la sección anterior.
- Paso 3: deja los valores por defecto.
- Paso 4: deja la opción por defecto para usar el rol
EC2InstanceProfileForImageBuilder con políticas adicionales adjuntas. - Paso 5: deja los valores por defecto.
- Paso 6: revisar y crear.
- Navega hasta el pipeline recién creado y ejecútelo.
- Una vez finalizado el pipeline, un resumen muestra el nuevo ARN de la imagen.
- Si has configurado tu secreto
mp-ib-datadog-agent-secret correctamente, el Datadog Agent comienza a informar métricas poco después de que la instancia de EC2 se inicie con la imagen.
Consulta Pipelines de EC2 Image Builder para obtener más detalles.
Parámetros de los componentes
El Agent puede personalizarse utilizando los siguientes parámetros en la receta:
DD_SITE: sitio al que enviar los datos de telemetría. Por defecto: datadoghq.com.HOST_TAGS: etiquetas (tags) de host. Por defecto: installer:ec2_image_builder.SM_SECRET_NAME: nombre del secreto para almacenar las claves de la API y de la aplicación. Por defecto: mp-ib-datadog-agent-secret.SM_API_KEY: para buscar la clave de la API en el secreto. Por defecto: dd-api-keySM_API_KEY: clave para buscar la clave de aplicación en el secreto. Por defecto: dd-app-key
Recopilación de logs
Utiliza el Datadog Agent u otro remitente de log para enviar tus logs a Datadog.
Datos recopilados
Métricas
aws.ec2.cpucredit_balance
(gauge) | Number of CPU credits that an instance has accumulated.
Shown as unit |
aws.ec2.cpucredit_usage
(gauge) | Number of CPU credits consumed.
Shown as unit |
aws.ec2.cpusurplus_credit_balance
(gauge) | The number of surplus credits that have been spent by an unlimited instance when its CPUCreditBalance value is zero.
Shown as unit |
aws.ec2.cpusurplus_credits_charged
(gauge) | The number of spent surplus credits that are not paid down by earned CPU credits, and which thus incur an additional charge.
Shown as unit |
aws.ec2.cpuutilization
(gauge) | Average percentage of allocated EC2 compute units that are currently in use on the instance.
Shown as percent |
aws.ec2.cpuutilization.maximum
(gauge) | Maximum percentage of allocated EC2 compute units that are currently in use on the instance.
Shown as percent |
aws.ec2.disk_read_bytes
(gauge) | Bytes read from all ephemeral disks available to the instance.
Shown as byte |
aws.ec2.disk_read_ops
(gauge) | Completed read operations from all ephemeral disks available to the instance.
Shown as operation |
aws.ec2.disk_write_bytes
(gauge) | Bytes written to all ephemeral disks available to the instance.
Shown as byte |
aws.ec2.disk_write_ops
(gauge) | Completed write operations to all ephemeral disks available to the instance.
Shown as operation |
aws.ec2.ebsbyte_balance
(gauge) | Percentage of throughput credits remaining in the burst bucket for Nitro-based instances.
Shown as percent |
aws.ec2.ebsiobalance
(gauge) | Percentage of I/O credits remaining in the burst bucket for Nitro-based instances."
Shown as percent |
aws.ec2.ebsread_bytes
(gauge) | Average bytes read from all EBS volumes attached to the instance for Nitro-based instances.
Shown as byte |
aws.ec2.ebsread_bytes.sum
(gauge) | Total bytes read from all EBS volumes attached to the instance for Nitro-based instances.
Shown as byte |
aws.ec2.ebsread_ops
(count) | Average completed read operations from all Amazon EBS volumes attached to the instance for Nitro-based instances.
Shown as operation |
aws.ec2.ebsread_ops.sum
(count) | Total completed read operations from all Amazon EBS volumes attached to the instance for Nitro-based instances.
Shown as operation |
aws.ec2.ebswrite_bytes
(gauge) | Average bytes written to all EBS volumes attached to the instance for Nitro-based instances.
Shown as byte |
aws.ec2.ebswrite_bytes.sum
(gauge) | Total bytes written to all EBS volumes attached to the instance for Nitro-based instances.
Shown as byte |
aws.ec2.ebswrite_ops
(gauge) | Average completed write operations to all EBS volumes attached to the instance for Nitro-based instances.
Shown as operation |
aws.ec2.ebswrite_ops.sum
(gauge) | Total completed write operations to all EBS volumes attached to the instance for Nitro-based instances.
Shown as operation |
aws.ec2.host_ok
(gauge) | 1 if the instance's system status is ok. |
aws.ec2.instance_age
(gauge) | Time since instance launch
Shown as second |
aws.ec2.network_address_usage
(gauge) | The maximum number of NAU units for a VPC.
Shown as unit |
aws.ec2.network_address_usage_peered
(gauge) | The maximum number of NAU units for a VPC and all of its peered VPCs.
Shown as unit |
aws.ec2.network_in
(gauge) | Average number of bytes received on all network interfaces by the instance.
Shown as byte |
aws.ec2.network_in.maximum
(gauge) | Maximum number of bytes received on all network interfaces by the instance.
Shown as byte |
aws.ec2.network_out
(gauge) | Average number of bytes sent out on all network interfaces by the instance.
Shown as byte |
aws.ec2.network_out.maximum
(gauge) | Maximum number of bytes sent out on all network interfaces by the instance.
Shown as byte |
aws.ec2.network_packets_in
(gauge) | Number of packets received on all network interfaces by the instance
Shown as packet |
aws.ec2.network_packets_out
(gauge) | Number of packets sent out on all network interfaces by the instance
Shown as packet |
aws.ec2.status_check_failed
(gauge) | 1 if one of the status checks failed. |
aws.ec2.status_check_failed_instance
(gauge) | 0 if the instance has passed the EC2 instance status check. |
aws.ec2.status_check_failed_system
(gauge) | 0 if the instance has passed the EC2 system status check. |
A cada una de las métricas recuperadas de AWS se le asignan las mismas etiquetas (tags) que aparecen en la consola de AWS, incluidos, entre otros, el nombre del host y los grupos de seguridad.
Notas:
aws.ec2.instance_age no se recopila de forma predeterminada con la integración de Datadog y EC2. Ponte en contacto con el soporte de Datadog para activar esta recopilación de métricas.aws.ec2.host_ok se recopila de forma predeterminada, incluso si deshabilitas la recopilación de métricas para la integración Amazon EC2, y puede provocar la aparición inesperada de hosts en la lista de infraestructuras. Para garantizar que sólo se monitoricen los hosts elegidos, asigna una etiqueta AWS, como datadog:true, a esas instancias EC2. A continuación, especifica esa etiqueta en el cuadro de texto Limitar la recopilación de métricas a recursos específicos en la pestaña Recopilación de métricas de la página de tu integración AWS en Datadog.
Checks de servicio
aws.ec2.host_status
Returns your EC2 instance statuses as reported by the AWS console. Returns CRITICAL when there is a problem with your instance. Returns UNKNOWN when AWS does not have sufficient data to run a status check. Returns OK when your instance is running or is shut down properly.
Statuses: ok, critical, unknown
Monitorización predefinida
La integración Amazon EC2 proporciona funciones de monitorización predefinidas para monitorizar y optimizar el rendimiento.
Resolución de problemas
¿Necesitas ayuda? Ponte en contacto con el equipo de asistencia de Datadog.
Para leer más
