Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi relativi all'agente CloudWatch

Puoi utilizzare le informazioni in questa sezione per risolvere i problemi che potresti riscontrare con l' CloudWatch agente.

CloudWatch parametri della riga di comando dell'agente

Per visualizzare l'elenco completo dei parametri supportati dall' CloudWatch agente, inserisci quanto segue nella riga di comando del computer in cui è installato:

amazon-cloudwatch-agent-ctl -help

L'installazione dell' CloudWatch agente tramite Run Command non riesce

Per installare l' CloudWatch agente utilizzando Systems Manager Run Command, l'SSMagente sul server di destinazione deve essere la versione 2.2.93.0 o successiva dell'SSMagente Agent. Se la versione SSM dell'agente non è corretta, è possibile che vengano visualizzati errori che includono i seguenti messaggi:

no latest version found for package AmazonCloudWatchAgent on platform linux

failed to download installation package reliably

Per informazioni sull'aggiornamento della versione SSM dell'agente, vedere Installazione e configurazione SSM dell'agente nella AWS Systems Manager Guida per l'utente.

L' CloudWatch agente non si avvia

Se l' CloudWatch agente non si avvia, potrebbe esserci un problema nella configurazione. Le informazioni sulla configurazione sono registrate nel file configuration-validation.log. Il percorso del file è /opt/aws/amazon-cloudwatch-agent/logs/configuration-validation.log nei server Linux e $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\configuration-validation.log nei server che eseguono Windows Server.

Verifica che l' CloudWatch agente sia in esecuzione

Puoi interrogare l' CloudWatch agente per scoprire se è in esecuzione o è fermo. È possibile utilizzare… AWS Systems Manager per eseguire questa operazione da remoto. Puoi inoltre utilizzare la riga di comando, ma solo per controllare il server locale.

Se l'agente è in esecuzione, l'output sarà analogo al seguente.

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

Se l'agente viene arrestato, nel campo "status" viene visualizzato "stopped".

L' CloudWatch agente non si avvia e l'errore indica una regione Amazon EC2

Se l'agente non si avvia e il messaggio di errore menziona un endpoint EC2 della regione Amazon, potresti aver configurato l'agente in modo che richieda l'accesso all'EC2endpoint Amazon senza concedere tale accesso.

Ad esempio, se specifichi un valore per il append_dimensions parametro nel file di configurazione dell'agente che dipende dai EC2 metadati di Amazon e utilizzi proxy, devi assicurarti che il server possa accedere all'endpoint per Amazon. EC2 Per ulteriori informazioni su questi endpoint, consulta Amazon Elastic Compute Cloud EC2 (Amazon) nel Riferimenti generali di Amazon Web Services.

L' CloudWatch agente non si avvia su Windows Server

In Windows Server, potresti visualizzare il seguente errore:

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

Per risolvere questo problema, assicurati innanzitutto che il servizio server sia in esecuzione. Questo errore può essere visualizzato se l'agente tenta di avviarsi quando il servizio server non è in esecuzione.

Se il servizio server è già in esecuzione, potrebbe essere il problema seguente. In alcune installazioni di Windows Server, l'avvio dell' CloudWatch agente impiega più di 30 secondi. Poiché Windows Server, per impostazione predefinita, consente solo 30 secondi per l'avvio dei servizi, questo causa l'errore dell'agente simile al seguente:

Per risolvere questo problema, aumenta il valore del timeout per il servizio. Per ulteriori informazioni, consulta Un servizio non viene avviato e gli eventi 7000 e 7011 vengono registrati nel log eventi di Windows.

Dove sono i parametri?

Se l' CloudWatch agente è in esecuzione ma non riesci a trovare le metriche raccolte da esso nella AWS Management Console o il AWS CLI, conferma di utilizzare lo spazio dei nomi corretto. Per impostazione predefinita, lo spazio dei nomi dei parametri raccolti dall'agente è CWAgent. Puoi personalizzare questo spazio dei nomi utilizzando il campo namespace nella sezione metrics del file di configurazione dell'agente. Se non vengono visualizzati i parametri previsti, controlla il file di configurazione per verificare lo spazio dei nomi in uso.

Quando scarichi per la prima volta il pacchetto CloudWatch dell'agente, il file di configurazione dell'agente è. amazon-cloudwatch-agent.json Il file è ubicato nella directory in cui hai eseguito la procedura guidata di configurazione oppure potrebbe trovarsi in un'altra directory. Se utilizzi la procedura guidata di configurazione, l'output del file di configurazione dell'agente è denominato config.json. Per ulteriori informazioni sul file di configurazione, incluso il campo namespace, consulta CloudWatch file di configurazione dell'agente: sezione Metrics.

L' CloudWatch agente impiega molto tempo per essere eseguito in un contenitore o registra un errore di limite di hop

Quando esegui l' CloudWatch agente come servizio container e desideri aggiungere le dimensioni dei parametri Amazon EC2 a tutte le metriche raccolte dall'agente, potresti visualizzare i seguenti errori nella versione v1.247354.0 dell'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:

Potresti visualizzare questo errore se l'agente tenta di ottenere metadati dall'IMDSv2interno di un contenitore senza un limite di hop appropriato. Nelle versioni dell'agente precedenti alla v1.247354.0, è possibile riscontrare questo problema senza visualizzare il messaggio di log.

Per risolvere questo problema, aumentare il limite di hop a 2 seguendo le istruzioni riportate in Configurazione delle opzioni dei metadati dell'istanza.

Ho aggiornato la configurazione del mio agente ma non vedo le nuove metriche o i nuovi log nella console CloudWatch

Se aggiorni il file di configurazione dell' CloudWatch agente, al successivo avvio dell'agente, devi utilizzare l'fetch-configopzione. Ad esempio, se il file aggiornato è stato memorizzato nel computer locale, immetti il comando seguente:

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

CloudWatch file e posizioni degli agenti

La tabella seguente elenca i file installati e utilizzati con l' CloudWatch agente, insieme alle relative posizioni sui server che eseguono Linux o Windows Server.

Ricerca di informazioni sulle versioni degli CloudWatch agenti

Per trovare il numero di versione dell' CloudWatch agente su un server Linux, immettete il seguente comando:

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

Per trovare il numero di versione dell' CloudWatch agente su Windows Server, inserisci il seguente comando:

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

È inoltre possibile scaricare un README file sulle ultime modifiche apportate all'agente e un file che indichi il numero di versione attualmente disponibile per il download. Questi file si trovano nelle seguenti posizioni:

Registri generati dall'agente CloudWatch

L'agente genera un log durante la sua esecuzione. Questo log include le informazioni relative alla risoluzione dei problemi. Questo log è il file amazon-cloudwatch-agent.log. Il percorso del file è /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log nei server Linux e $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\amazon-cloudwatch-agent.log nei server che eseguono Windows Server.

Puoi configurare l'agente per registrare dettagli aggiuntivi nel file amazon-cloudwatch-agent.log. Nel file di configurazione dell'agente, nella agent sezione, imposta il debug campo sutrue, quindi riconfigura e riavvia l' CloudWatch agente. Per disattivare la registrazione di queste informazioni supplementari, imposta il campo debug su false. Quindi, riconfigura e riavvia l'agente. Per ulteriori informazioni, consulta Crea o modifica manualmente il file di configurazione CloudWatch dell'agente.

Nelle versioni 1.247350.0 e successive dell' CloudWatch agente, puoi facoltativamente impostare il aws_sdk_log_level campo nella agent sezione del file di configurazione dell'agente su una o più delle seguenti opzioni. Separare più opzioni con il carattere |.

Per ulteriori informazioni su queste opzioni, vedere. LogLevelType

Arresto e riavvio dell'agente CloudWatch

È possibile interrompere manualmente l' CloudWatch agente utilizzando entrambi AWS Systems Manager o la riga di comando.

Per riavviare l'agente, segui le istruzioni descritte in (Facoltativo) Modifica la configurazione comune e il profilo denominato per CloudWatch l'agente.