View a markdown version of this page

Configurazione AWS X-Ray debug - 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à.

Configurazione AWS X-Ray debug

È possibile utilizzare la AWS Elastic Beanstalk console o un file di configurazione per eseguire il AWS X-Ray demone sulle istanze del proprio ambiente. X-Ray è un AWS servizio che raccoglie dati sulle richieste soddisfatte dall'applicazione e li utilizza per creare una mappa dei servizi che è possibile utilizzare per identificare i problemi relativi all'applicazione e le opportunità di ottimizzazione.

Nota

L'esecuzione del X-Ray demone si applica solo agli ambienti Beanstalk Standard. Con Beanstalk Cluster, invia le tracce della tua applicazione a AWS X-Ray impostando l'traces-backendopzione nel aws:elasticbeanstalk:eks:observability namespace su ed Elastic Beanstalk gestirà i componenti di raccolta per xray te. Consulta Monitoraggio degli ambienti Beanstalk Cluster e Opzioni di configurazione per ambienti Beanstalk Cluster.

Nota

Alcune regioni non offrono. X-Ray Se crei un ambiente in una di queste aree, non puoi eseguire il X-Ray demone sulle istanze del tuo ambiente.

Per informazioni sui AWS servizi offerti in ciascuna regione, consulta la tabella delle regioni.

Mappa del servizio per un'applicazione Web dell'API che utilizza Amazon DynamoDB per archiviare i dati

X-Ray fornisce un SDK che puoi usare per strumentare il codice dell'applicazione e un'applicazione daemon che inoltra le informazioni di debug dall'SDK all'API. X-Ray

Piattaforme supportate

Puoi utilizzare l' X-Ray SDK con le seguenti piattaforme Elastic Beanstalk:

  • Go - versione 2.9.1 e successive

  • Java 8 - versione 2.3.0 e successive

  • Java 8 con Tomcat 8 - versione 2.4.0 e successive

  • Node.js- versione 3.2.0 e successive

  • Windows Server - Tutte le versioni della piattaforma rilasciate a partire dal 18 dicembre 2016

  • Python - versione 2.5.0 e successive

Sulle piattaforme supportate, puoi utilizzare un'opzione di configurazione per eseguire il X-Ray demone sulle istanze del tuo ambiente. È possibile abilitare il daemon nella console di Elastic Beanstalk o utilizzando un file di configurazione.

Per caricare i dati su X-Ray, il X-Ray daemon richiede le autorizzazioni IAM nella policy gestita. AWSXrayWriteOnlyAccess Queste autorizzazioni sono incluse nel profilo dell'istanza di Elastic Beanstalk. Se non utilizzi il profilo di istanza predefinito, consulta Giving the Daemon Permission to Send Data to X-Ray nella Developer Guide. AWS X-Ray

Il debug con X-Ray richiede l'uso dell'SDK. X-Ray Per istruzioni e applicazioni di esempio, consulta Nozioni di base su AWS X-Ray nella Guida per gli sviluppatori di AWS X-Ray .

Se utilizzi una versione della piattaforma che non include il daemon, è comunque possibile eseguirlo con uno script in un file di configurazione. Per ulteriori informazioni, consulta Download ed esecuzione manuale del X-Ray daemon (avanzato) nella Guida per gli sviluppatori. AWS X-Ray

Configurazione del debug

Puoi abilitare il X-Ray demone in un ambiente in esecuzione nella console Elastic Beanstalk.

Per abilitare il debug nella console Elastic Beanstalk
  1. Apri la console Elastic Beanstalk e, nell'elenco delle regioni, seleziona la tua. Regione AWS

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

  3. Nel riquadro di navigazione, seleziona Configuration (Configurazione).

  4. Nella categoria di configurazione Updates, monitoring, and logging (Aggiornamenti, monitoraggio e registrazione), scegli Edit (Modifica).

  5. Nella X-Ray sezione Amazon, seleziona Attivato.

  6. Per salvare le modifiche scegli Apply (Applica) nella parte inferiore della pagina.

È anche possibile abilitare questa opzione durante la creazione dell'ambiente. Per ulteriori informazioni, consulta Procedura guidata per la creazione del nuovo ambiente.

Spazio dei nomi aws:elasticbeanstalk:xray

Puoi utilizzare l'opzione XRayEnabled nel namespace aws:elasticbeanstalk:xray per abilitare il debug.

Per abilitare il debug automaticamente quando distribuisci l'applicazione, imposta l'opzione in un file di configurazione del codice sorgente, come descritto di seguito.

Esempio. ebextensions/debugging.config
option_settings: aws:elasticbeanstalk:xray: XRayEnabled: true