AWS Systems ManagerChange Managernon è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta AWS Systems ManagerChange Managerla pagina Modifica della disponibilità.

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 a SSM Agent

Se riscontri problemi nell'esecuzione delle operazioni sui nodi gestiti, potrebbe esserci un problema con AWS Systems Manager Agent (SSM Agent). Le informazioni seguenti sono utili per visualizzare i file di log di SSM Agent e risolvere i problemi relativi all'agente. Se l'agente sembra non rispondere o ha una frequenza di comunicazione ridotta, vedi. Comprendere l'ibernazione SSM Agent

SSM Agent non è aggiornato

Una versione aggiornata di SSM Agent viene distribuita ogni volta che vengono aggiunti nuovi strumenti a Systems Manager o eseguiti aggiornamenti degli strumenti esistenti. Il mancato utilizzo della versione più recente dell'agente può impedire al nodo gestito di utilizzare vari strumenti e funzionalità di Systems Manager. Per questo motivo, ti consigliamo di automatizzare il processo di aggiornamento di SSM Agent sulle macchine. Per informazioni, consulta Automazione degli aggiornamenti di SSM Agent. Iscriviti alla pagina Note di rilascio di SSM Agent su GitHub per ricevere notifiche sugli aggiornamenti di SSM Agent.

Risolvere i problemi utilizzando i file di log dI SSM Agent

SSM Agent registra informazioni nei file seguenti. Le informazioni in questi file possono agevolare la risoluzione dei problemi. Per ulteriori informazioni sui file di log di SSM Agent, incluso come attivare la registrazione di debug, consultare Visualizzazione dei registri di SSM Agent.

Per i nodi gestiti Linux, è possibile trovare ulteriori informazioni nel file messages scritte nella directory seguente: /var/log.

Per ulteriori informazioni sulla risoluzione dei problemi utilizzando i log degli agenti, consulta Come posso utilizzare i log di SSM Agent per risolvere i problemi relativi all’SSM Agent nella mia istanza gestita? nel Knowledge Center di AWS re:POST.

I file di log dell'agente non ruotano (Windows)

Se si specifica la rotazione del file di log basata sulla data nel file seelog.xml (sui nodi gestiti Windows Server) e i registri non ruotano, specificare il parametro fullname=true. Ecco un esempio di file di configurazione seelog.xml con il parametro fullname=true specificato.

<seelog type="adaptive" mininterval="2000000" maxinterval="100000000" critmsgcount="500" minlevel="debug">
   <exceptions>
      <exception filepattern="test*" minlevel="error" />
   </exceptions>
   <outputs formatid="fmtinfo">
      <console formatid="fmtinfo" />
      <rollingfile type="date" datepattern="200601021504" maxrolls="4" filename="C:\ProgramData\Amazon\SSM\Logs\amazon-ssm-agent.log" fullname=true />
      <filter levels="error,critical" formatid="fmterror">
         <rollingfile type="date" datepattern="200601021504" maxrolls="4" filename="C:\ProgramData\Amazon\SSM\Logs\errors.log" fullname=true />
      </filter>
   </outputs>
   <formats>
      <format id="fmterror" format="%Date %Time %LEVEL [%FuncShort @ %File.%Line] %Msg%n" />
      <format id="fmtdebug" format="%Date %Time %LEVEL [%FuncShort @ %File.%Line] %Msg%n" />
      <format id="fmtinfo" format="%Date %Time %LEVEL %Msg%n" />
   </formats>
</seelog>

Impossibile connettersi agli endpoint SSM

SSM Agent deve permettere il traffico in uscita HTTPS (porta 443) verso i seguenti endpoint:

regionrappresenta l'identificatore di una regione Regione AWS supportata da AWS Systems Manager, ad esempio us-east-2 per la regione Stati Uniti orientali (Ohio). Per un elenco dei region valori supportati, vedere la colonna Regione negli endpoint del servizio Systems Manager in. Riferimenti generali di Amazon Web Services

SSM Agentnon funzionerà se non è in grado di comunicare con gli endpoint precedenti, come descritto, anche se utilizzi AWS provided Amazon Machine Images (AMIs) come Amazon Linux 2 o Amazon Linux 2023. La configurazione di rete deve disporre di un accesso a Internet aperto oppure è necessario disporre di endpoint VPC (Virtual Private Cloud) personalizzati configurati. Se non si prevede di creare un endpoint VPC personalizzato, controllare i gateway Internet o i gateway NAT. Per maggiori informazioni su come gestire gli endpoint VPC, consultare Migliora la sicurezza delle EC2 istanze utilizzando gli endpoint VPC per Systems Manager.

Verifica la configurazione VPC

Se si utilizza un cloud privato virtuale (VPC), per gestire EC2 le istanze con Systems Manager, gli endpoint VPC devono essere configurati correttamente per e, in alcuni casi ssm.region.amazonaws.com.rproxy.govskope.cassmmessages.region.amazonaws.com, spiegati in precedenza in questo argomento in,. Impossibile connettersi agli endpoint SSM ec2messages.region.amazonaws.com

Per risolvere i problemi relativi agli endpoint VPC, esegui queste operazioni:

Per ulteriori informazioni, consulta i seguenti argomenti:

Verifica gli attributi relativi al DNS del VPC

Se utilizzi un cloud privato virtuale (VPC), come parte della verifica della configurazione del VPC, assicurati che gli attributi e siano abilitati. enableDnsSupport enableDnsHostnames

Puoi abilitare questi attributi utilizzando l'azione VPCAttribute API Amazon EC2 Modify o il AWS CLI comando modify-vpc-attribute.

Per informazioni sull'attivazione di questi attributi nella console di Amazon VPC, consulta Visualizzazione e aggiornamento degli attributi DNS per il VPC nella Guida per l'utente di Amazon VPC.

Verifica le regole di accesso sui gruppi di sicurezza degli endpoint

Assicurati che tutti gli endpoint VPC configurati (ssmssmmessages, eec2messages) includano una regola di ingresso sui relativi gruppi di sicurezza per consentire l'ingresso del traffico sulla porta 443. Se necessario, è possibile creare un nuovo gruppo di sicurezza nel VPC con una regola di ingresso per consentire il traffico sulla porta 443 per il blocco del routing interdominio senza classi (CIDR) relativo al VPC. Dopo aver creato il gruppo di sicurezza, collegalo a ciascun endpoint VPC.

Per ulteriori informazioni, consulta i seguenti argomenti:

Utilizzare ssm-cli per risolvere i problemi relativi alla disponibilità dei nodi gestiti

A partire da SSM Agent versione 3.1.501.0, è possibile utilizzare ssm-cli per determinare se un nodo gestito soddisfa i requisiti principali per essere gestito da Systems Manager e per apparire negli elenchi di nodi gestiti in Fleet Manager. ssm-cli è uno strumento a riga di comando autonomo incluso nell'installazione di SSM Agent. Sono inclusi comandi preconfigurati che raccolgono le informazioni necessarie per aiutarti a diagnosticare perché EC2 un'istanza o una EC2 macchina non Amazon che hai confermato sia in esecuzione non è inclusa negli elenchi di nodi gestiti in Systems Manager. Questi comandi vengono eseguiti quando si specifica l'opzione get-diagnostics.

Per ulteriori informazioni, consulta Risoluzione dei problemi relativi alla disponibilità dei nodi gestiti tramite ssm-cli.