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

# Integrazione con AWS DevOps Agent
<a name="devops-agent-integration"></a>

Con [AWS DevOps Agent](https://aws.amazon.com/devops-agent/), puoi automatizzare l'analisi dei risultati dei test di carico direttamente dalla soluzione Distributed Load Testing on AWS. Quando connetti un Agent Space, puoi inviare i test completati all'agente per l'analisi. L'agente identifica in modo proattivo i punti deboli nelle prestazioni, determina le cause alla radice e suggerisce le misure correttive, senza che sia necessario correlare manualmente i parametri, i log e le tracce di Amazon. CloudWatch 

## Prerequisiti
<a name="devops-agent-prerequisites"></a>

Prima di connettere un Agent Space a Distributed Load Testing on AWS (DLT), completa quanto segue:
+ L'Agent Space deve trovarsi nello stesso account AWS della distribuzione DLT.
+ L'Agent Space deve essere etichettato con la chiave `dlt-integration` e il valore`allowed`. Questo tag stabilisce un doppio consenso: sia l'operatore DLT che l'amministratore di Agent Space devono intraprendere un'azione esplicita prima che DLT possa accedere all'Agent Space.
+ Il `dlt-integration: allowed` tag deve essere presente prima che DLT possa accettare richieste di test di connessione o di indagine, anche se l'ARN di Agent Space è valido.

Per aggiungere il tag, scegli la [console AWS DevOps Agent](https://console.aws.amazon.com/aidevops) e scegli il tuo Agent Space. Scegli la scheda **Configurazione**. Scorri verso il basso fino alla sezione **Tag****, scegli Aggiungi nuovo tag**, inserisci `dlt-integration` `allowed` come chiave e come valore, quindi scegli **Salva**.

## Registra un Agent Space
<a name="devops-agent-register"></a>

Dopo aver taggato il tuo Agent Space, completa i seguenti passaggi per registrarlo con DLT:

1. Scegli **Agent Integration** nella barra laterale sinistra della console web DLT.

1. Nella sezione **DevOps Agent Connections**, scegli **Register Agent Space.**

1. Inserisci un nome visualizzato e incolla l'ARN di Agent Space dalla console AWS DevOps Agent.

1. Scegliete **Test Connection** per verificare che l'ARN sia raggiungibile e che il `dlt-integration: allowed` tag sia presente.

1. **Dopo aver confermato la connessione, scegli Salva.**

Puoi registrare più Agent Space e selezionarne uno quando avvii un'indagine.

## Esamina un'esecuzione di test
<a name="devops-agent-investigate"></a>

Dopo aver registrato almeno un Agent Space, puoi avviare un'indagine dopo ogni test completato. Il pulsante **Investigate with DevOps Agent** viene visualizzato nella pagina dei dettagli di ogni esecuzione del test. Completa questa procedura:

1. Scegliete **Investigate with DevOps Agent** dopo il completamento di un test (riuscito, fallito o parziale).

1. Se hai registrato più Agent Spaces, scegline uno dall'elenco.

1. Facoltativamente, fornisci un contesto aggiuntivo, ad esempio una descrizione delle recenti modifiche all'infrastruttura o la linea di base delle prestazioni previste.

1. Seleziona **Invia**.

L'indagine viene visualizzata nella scheda **Investigazioni** della pagina dei dettagli dell'esecuzione del test, dove puoi monitorarne lo stato e scegliere il collegamento per visualizzare i risultati nella console AWS DevOps Agent.

**Nota**  
AWS DevOps Agent impone un limite di 10.000 caratteri per la descrizione dell'indagine. La descrizione inviata dalla soluzione combina il contesto opzionale con un DLT-generated riepilogo dell'esecuzione del test (configurazione del test, confronto di base, principali errori ordinati per conteggio e suddivisione per endpoint). Per rispettare il limite, la soluzione dà la priorità alla configurazione del test e al contesto fornito dall'utente e taglia le sezioni con priorità più bassa, a partire dalla suddivisione per endpoint, quando la lunghezza combinata supererebbe altrimenti i 10.000 caratteri.

## Esaminare i risultati
<a name="devops-agent-findings"></a>

Le indagini su AWS DevOps Agent in genere vengono completate in pochi minuti, ma potrebbero differire a seconda della configurazione di Agent Space. Al termine, scegli **Visualizza risultati** nella scheda **Investigazioni** per aprire i risultati nella console AWS DevOps Agent.

I risultati includono quanto segue:
+ Un'analisi strutturata delle cause principali che identifica quali componenti hanno contribuito alla latenza o agli errori.
+ Un elenco di sintomi osservati durante la finestra di test.
+ Suggerimenti concreti per la bonifica.

Le indagini rimangono nella scheda DLT **Investigations** per tutta la durata del record di esecuzione del test, in modo da poter fare riferimento alle analisi precedenti man mano che l'applicazione si evolve.

## Flusso di lavoro consigliato
<a name="devops-agent-suggested-workflow"></a>

Per ottenere il massimo dall'integrazione con AWS DevOps Agent, usala come parte di un ciclo iterativo di ottimizzazione delle prestazioni: distribuzione, test di carico, analisi, correzione e ripetizione. Ogni passaggio del ciclo fornisce all'agente più cronologia con cui confrontare e fornisce prove misurabili del fatto che una modifica ha migliorato le prestazioni.

1.  **Implementazione**[: distribuisci l'applicazione nell'ambiente che desideri testare e completa la configurazione una tantum descritta in [Prerequisiti](#devops-agent-prerequisites) e registrazione di uno spazio per agenti.](#devops-agent-register)

1.  **Stabilisci una linea di base**[: esegui lo scenario di test su una build nota e valida e imposta l'esecuzione come riferimento (consulta Baseline comparison).](explore-test-results.md#baseline-comparison) Quando viene impostata una linea di base, la soluzione include un confronto con la richiesta di indagine, in modo che l'agente possa distinguere una regressione dalla variazione normale.

1.  **Test di carico**: esegui lo scenario di test dopo ogni modifica dell'applicazione o dell'infrastruttura. Mantieni costante la configurazione dello scenario tra le esecuzioni in modo che i risultati rimangano confrontabili.

1.  **Indagate**: una volta completata l'esecuzione, scegliete **Investigate with DevOps Agent** nella pagina dei dettagli dell'esecuzione del test. Fornisci un contesto su ciò che è cambiato dall'ultima esecuzione (implementazioni recenti, modifiche alla configurazione o prestazioni previste) in modo che l'agente possa concentrare l'analisi.

1.  **Correzione**: esamina la causa principale e i suggerimenti di riparazione nella scheda **Investigazioni** o apri i risultati nella console AWS DevOps Agent per generare un piano di mitigazione. Applica la correzione alla tua applicazione o infrastruttura.

1.  **Ripeti**: Re-run esegui lo scenario di test e confronta i risultati con quelli di riferimento per verificare la correzione. Quando le prestazioni migliorano, stabilite la nuova corsa come riferimento di base e continuate il ciclo con la prossima modifica.

**Nota**  
Ogni esecuzione del test supporta un'indagine attiva alla volta. Archivia un'indagine completata dalla scheda **Indagini** prima di iniziarne una nuova durante lo stesso test.