Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Beheben Sie fehlgeschlagene Builds mit KI — Vorschau
**Vorschaufunktion**
Diese Funktion befindet sich in der Vorschauversion und kann sich ändern.
Wenn EC2 Image Builder-Builder-Builds fehlschlagen, kann es zeitaufwändig und komplex sein, die Ursache zu ermitteln. Die von AWS DevOps Agent betriebene Problembehandlungsfunktion in Image Builder automatisiert diesen Prozess mit AI-powered Analysen. Sie können schnell die Ursache komplexer Build-Fehler identifizieren oder Muster in mehreren ausgefallenen Pipelines erkennen.
Wenn ein Build fehlschlägt, können Sie Troubleshooting verwenden, um Build-Logs, CloudWatch Amazon-Logs, Workflow-Schrittausführungen und zugehörige AWS Ressourcen zu analysieren. Sie erhalten eine Ursachenanalyse und Schritte zur Behebung des Problems.
Sie können einen einzelnen fehlgeschlagenen Pipeline-Build beheben oder mehrere ausgefallene Pipelines analysieren, um gemeinsame Muster und gemeinsame Hauptursachen zu identifizieren.
**Topics**
+ [Voraussetzungen](#devops-agent-troubleshooting-prereqs)
+ [Richten Sie die Problembehandlung ein](#devops-agent-troubleshooting-setup)
+ [Beheben Sie einen fehlgeschlagenen Build](#devops-agent-troubleshooting-single)
+ [Beheben Sie mehrere ausgefallene Pipelines](#devops-agent-troubleshooting-aggregate)
+ [Was untersucht Troubleshooting](#devops-agent-troubleshooting-checks)
+ [Überlegungen](#devops-agent-troubleshooting-considerations)
## Voraussetzungen
Bevor Sie die Problembehandlungsfunktion verwenden, stellen Sie sicher, dass der von Ihnen verwendete IAM-Benutzer oder die IAM-Rolle über die folgenden Berechtigungen verfügt:
+ `aidevops:ListAgentSpaces`— Erforderlich, um verfügbare Agentenbereiche zu ermitteln.
+ `aidevops:CreateChat`— Erforderlich, um Sitzungen zur Problembehandlung zu starten.
+ `aidevops:SendChatMessage`— Erforderlich, um während der Fehlerbehebung Nachrichten zu senden.
+ `aidevops:CreateAgentSpace`— Nur erforderlich, wenn Sie möchten, dass Image Builder einen Agentenbereich für Sie erstellt. Sie können diese Genehmigung weglassen, wenn Sie Ihren eigenen Agentenbereich mitbringen.
Weitere Informationen zu IAM-Richtlinien finden Sie unter [Richtlinien und Berechtigungen in](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) IAM.
## Richten Sie die Problembehandlung ein
Für die Problembehebungsfunktion ist ein AWS DevOps Agentenbereich erforderlich. Sie können einen vorhandenen Agentenbereich verwenden oder Image Builder einen für Sie erstellen lassen:
+ **Bringen Sie Ihren eigenen Agentenbereich** mit — Wenn Sie bereits über einen Agentenbereich verfügen, verwendet Image Builder diesen für die Fehlerbehebung.
+ Lassen Sie **Image Builder einen erstellen** — Wenn Sie keinen Agentenbereich haben, erstellt und konfiguriert Image Builder einen, wenn Sie Ihre erste Untersuchung starten. Für diese Option ist die `aidevops:CreateAgentSpace` Genehmigung erforderlich.
Um mit der Problembehandlung zu beginnen, wählen Sie das **Problembehandlungssymbol** in der AWS-Managementkonsole Kopfzeile.
**Anmerkung**
Weitere Informationen zu AWS DevOps Agent finden Sie im [AWS DevOpsAgent-Benutzerhandbuch](https://docs.aws.amazon.com/devopsagent/latest/userguide/).
## Beheben Sie einen fehlgeschlagenen Build
Wenn ein Image-Build fehlschlägt, können Sie eine AI-powered Untersuchung von mehreren Einstiegspunkten im Image Builder aus starten AWS-Managementkonsole.
### Starten Sie eine Untersuchung zur Fehlerbehebung
Verwenden Sie eine der folgenden Methoden, um mit der Problembehandlung bei einem fehlgeschlagenen Build zu beginnen:
+ **Pipelines-Tabelle — Wählen Sie in der Liste der Image-Pipelines** **das Symbol „**Fehlerbehebung**“ neben dem Status einer ausgefallenen Pipeline** aus.
+ **Tabelle mit Ausgabebildern** — Wählen Sie in der **Liste der Ausgabebilder das Symbol zur Fehlerbehebung** neben einem fehlgeschlagenen Image aus.
+ Menüleiste **zur Problembehandlung** — Wählen Sie in der AWS-Managementkonsole Kopfzeile das Symbol **zur Fehlerbehebung** und anschließend die Pipeline aus, die Sie untersuchen möchten.
### Während der Untersuchung
Nachdem Sie mit der Problembehandlung begonnen haben, untersucht Troubleshooting den Fehler. In der Schublade können Sie den Fortschritt in Echtzeit verfolgen, während Protokolle und Ressourcen analysiert werden. Die Untersuchung ist in der Regel in wenigen Minuten abgeschlossen. Während die Analyse läuft, können Sie in anderen AWS-Managementkonsole Bereichen weiterarbeiten. Wenn die Untersuchung abgeschlossen ist, erhalten Sie:
+ Ursachenanalyse, die ermittelt, warum der Build fehlgeschlagen ist
+ Schritte zur Behebung des Problems
+ Befehle oder Konfigurationsänderungen zur Behebung des Problems
Nachdem Sie die Ergebnisse überprüft haben, können Sie Feedback zur Qualität der Antwort geben. Um die Analyse für denselben fehlgeschlagenen Build erneut auszuführen, wählen Sie **erneut Problembehandlung.**
## Beheben Sie mehrere ausgefallene Pipelines
Wenn Sie mehrere ausgefallene Pipelines haben, können Sie diese zusammen analysieren, um gemeinsame Muster und gemeinsame Hauptursachen zu identifizieren.
### Starten Sie eine aggregierte Untersuchung
Verwenden Sie eine der folgenden Methoden, um Fehler bei mehreren Pipelines zu beheben:
+ **Wählen Sie in der Tabelle **Image-Pipelines** mehrere ausgefallene Pipelines aus und wählen Sie Ausgewählte Problembehandlung aus.**
+ Öffnen Sie die Problembehandlungsleiste und wählen Sie Troubleshooting all aus, um **alle** ausgefallenen Pipelines zu analysieren.
### Aggregieren Sie die Analyseergebnisse
Sie erhalten eine gruppierte Analyse, die nach der Grundursache geordnet ist. Für jede Gruppe erhalten Sie:
+ Beschreibung der gemeinsamen Grundursache
+ Pipelines, die von dieser Grundursache betroffen sind
+ Schritte zur Problembehebung für die Gruppe
Nach der Gesamtanalyse können Sie eine Drilldown-Aufforderung auswählen, um eine bestimmte Pipeline genauer zu untersuchen.
## Was untersucht Troubleshooting
Bei der Fehlerbehebung bei einem fehlgeschlagenen Build deckt die Analyse die folgenden Bereiche ab:
+ **Logs und CloudWatch Amazon-Logs erstellen** — Prüft auf Fehler, Exit-Codes ungleich Null, Timeouts und Stack-Traces.
+ **Ausführungen von Workflow-Schritten** — Identifiziert den fehlgeschlagenen Schritt und untersucht seine Details.
+ **Netzwerke und Berechtigungen — Überprüft** IAM-Instanzprofilberechtigungen, Sicherheitsgruppen, Subnetz-Routing, NAT-Gateways, Internet-Gateways und VPC-Endpunkte.
+ **Komponenten und Rezeptkonfiguration** — Prüft auf Skriptfehler, fehlende Abhängigkeiten, fehlerhafte URLs und die Gültigkeit des Basis-AMIs.
+ **Netzwerkkonnektivität** — Überprüft die Erreichbarkeit des Agenten, die DNS-Auflösung und die Proxykonfiguration AWS Systems Manager (Systems Manager).
+ **Build-Verlauf** — Überprüft die letzten Builds, um zwischen anhaltenden Ausfällen und zeitweiligen Problemen zu unterscheiden.
## Überlegungen
Beachten Sie Folgendes, wenn Sie die Problembehebungsfunktion verwenden:
+ Bei der Problembehandlung wird eine schreibgeschützte Analyse durchgeführt. Ihre Ressourcen wurden nicht geändert.
+ Die Fehlerbehebung beschränkt sich auf Image Builder Builder-Build-Fehler und die zugehörige Infrastruktur wie IAM, VPC und Systems Manager Agent.
**Anmerkung**
KI generiert diese Antworten. Überprüfen Sie die Analyse und die Empfehlungen, bevor Sie Ihre Ressourcen ändern.
Weitere Informationen zur Problembehandlung bei Image Builder Builder-Pipeline-Builds finden Sie unter[Fehler bei Pipeline-Builds](troubleshooting.md#troubleshooting-pipelines).