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

È possibile utilizzare la console AWS Elastic Beanstalk o un file di configurazione per eseguire il daemon AWS X-Ray sulle istanze dell'ambiente. X-Ray è un servizio AWS che raccoglie i dati sulle richieste che l'applicazione serve e li utilizza per creare una mappa del servizio da utilizzare per identificare i problemi con l'applicazione e le opportunità di ottimizzazione.

Nota

In alcune regioni non è possibile usufruire di X-Ray. Se crei un ambiente in una di queste regioni, non potrai eseguire il daemon X-Ray sulle istanze dell'ambiente.

Per informazioni sui servizi AWS 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 è possibile utilizzare per il codice dell'applicazione e un'applicazione daemon che inoltra le informazioni di debug dall'SDK all'API X-Ray.

Piattaforme supportate

Puoi utilizzare SDK X-Ray 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

Nelle piattaforme supportate, è possibile utilizzare un'opzione di configurazione per eseguire il daemon X-Ray sulle istanze dell'ambiente. È possibile abilitare il daemon nella console di Elastic Beanstalk o utilizzando un file di configurazione.

Per essere in grado di caricare dati su X-Ray, il daemon X-Ray richiede le autorizzazioni IAM nella policy gestita AWSXrayWriteOnlyAccess. Queste autorizzazioni sono incluse nel profilo dell'istanza di Elastic Beanstalk. Se non utilizzi il profilo dell'istanza predefinito, consulta Assegnare al daemon l'autorizzazione per inviare i dati a X-Ray nella Guida per gli sviluppatori di 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 del daemon X-Ray in modalità manuale (avanzata) nella Guida per gli sviluppatori di AWS X-Ray.

Configurazione del debug

È possibile abilitare il daemon X-Ray su 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 Regions (Regioni) seleziona la tua Regione AWS.

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

    Nota

    Se si dispone di molti ambienti, utilizzare la barra di ricerca per filtrare l'elenco degli ambienti.

  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 sezione Amazon X-Ray, 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