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à.
# Risolvi i problemi relativi alle build fallite con AI - Preview
**Funzione di anteprima**
Questa funzionalità è disponibile in anteprima ed è soggetta a modifiche.
Quando le build di EC2 Image Builder falliscono, la causa principale può essere lunga e complessa da identificare. La funzionalità Troubleshoot di Image Builder, fornita AWS DevOps da Agent, automatizza questo processo con l'analisi. AI-powered È possibile identificare rapidamente la causa di errori di costruzione complessi o rilevare modelli su più pipeline fallite.
Quando una compilazione fallisce, puoi utilizzare Troubleshoot per analizzare i log di compilazione, i log di Amazon CloudWatch, le esecuzioni delle fasi del flusso di lavoro e le risorse correlate. AWS Riceverai un'analisi della causa principale e una procedura di correzione per risolvere il problema.
È possibile risolvere i problemi relativi alla creazione di una singola pipeline fallita o analizzare più pipeline fallite per identificare modelli comuni e cause principali condivise.
**Topics**
+ [Prerequisiti](#devops-agent-troubleshooting-prereqs)
+ [Configura la risoluzione dei problemi](#devops-agent-troubleshooting-setup)
+ [Risolvi i problemi relativi a una build non riuscita](#devops-agent-troubleshooting-single)
+ [Risolvi i problemi relativi a più pipeline fallite](#devops-agent-troubleshooting-aggregate)
+ [Cosa analizza Troubleshoot](#devops-agent-troubleshooting-checks)
+ [Considerazioni](#devops-agent-troubleshooting-considerations)
## Prerequisiti
Prima di utilizzare la funzionalità di risoluzione dei problemi, assicurati che l'utente o il ruolo IAM che utilizzi disponga delle seguenti autorizzazioni:
+ `aidevops:ListAgentSpaces`— Necessario per scoprire gli spazi disponibili per gli agenti.
+ `aidevops:CreateChat`— Necessario per avviare le sessioni di risoluzione dei problemi.
+ `aidevops:SendChatMessage`— Necessario per inviare messaggi durante la risoluzione dei problemi.
+ `aidevops:CreateAgentSpace`— Richiesto solo se desideri che Image Builder crei uno spazio agente per te. È possibile omettere questa autorizzazione se si dispone di uno spazio riservato agli agenti.
Per ulteriori informazioni sulle politiche IAM, consulta [Politiche e autorizzazioni in](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) IAM.
## Configura la risoluzione dei problemi
La funzionalità di risoluzione dei problemi richiede uno spazio per AWS DevOps agenti. Potete utilizzare uno spazio agente esistente o fare in modo che Image Builder ne crei uno per voi:
+ **Porta il tuo spazio agente**: se disponi già di uno spazio agente, Image Builder lo utilizza per la risoluzione dei problemi.
+ **Chiedi a Image Builder di crearne uno**: se non disponi di uno spazio agente, Image Builder ne crea e configura uno quando inizi la prima indagine. Questa opzione richiede l'autorizzazione. `aidevops:CreateAgentSpace`
Per iniziare la risoluzione dei problemi, scegli l'icona **Risoluzione dei problemi** nell' Console di gestione AWS intestazione.
**Nota**
Per ulteriori informazioni su AWS DevOps Agent, consulta la [Guida per l'utente dell'AWS DevOpsagente](https://docs.aws.amazon.com/devopsagent/latest/userguide/).
## Risolvi i problemi relativi a una build non riuscita
Quando la creazione di un'immagine fallisce, è possibile avviare un' AI-powered indagine da diversi punti di ingresso in Image Builder Console di gestione AWS.
### Avviare un'indagine sulla risoluzione dei problemi
Utilizzate uno dei seguenti metodi per iniziare la risoluzione dei problemi relativi a una build non riuscita:
+ **Tabella Pipeline**: selezionate l'icona **Risoluzione dei problemi** accanto allo stato di una tubazione non riuscita nell'elenco **Image pipelines**.
+ **Tabella delle immagini di output**: selezionate l'icona **Risoluzione dei problemi** accanto alla creazione di un'immagine non riuscita nell'elenco delle immagini di output.
+ **Cassetto per la risoluzione dei problemi**: nell' Console di gestione AWS intestazione, scegli l'icona **Risoluzione dei problemi**, quindi seleziona la pipeline che desideri esaminare.
### Durante l'indagine
Dopo aver avviato la risoluzione dei problemi, Troubleshoot analizza l'errore. È possibile tenere traccia dei progressi in tempo reale nel cassetto man mano che i registri e le risorse vengono analizzati. L'indagine in genere viene completata in pochi minuti. È possibile continuare a lavorare in altre Console di gestione AWS aree durante l'esecuzione dell'analisi. Al termine dell'indagine, riceverai:
+ Analisi della causa principale che identifica il motivo per cui la build non è riuscita
+ Procedure di riparazione per risolvere il problema
+ Comandi o modifiche alla configurazione per risolvere il problema
Dopo aver esaminato i risultati, puoi fornire un feedback sulla qualità della risposta. Per eseguire nuovamente l'analisi sulla stessa build non riuscita, scegli nuovamente **Risoluzione dei problemi**.
## Risolvi i problemi relativi a più pipeline fallite
Se hai più pipeline fallite, puoi analizzarle insieme per identificare modelli comuni e cause principali condivise.
### Avvia un'indagine aggregata
Utilizza uno dei seguenti metodi per risolvere più pipeline:
+ **Nella tabella **Image pipelines**, selezionate più pipeline fallite e scegliete Risoluzione dei problemi selezionata.**
+ Apri il riquadro di risoluzione dei problemi e scegli **Risoluzione** dei problemi per analizzare tutte le pipeline fallite.
### Risultati di analisi aggregati
Riceverai un'analisi raggruppata organizzata per causa principale. Per ogni gruppo, ottieni:
+ Descrizione della causa principale condivisa
+ Pipeline interessate da tale causa principale
+ Procedure di riparazione per il gruppo
Dopo l'analisi aggregata, è possibile scegliere un prompt di approfondimento per analizzare una pipeline specifica in modo più dettagliato.
## Cosa analizza Troubleshoot
Quando si risolve un problema relativo a una build non riuscita, l'analisi copre le seguenti aree:
+ Registri di **compilazione e CloudWatch log di Amazon**: verifica la presenza di errori, codici di uscita diversi da zero, timeout e tracce dello stack.
+ **Esecuzioni delle fasi del flusso di lavoro**: identifica la fase non riuscita e ne esamina i dettagli.
+ **Rete e autorizzazioni: esamina le autorizzazioni** dei profili delle istanze IAM, i gruppi di sicurezza, il routing delle sottoreti, i gateway NAT, i gateway Internet e gli endpoint VPC.
+ **Configurazione dei componenti e delle ricette**: verifica la presenza di errori di script, dipendenze mancanti, URL non funzionanti e validità dell'AMI di base.
+ **Connettività di rete**: verifica la raggiungibilità dell'agente AWS Systems Manager (Systems Manager), la risoluzione DNS e la configurazione del proxy.
+ **Cronologia delle build**: esamina le build recenti per distinguere gli errori persistenti dai problemi intermittenti.
## Considerazioni
Tieni presente quanto segue quando utilizzi la funzionalità di risoluzione dei problemi:
+ Troubleshoot esegue analisi di sola lettura. Le tue risorse non vengono modificate.
+ La risoluzione dei problemi riguarda gli errori di compilazione di Image Builder e l'infrastruttura correlata come IAM, VPC e Systems Manager Agent.
**Nota**
L'IA genera queste risposte. Verifica l'analisi e i consigli prima di modificare le tue risorse.
Per ulteriori informazioni sulla risoluzione dei problemi relativi alle build della pipeline di Image Builder, vedere. [Risolvi i problemi relativi alle build della pipeline](troubleshooting.md#troubleshooting-pipelines)