

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
<a name="environment-configuration-debugging"></a>

Puoi usare la AWS Elastic Beanstalk console o un file di configurazione per eseguire il AWS X-Ray demone sulle istanze del tuo ambiente. X-Ray è un AWS servizio che raccoglie dati sulle richieste servite dall'applicazione e li utilizza per creare una mappa dei servizi che è possibile utilizzare per identificare problemi con l'applicazione e 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 AWS servizi offerti in ciascuna regione, consulta la Tabella delle regioni.](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)

![\[Mappa del servizio per un'applicazione Web dell'API che utilizza Amazon DynamoDB per archiviare i dati\]](http://docs.aws.amazon.com/it_it/elasticbeanstalk/latest/dg/images/scorekeep-servicemap.png)


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](#environment-configuration-debugging-console) o utilizzando un [file di configurazione](#environment-configuration-debugging-namespace).

Per 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](concepts-roles-instance.md). Se non utilizzi il profilo dell'istanza predefinito, consulta [Assegnare al daemon l'autorizzazione per inviare i dati a X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon.html#xray-daemon-permissions) 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](https://docs.aws.amazon.com/xray/latest/devguide/xray-gettingstarted.html) 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)](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon-beanstalk.html#xray-daemon-beanstalk-manual) nella *Guida per gli sviluppatori di AWS X-Ray *.

**Topics**
+ [Configurazione del debug](#environment-configuration-debugging-console)
+ [Spazio dei nomi aws:elasticbeanstalk:xray](#environment-configuration-debugging-namespace)

## Configurazione del debug
<a name="environment-configuration-debugging-console"></a>

È 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](https://console.aws.amazon.com/elasticbeanstalk) e, **nell'elenco Regioni, seleziona la tua**. Regione AWS

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

1. Nel riquadro di navigazione, seleziona **Configuration** (Configurazione).

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

1. Nella sezione **Amazon X-Ray**, seleziona **Attivato**.

1. 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](environments-create-wizard.md).

## Spazio dei nomi aws:elasticbeanstalk:xray
<a name="environment-configuration-debugging-namespace"></a>

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](ebextensions.md) del codice sorgente, come descritto di seguito.

**Example .ebextensions/debugging.config**  

```
option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true
```