Installa l' CloudWatch agente sui server locali

Se l' CloudWatch agente è stato scaricato su un computer e creato il file di configurazione dell'agente desiderato, è possibile utilizzare tale file di configurazione per installare l'agente su altri server locali.

Scarica l' CloudWatch agente su un server locale

Puoi scaricare il pacchetto dell' CloudWatch agente utilizzando Systems Manager Run Command o un link per il download di Amazon S3. Per informazioni sull'uso di un collegamento per il download di Amazon S3, consulta Scarica il pacchetto dell' CloudWatch agente.

Download tramite Systems Manager

Per utilizzare Systems Manager Run Command, devi registrare il tuo server locale con Amazon EC2 Systems Manager. Per ulteriori informazioni, consulta la pagina relativa alla configurazione di Systems Manager in ambienti ibridi nella Guida per l'utente di AWS Systems Manager .

Se hai già registrato il server, aggiorna SSM Agent alla versione più recente.

Per informazioni sull'aggiornamento di SSM Agent su un server che esegue Linux, consulta Install SSM Agent for a Hybrid Environment (Linux) nella Guida per l'AWS Systems Manager utente.

Per informazioni sull'aggiornamento dell'SSMagente su un server che esegue Windows Server, vedere Install SSM Agent for a Hybrid Environment (Windows) nella Guida per l'AWS Systems Manager utente.

Per utilizzare l'SSMagente per scaricare il pacchetto CloudWatch dell'agente su un server locale

1. Aprire la console Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

2. Nel riquadro di navigazione seleziona Run Command.

   oppure

   Se la AWS Systems Manager home page si apre, scorri verso il basso e scegli Esplora Esegui comando.

3. Seleziona Run command (Esegui comando).

4. Nell'elenco dei documenti Command, seleziona il pulsante accanto a AWS-C onfigureAWSPackage.

5. Nell'area Target, seleziona il server su cui installare l' CloudWatch agente. Se un server specifico non viene visualizzato, potrebbe non essere configurato per Run Command. Per ulteriori informazioni, consulta Configurazione di AWS Systems Manager per ambienti ibridi nella Guida per l'utente AWS Systems Manager .

6. Nell'elenco Action (Operazione), seleziona Install (Installa).

7. Nella casella Nome, immettere AmazonCloudWatchAgent.

8. Non compilare il campo Version (Versione) per installare la versione più recente dell'agente.

9. Seleziona Esegui.

   Il pacchetto dell'agente viene scaricato. Le fasi successive consistono in configurare e avviare l'agente.

(Installazione su un server locale) Specificare IAM le credenziali e la regione AWS

Per consentire all' CloudWatch agente di inviare dati da un server locale, è necessario specificare la chiave di accesso e la chiave segreta dell'IAMutente creato in precedenza. Per ulteriori informazioni sulla creazione di questo utente, consulta Crea IAM ruoli e utenti da utilizzare con l' CloudWatch agente.

È inoltre necessario specificare la AWS regione a cui inviare le metriche, utilizzando il region campo.

Di seguito è riportato un esempio del file.

[AmazonCloudWatchAgent]
aws_access_key_id=my_access_key
aws_secret_access_key=my_secret_key
region = us-west-1

In my_access_key e my_secret_key, usa le chiavi dell'IAMutente che non dispone delle autorizzazioni per scrivere su Systems Manager Parameter Store. Per ulteriori informazioni sugli IAM utenti necessari per l' CloudWatch agente, vedereCrea IAM utenti da utilizzare con l' CloudWatch agente sui server locali.

Se al profilo attribuisci il nome AmazonCloudWatchAgent, non dovrai effettuare altre operazioni. Eventualmente, puoi assegnare un nome diverso e specificarlo come valore di shared_credential_profile nel file common-config.toml, descritto nella sezione successiva.

Di seguito è riportato un esempio di utilizzo del aws configure comando per creare un profilo denominato per l' CloudWatch agente. Questo esempio presuppone l'utilizzo del nome del profilo predefinito di AmazonCloudWatchAgent.

Per creare il AmazonCloudWatchAgent profilo per l' CloudWatch agente

1. Se non l'hai già fatto, installalo AWS Command Line Interface sul server. Per ulteriori informazioni, consulta l'argomento relativo all'installazione di AWS CLI.

2. Nei server Linux, immetti il seguente comando e segui le istruzioni:

   sudo aws configure --profile AmazonCloudWatchAgent

   In Windows Server, apri PowerShell come amministratore, immetti il comando seguente e segui le istruzioni.

   aws configure --profile AmazonCloudWatchAgent

(Facoltativo) Modifica della configurazione comune e del profilo denominato per l'agente CloudWatch

L' CloudWatch agente include un file di configurazione chiamatocommon-config.toml. Se lo desideri, puoi utilizzare questo file per specificare le informazioni relative al proxy e alla regione.

Su un server che esegue Linux, questo file si trova nella directory /opt/aws/amazon-cloudwatch-agent/etc. Su un server che esegue Windows Server, questo file si trova nella directory C:\ProgramData\Amazon\AmazonCloudWatchAgent.

common-config.toml predefinito è il seguente:

# This common-config is used to configure items used for both ssm and cloudwatch access
 
 
## Configuration for shared credential.
## Default credential strategy will be used if it is absent here:
##            Instance role is used for EC2 case by default.
##            AmazonCloudWatchAgent profile is used for onPremise case by default.
# [credentials]
#    shared_credential_profile = "{profile_name}"
#    shared_credential_file= "{file_name}"
 
## Configuration for proxy.
## System-wide environment-variable will be read if it is absent here.
## i.e. HTTP_PROXY/http_proxy; HTTPS_PROXY/https_proxy; NO_PROXY/no_proxy
## Note: system-wide environment-variable is not accessible when using ssm run-command.
## Absent in both here and environment-variable means no proxy will be used.
# [proxy]
#    http_proxy = "{http_url}"
#    https_proxy = "{https_url}"
#    no_proxy = "{domain}"

Inizialmente, tutte le righe sono commentate. Per impostare questo profilo di credenziali o le impostazioni del proxy, rimuovi # dalla riga e specifica un valore. Puoi modificare questo file manualmente oppure usando il Run Command RunShellScript in Systems Manager:

• shared_credential_profile— Per i server locali, questa riga specifica il profilo di credenziali IAM utente a cui inviare i dati. CloudWatch Se lasci il commento nella riga, verrà utilizzato AmazonCloudWatchAgent. Per ulteriori informazioni sulla creazione di questo profilo, consulta (Installazione su un server locale) Specificare IAM le credenziali e la regione AWS.

  In un'EC2istanza, è possibile utilizzare questa riga per fare in modo che l' CloudWatch agente invii i dati da questa istanza CloudWatch a un'altra regione. AWS A tale scopo, specifica un profilo che includa un campo region con il nome della regione di destinazione.

  Se specifichi un shared_credential_profile, occorre anche rimuovere # dall'inizio della riga [credentials].

• shared_credential_file: per fare in modo che l'agente cerchi le credenziali in un file che si trova in un percorso diverso da quello predefinito, specificare qui il percorso completo e il nome del file. Il percorso predefinito è /root/.aws su Linux e C:\\Users\\Administrator\\.aws su Windows Server.

  Il primo esempio di seguito mostra la sintassi di una riga shared_credential_file valida per server Linux e il secondo esempio è valido per Windows Server. Su Windows Server, è necessario eseguire l'escape dei caratteri \.

  shared_credential_file= "/usr/username/credentials"

  shared_credential_file= "C:\\Documents and Settings\\username\\.aws\\credentials"

  Se specifichi un shared_credential_file, occorre anche rimuovere # dall'inizio della riga [credentials].

• Impostazioni proxy: se i tuoi server utilizzano HTTP o HTTPS proxy per contattare i AWS servizi, specifica tali proxy nei campi and. http_proxy https_proxy Se ce ne sono URLs che devono essere esclusi dal proxy, specificali nel campo, separati da virgole. no_proxy

Avvio dell'agente di CloudWatch

È possibile avviare l' CloudWatch agente utilizzando Systems Manager Run Command o la riga di comando.

Per utilizzare SSM Agent per avviare l' CloudWatch agente su un server locale

1. Aprire la console Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

2. Nel riquadro di navigazione seleziona Run Command.

   oppure

   Se la AWS Systems Manager home page si apre, scorri verso il basso e scegli Esplora Esegui comando.

3. Seleziona Run command (Esegui comando).

4. Nell'elenco dei documenti Command, seleziona il pulsante accanto a AmazonCloudWatch- ManageAgent.

5. Nell'area Targets (Destinazioni), seleziona l'istanza su cui hai installato l'agente.

6. Nell'elenco Action (Operazione), seleziona configure (configura).

7. Nell'elenco Modalità, scegliete onPremise.

8. Nella casella Optional Configuration Location (Posizione configurazione facoltativa), immetti il nome del file di configurazione dell'agente creato con la procedura guidata e archiviato in Parameter Store.

9. Seleziona Esegui.

   L'agente viene avviato con la configurazione specificata nel file di configurazione.

Per utilizzare la riga di comando per avviare l' CloudWatch agente su un server locale

• In questo comando, -a fetch-config fa sì che l'agente carichi la versione più recente del file di configurazione dell' CloudWatch agente e lo -s avvia.

  Linux: se hai salvato il file di configurazione nel Parameter Store di Systems Manager, immetti quanto segue:

  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c ssm:configuration-parameter-store-name

  Linux: se hai salvato il file di configurazione nel computer locale, immetti il seguente comando. Replace (Sostituisci) configuration-file-path con il percorso del file di configurazione dell'agente. Questo file è chiamato config.json se è stato creato con la procedura guidata e potrebbe essere chiamato amazon-cloudwatch-agent.json se viene creato manualmente.

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

  Windows Server: se il file di configurazione dell'agente è stato salvato in Systems Manager Parameter Store, immettere quanto segue dalla PowerShell console:

  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c ssm:configuration-parameter-store-name

  Windows Server: se hai salvato il file di configurazione dell'agente sul computer locale, inserisci quanto segue dalla PowerShell console. Replace (Sostituisci) configuration-file-path con il percorso del file di configurazione dell'agente. Questo file è chiamato config.json se è stato creato con la procedura guidata e potrebbe essere chiamato amazon-cloudwatch-agent.json se viene creato manualmente.

  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c file:configuration-file-path