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 non riuscite con AI - Preview
**funzione di anteprima**
Questa funzionalità è 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 da AWS DevOps Agent, automatizza questo processo con l'analisi. AI-powered È possibile identificare rapidamente la causa di errori di compilazione complessi o rilevare modelli su più pipeline fallite.
Quando una compilazione fallisce, puoi utilizzare Troubleshoot per analizzare i log di build, i log di Amazon, le esecuzioni CloudWatch 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.
Puoi risolvere una singola build di 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)
+ [Risolvere i problemi relativi a una compilazione 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 funzione Troubleshoot, 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`— Obbligatorio solo se desideri che Image Builder crei uno spazio agente per te. Puoi omettere questa autorizzazione se utilizzi il tuo spazio per gli agenti.
Per ulteriori informazioni sulle politiche IAM, consulta [ Politiche e autorizzazioni in IAM. ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)
## Configura la risoluzione dei problemi
La funzione Troubleshoot richiede uno spazio AWS DevOps Agent Agent. Puoi utilizzare uno spazio agente esistente o chiedere a Image Builder di crearne uno per te:
+ **Crea 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 per gli agenti, Image Builder ne crea e ne configura uno quando inizi la prima indagine. Questa opzione richiede l'`aidevops:CreateAgentSpace`autorizzazione.
Per iniziare la risoluzione dei problemi, scegli l'**icona ** Risoluzione dei problemi nell'intestazione Console di gestione AWS .
**Nota**
Per ulteriori informazioni sull' AWS DevOps agente, consulta la Guida per l'utente dell'[AWS DevOpsagente. ](https://docs.aws.amazon.com/devopsagent/latest/userguide/)
## Risolvere i problemi relativi a una compilazione non riuscita
Quando la creazione di un'immagine ha esito negativo, è possibile avviare un' AI-powered indagine da diversi punti di ingresso in Image Builder. Console di gestione AWS
### Avvia un'indagine per la risoluzione dei problemi
Utilizza uno dei seguenti metodi per iniziare la risoluzione dei problemi relativi a una build non riuscita:
+ **Tabella Pipelines**: scegliete l'**icona ** Troubleshooting accanto allo stato di una pipeline fallita nell'elenco Image pipelines. ** **
+ **Tabella delle immagini di output**: scegliete l'**icona ** Troubleshooting accanto a una build di immagine non riuscita nell'elenco delle immagini di output.
+ **Riquadro per la risoluzione dei problemi**: nell' Console di gestione AWS intestazione, scegli l'**icona ** Troubleshooting, quindi seleziona la pipeline che desideri esaminare.
### Durante l'indagine
Dopo aver avviato la risoluzione dei problemi, Troubleshoot analizza l'errore. Puoi tenere traccia dei progressi in tempo reale nel cassetto mentre i registri e le risorse vengono analizzati. L'indagine si completa in genere 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 compilazione 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 guaste, puoi analizzarle insieme per identificare modelli comuni e cause principali condivise.
### Avvia un'indagine aggregata
Utilizzate uno dei seguenti metodi per risolvere i problemi relativi a più pipeline:
+ Nella ** tabella ** Image pipelines, selezionate più pipeline fallite e scegliete Risoluzione dei problemi selezionati. ** **
+ Apri il cassetto per la risoluzione dei problemi e scegli Risoluzione dei problemi per analizzare tutte le ** pipeline guaste. **
### Risultati aggregati dell'analisi
Riceverai un'analisi raggruppata organizzata per causa principale. Per ogni gruppo, ottieni:
+ Descrizione della causa principale condivisa
+ Pipeline interessate da tale causa principale
+ Fasi di riparazione per il gruppo
Dopo l'analisi aggregata, puoi scegliere un prompt di approfondimento per esaminare 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:
+ **Log di compilazione e CloudWatch log 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 AWS Systems Manager (Systems Manager) la raggiungibilità dell'agente, la risoluzione DNS e la configurazione del proxy.
+ **Cronologia delle build**: esamina le build recenti per distinguere i guasti persistenti dai problemi intermittenti.
## Considerazioni
Quando utilizzi la funzionalità Risoluzione dei problemi, tieni presente quanto segue:
+ Troubleshoot esegue un'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'intelligenza artificiale 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)