View a markdown version of this page

Visualizzazione dei log di distribuzione per un ambiente Elastic Beanstalk - AWS Elastic Beanstalk

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à.

Visualizzazione dei log di distribuzione per un ambiente Elastic Beanstalk

Elastic Beanstalk genera un registro di distribuzione per ogni distribuzione nell'ambiente. Il registro di distribuzione fornisce una visione cronologica consolidata di ciò che è accaduto durante una distribuzione, tra cui l'installazione delle dipendenze, l'output della build, l'avvio dell'applicazione e gli eventuali errori riscontrati. È possibile utilizzare i log di distribuzione per diagnosticare rapidamente le distribuzioni non riuscite senza dover inserire SSH nelle istanze o correlare più file di registro.

I log di distribuzione vengono scritti localmente su ogni istanza. Per le distribuzioni attivate tramite console, CLI, API o aggiornamenti gestiti, un'istanza carica continuamente il proprio registro su Amazon S3 durante la distribuzione. La console Elastic Beanstalk legge il registro da Amazon S3, così puoi monitorare i progressi senza connetterti all'istanza.

I log di distribuzione sono progettati per essere concisi. In caso di successo, il registro mostra solo messaggi di riepilogo (ad esempio, i comandi eseguiti e completati). In caso di errore, il registro include fino a 50 righe di output della fase non riuscita, in modo da poter visualizzare l'errore senza passare al setaccio l'output dettagliato.

Nota

I log di distribuzione sono disponibili nelle versioni della piattaforma Amazon Linux 2 e Amazon Linux 2023 rilasciate a partire dall'11 marzo 2026. Le piattaforme Windows non sono attualmente supportate.

Operazioni supportate

I log di distribuzione vengono generati per le seguenti operazioni:

  • Distribuzioni delle applicazioni: distribuzione di una nuova versione dell'applicazione nell'ambiente.

  • Aggiornamenti della configurazione: modifica delle impostazioni di configurazione dell'ambiente che richiedono aggiornamenti delle istanze.

  • Creazione dell'ambiente: la distribuzione iniziale quando si crea un nuovo ambiente.

  • Riavvia l'app server: riavvio del server delle applicazioni sulle istanze.

Le operazioni che non modificano lo stato dell'applicazione o della configurazione sulle istanze, come la richiesta di log, lo scambio o l'aggiornamento dei tag, non CNAMEs generano log di distribuzione.

Contenuto dei registri di distribuzione

Un registro di distribuzione acquisisce le seguenti informazioni durante una distribuzione:

  • Ciclo di vita della distribuzione: messaggi di inizio e completamento per ogni fase di distribuzione, ad esempio e. Starting Application deployment Completed Application deployment

  • Output.ebextensions: in caso di successo, i nomi dei comandi eseguiti. In caso di errore, vengono visualizzate le ultime 50 righe di cfn-init output per facilitare la diagnosi del problema.

  • Output degli hook della piattaforma: in caso di successo, i nomi degli script hook eseguiti. In caso di errore, vengono emesse le ultime 50 righe dell'hook.

  • Installazione in base alle dipendenze: output di gestori di pacchetti come npm installpip install,composer install, ebundle install. In caso di successo, viene registrato solo un messaggio di completamento. In caso di errore, vengono incluse le ultime 50 righe di output.

  • Output di compilazione: output di comandi di compilazione come docker buildgo build, e build Java. In caso di errore, vengono incluse le ultime 50 righe di output.

  • Output di avvio dell'applicazione: output iniziale dell'applicazione dopo l'avvio. La fonte dipende dalla piattaforma in uso:

    • Docker: registri del contenitore da o docker logs docker compose logs

    • Java SE, Go, Node.js, Python, Ruby, .NET — Elabora i registri stdout

    • Uscita del registro Tomcat — Catalina

    • PHP — Registri degli errori del master e del pool PHP-FPM

    • ECS: registri dei container provenienti da ogni contenitore di attività

    Nota

    L'output dell'applicazione viene acquisito a partire da 2 secondi dopo l'avvio dell'applicazione. Sono inclusi solo i messaggi di avvio iniziali: se l'applicazione impiega più tempo a produrre l'output, questo non verrà visualizzato nel registro di distribuzione. Per visualizzare i log completi dell'applicazione, richiedi i log dei pacchetti o connettiti direttamente all'istanza. Per ulteriori informazioni, consulta Visualizzazione dei log dalle istanze.

Quando una fase di distribuzione fallisce, il registro la contrassegna con [ERROR] e include fino a 50 righe di output della fase non riuscita. Se il registro di distribuzione non contiene dettagli sufficienti, è possibile recuperare i registri completi dell'istanza (inclusi eb-engine.log i registri delle applicazioni) dalla scheda Registri. eb-hooks.log Per ulteriori informazioni, consulta Visualizzazione dei log delle istanze Amazon EC2 nell'ambiente Elastic Beanstalk.

Visualizzazione dei log di distribuzione nella console

La console Elastic Beanstalk offre una scheda Distribuzioni nella dashboard dell'ambiente in cui è possibile visualizzare la cronologia e i log di distribuzione.

Visualizzazione della cronologia di distribuzione

Per visualizzare la cronologia delle distribuzioni
  1. Apri la console Elastic Beanstalk e, nell'elenco Regioni, seleziona la tua. Regione AWS

  2. Nel pannello di navigazione selezionare Environments (Ambienti), quindi selezionare il nome dell'ambiente dall'elenco.

  3. Nella dashboard dell'ambiente, scegli la scheda Distribuzioni.

    La scheda Distribuzioni mostra una tabella delle distribuzioni per l'ambiente. Ogni riga include le seguenti informazioni:

    • ID richiesta: l'identificatore univoco per la distribuzione.

    • Stato: riuscita, non riuscita o in corso.

    • Tipo: il tipo di distribuzione, ad esempio Environment Creation, Application Deployment, Configuration Update, Managed Platform Update, Restart App Server, Rebuild Environment, Restore Environment, Swap Environment Domain o Terminate Environment.

    • Ora di inizio: quando è iniziata la distribuzione.

    • Durata: quanto tempo è stato necessario per completare l'implementazione.

Quando è in corso una distribuzione, la scheda richiede automaticamente gli aggiornamenti. Puoi anche scegliere il pulsante di aggiornamento per ricaricare manualmente l'elenco.

Visualizzazione dei dettagli e dei registri di distribuzione

Per visualizzare i dettagli della distribuzione
  1. Nella scheda Distribuzioni, scegli il link Request ID per la distribuzione che desideri ispezionare.

  2. La pagina dei dettagli della distribuzione mostra una sezione di riepilogo con l'ID della richiesta, lo stato, il tipo di distribuzione, l'ora di inizio, la durata e la politica di distribuzione. La politica di distribuzione (ad esempio, All at once, Rolling, Rolling with additional batch, Immutable o Traffic splitting) viene visualizzata quando può essere determinata dagli eventi di distribuzione.

  3. Sotto il riepilogo, scegli una delle seguenti schede:

    • Eventi: una cronologia degli eventi relativi a questa distribuzione, filtrata per mostrare solo gli eventi per la distribuzione selezionata.

    • Registri di distribuzione: il registro di distribuzione consolidato dell'istanza. È possibile cercare, filtrare per livello di registro e scaricare il file di registro.

Per le distribuzioni in corso, la scheda dei registri si aggiorna automaticamente per mostrare le nuove voci di registro man mano che vengono scritte. Al termine di una distribuzione, la console recupera lo stato finale del registro per garantire la visualizzazione dell'output completo.

Importante

La visualizzazione dei log di distribuzione nella console richiede l's3:GetObjectautorizzazione sul elasticbeanstalk-region-account-id bucket di storage Amazon S3 dell'ambiente (). Se la tua policy IAM non include questa autorizzazione, la cronologia e gli eventi di distribuzione saranno ancora disponibili, ma la scheda dei log mostrerà un errore.

File di registro di distribuzione sulle istanze

I log di distribuzione vengono scritti /var/log/deployments/ nella directory di ogni istanza. Il nome del file di registro dipende da come è stata attivata la distribuzione:

  • Distribuzioni controllate dal flusso di lavoro (attivate tramite console, CLI o API): eb-deployment-request-id.log dov'è l'ID univoco della richiesta di distribuzione. request-id

  • Distribuzioni con avvio automatico (avvio dell'istanza o riavvio dell'app server) —. eb-deployment-unix-timestamp.log

Elastic Beanstalk ruota automaticamente questi file, mantenendo i 50 log di distribuzione più recenti su ogni istanza.

Per le distribuzioni controllate dal flusso di lavoro, il log viene caricato su Amazon S3 nel seguente percorso:

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/log-filename

In ambienti a più istanze, la prima istanza che inizia il caricamento rivendica il ruolo dell'intera distribuzione. Tale istanza carica il registro su Amazon S3 per tutta la durata della distribuzione. Tutte le istanze continuano a scrivere i log di distribuzione localmente.

Importante

Il caricamento dei log di distribuzione su Amazon S3 s3:PutObject richiede l'autorizzazione sul bucket di storage Amazon S3 dell'ambiente nel profilo dell'istanza e la configurazione VPC deve consentire la connettività ad Amazon S3.

I caricamenti dei log di distribuzione sono limitati a 1 MB per file. Se un log di distribuzione supera questa dimensione, la versione caricata viene troncata con un messaggio che indica che il log completo è disponibile sull'istanza.

Disabilitazione dei caricamenti dei log S3

Per evitare che i log di distribuzione vengano caricati su Amazon S3, imposta la seguente proprietà di ambiente sul tuo ambiente:

option_settings: - namespace: aws:elasticbeanstalk:application:environment option_name: EB_DEPLOYMENT_LOG_S3_DISABLED value: true

Quando questa proprietà di ambiente è impostata, i log di distribuzione vengono ancora scritti localmente /var/log/deployments/ su ogni istanza, ma non vengono caricati su Amazon S3 e non saranno disponibili nella scheda Distribuzioni della console. È inoltre possibile impostare questa proprietà nella pagina Configurazione in Software oppure utilizzando l'EB CLI o. AWS CLI