Solución de problemas del agente de CloudWatch

Utilice la siguiente información para ayudarle a solucionar problemas con el agente de CloudWatch.

Parámetros de la línea de comandos del agente de CloudWatch

Para ver la lista completa de los parámetros que el agente de CloudWatch admite, ingrese lo siguiente en la línea de comandos en un ordenador en el que lo tenga instalado:

amazon-cloudwatch-agent-ctl -help

Error al instalar el agente de CloudWatch mediante Run Command

Para instalar el agente de CloudWatch mediante Run Command de Systems Manager, el SSM Agent en el servidor de destino debe contar con la versión 2.2.93.0 o con una posterior. Si SSM Agent no cuenta con la versión correcta, es posible que vea errores que incluyen los siguientes mensajes:

no latest version found for package AmazonCloudWatchAgent on platform linux

failed to download installation package reliably

Para obtener información sobre la actualización de la versión de SSM Agent, consulte Installing and Configuring SSM Agent (Instalación y configuración de SSM Agent) en la Guía del usuario de AWS Systems Manager.

El agente de CloudWatch no se iniciará

Si el agente de CloudWatch no se inicia, podría haber un problema en la configuración. La información de configuración se registra en el archivo configuration-validation.log. Este archivo se encuentra en /opt/aws/amazon-cloudwatch-agent/logs/configuration-validation.log en los servidores Linux y en $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\configuration-validation.log en los servidores con Windows Server.

Verifique que el agente de CloudWatch esté en ejecución

Puede consultar el agente de CloudWatch para determinar si está en ejecución o detenido. Puede usar AWS Systems Manager, para hacerlo de forma remota. También puede utilizar la línea de comandos, pero solo para comprobar el servidor local.

Si el agente está en ejecución, el resultado será similar al siguiente.

{
       "status": "running",
       "starttime": "2017-12-12T18:41:18",
       "version": "1.73.4"
}

Si el agente está detenido, el campo "status" muestra "stopped".

El agente de CloudWatch no se iniciará y el error menciona la región de Amazon EC2

Si el agente no se inicia y el mensaje de error menciona un punto de enlace de una región de Amazon EC2, es posible que haya configurado el agente para que necesite acceso al punto de enlace de Amazon EC2, pero que no haya concedido ese tipo de acceso.

Por ejemplo, si especifica un valor para el parámetro append_dimensions en el archivo de configuración del agente que depende de los metadatos de Amazon EC2 y utiliza proxies, debe asegurarse de que el servidor pueda obtener acceso al punto de enlace de Amazon EC2. Para obtener más información sobre estos puntos de conexión, consulte Amazon Elastic Compute Cloud (Amazon EC2) en Referencia general de Amazon Web Services.

El agente de CloudWatch no se iniciará en Windows Server

Puede aparecer el siguiente error en Windows Server:

Start-Service : Service 'Amazon CloudWatch Agent (AmazonCloudWatchAgent)' cannot be started due to the following
error: Cannot start service AmazonCloudWatchAgent on computer '.'.
At C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1:113 char:12
+     $svc | Start-Service
+            ~~~~~~~~~~~~~
    + CategoryInfo          : OpenError: (System.ServiceProcess.ServiceController:ServiceController) [Start-Service],
   ServiceCommandException
    + FullyQualifiedErrorId : CouldNotStartService,Microsoft.PowerShell.Commands.StartServiceCommand

Para solucionar esto, asegúrese antes de que el servicio del servidor se esté ejecutando. Este error se puede ver si el agente intenta iniciarse cuando el servicio del servidor no se está ejecutando.

Si el servicio del servidor ya está en ejecución, puede que el siguiente sea el problema. En algunas instalaciones de Windows Server, el agente de CloudWatch tarda más de 30 segundos en iniciarse. De forma predeterminada, Windows Server solo permite 30 segundos para que los servicios se inicien, lo que hace que el agente genere un error similar al siguiente:

Para solucionarlo, aumente el valor de tiempo de espera del servicio. Para obtener más información, vea Un servicio no se inicia y los eventos 7000 y 7011 se registran en el registro de eventos de Windows.

¿Dónde están las métricas?

Si el agente de CloudWatch se ha estado ejecutando, pero no encuentra las métricas que ha recopilado en AWS Management Console o AWS CLI, confirme que está usando el espacio de nombres correcto. De forma predeterminada, el espacio de nombres de las métricas recopiladas por el agente es CWAgent. Puede personalizar este espacio de nombres mediante el campo namespace de la sección metrics del archivo de configuración del agente. Si no se muestran las métricas que espera, compruebe el archivo de configuración para confirmar el espacio de nombres que está usando.

Al descargar por primera vez el paquete del agente de CloudWatch, el archivo de configuración del agente es amazon-cloudwatch-agent.json. Este archivo se encuentra en el directorio donde ha ejecutado el asistente de configuración o puede que lo haya movido a otro directorio. Si utiliza el asistente de configuración, el resultado del archivo de configuración del agente del asistente se denomina config.json. Para obtener más información sobre el archivo de configuración, incluido el campo namespace, consulte Archivo de configuración del agente de CloudWatch: sección de métricas.

El agente de CloudWatch tarda mucho en ejecutarse en un contenedor o registra un error de límite de saltos

Cuando ejecuta el agente de CloudWatch como un servicio de contenedores y desea agregar las dimensiones de métricas de Amazon EC2 a todas las métricas recopiladas por el agente, es posible que vea los siguientes errores en la versión v1.247354.0 del agente:

2022-06-07T03:36:11Z E! [processors.ec2tagger] ec2tagger: Unable to retrieve Instance Metadata Tags. This plugin must only be used on an EC2 instance.
2022-06-07T03:36:11Z E! [processors.ec2tagger] ec2tagger: Please increase hop limit to 2 by following this document https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html#configuring-IMDS-existing-instances.
2022-06-07T03:36:11Z E! [telegraf] Error running agent: could not initialize processor ec2tagger: EC2MetadataRequestError: failed to get EC2 instance identity document
caused by: EC2MetadataError: failed to make EC2Metadata request
        status code: 401, request id: 
caused by:

Es posible que aparezca este error si el agente intenta obtener metadatos de IMDSv2 dentro de un contenedor sin un límite de saltos adecuado. En las versiones del agente anteriores a la v1.247354.0, puede experimentar este problema sin ver el mensaje de registro.

Para solucionarlo, aumente el límite de saltos a 2 siguiendo las instrucciones que figuran en Configure the instance metadata options (Configurar las opciones de metadatos de instancia).

He actualizado la configuración del agente pero no puedo ver las métricas o los registros nuevos en la consola de CloudWatch

Si actualiza el archivo de configuración del agente de CloudWatch, la próxima vez que inicie el agente, deberá utilizar la opción fetch-config. Por ejemplo, si ha almacenado el archivo actualizado en el equipo local, escriba el siguiente comando:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -s -m ec2 -c file:configuration-file-path

Archivos y ubicaciones del agente de CloudWatch

En la siguiente tabla se muestran los archivos que ha instalado y que utiliza el agente de CloudWatch, junto con las ubicaciones en servidores que ejecutan Linux o Windows Server.

Búsqueda de información sobre las versiones del agente de CloudWatch

Para encontrar el número de versión del agente de CloudWatch en un servidor Linux, ingrese el siguiente comando:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a status

Para encontrar el número de versión del agente de CloudWatch en Windows Server, ingrese el siguiente comando:

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status

También puede descargar un archivo LÉAME sobre los últimos cambios que el agente ha realizado y un archivo que indique el número de versión que está disponible para la descarga. Estos archivos se encuentran en las siguientes ubicaciones:

Registros que el agente de CloudWatch ha generado

El agente genera un registro durante su ejecución. Este registro incluye la información de solución de errores. Este registro es el archivo amazon-cloudwatch-agent.log. Este archivo se encuentra en /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log en los servidores Linux y en $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\amazon-cloudwatch-agent.log en los servidores con Windows Server.

Puede configurar el agente para que registre detalles adicionales en el archivo amazon-cloudwatch-agent.log. En el archivo de configuración del agente, en la sección agent, establezca el campo debug a true; a continuación, vuelva a configurar y reinicie el agente de CloudWatch. Para deshabilitar el registro de esta información adicional, establezca el campo debug en false. A continuación, vuelva a configurar y reinicie el agente. Para obtener más información, consulte Cree o edite de forma manual el archivo de configuración del agente de CloudWatch.

En las versiones 1.247350.0 y las posteriores del agente de CloudWatch, puede configurar opcionalmente el campo aws_sdk_log_level en la sección agent del archivo de configuración del agente a una o más de las siguientes opciones. Separe varias opciones con el character |.

Para obtener más información sobre estas opciones, consulte LogLevelType.

Cierre y reinicio del agente de CloudWatch

Puede detener el agente de CloudWatch mediante AWS Systems Manager o la línea de comandos de forma manual.

Para reiniciar el agente, siga las instrucciones que se describen en Inicie el agente de CloudWatch.