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.

Fehlerbehebung

Dieser Abschnitt enthält Anleitungen zur Behebung häufiger Probleme mit Transform custom. AWS

Speicherorte protokollieren

AWS Transform CLI verwaltet Protokolle an den folgenden Orten:

Konversationsprotokolle:

Linux and macOS

~/.aws/atx/custom/<conversation_id>/logs/<timestamp>-conversation.log

Windows

%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\<timestamp>-conversation.log

Diese Protokolle enthalten den vollständigen Konversationsverlauf zum Debuggen bestimmter Transformationsausführungen.

Subagent-Protokolle:

Linux and macOS

~/.aws/atx/custom/<conversation_id>/logs/subagents/<name>.log

Windows

%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\subagents\<name>.log

Diese Protokolle enthalten Ausgaben von Subagenten, die der Haupt-Agent bei Transformationen erzeugt. Sie müssen Subagenten nicht direkt verwalten.

Debug-Protokolle für Entwickler:

Linux and macOS

~/.aws/atx/logs/debug*.log
~/.aws/atx/logs/error.log

Windows

%USERPROFILE%\.aws\atx\logs\debug*.log
%USERPROFILE%\.aws\atx\logs\error.log

Diese Protokolle enthalten detaillierte Informationen zu CLI-Vorgängen und Fehlern. Jede Protokolldatei hat ein Limit von 5 MB, bevor sie übertragen wird. In diesem Verzeichnis befinden sich möglicherweise mehrere Debug-Protokolle, z. B. debug1.log und debug2.log.

Häufige Fehler

Probleme bei der Installation:

Falls die Installation fehlschlägt, stellen Sie sicher, dass Node.js 22 oder höher installiert sind:

node --version

Laden Sie bei https://nodejs.org/en/download Bedarf Node.js von herunter.

Probleme mit der Authentifizierung:

Stellen Sie sicher, dass Ihre AWS Anmeldeinformationen korrekt konfiguriert sind:

aws sts get-caller-identity

Stellen Sie sicher, dass Ihr IAM-Benutzer oder Ihre IAM-Rolle über die erforderlichen transform-custom:* Berechtigungen verfügt.

Probleme mit der Netzwerkverbindung:

Wenn Verbindungsfehler auftreten, überprüfen Sie den Netzwerkzugriff auf die erforderlichen Endpunkte:

Wenn Sie in einer Umgebung mit eingeschränktem Internetzugriff arbeiten, aktualisieren Sie die Firewallregeln, um diese URLs auf die Zulassungsliste zu setzen.

Probleme mit der Konfiguration der Region:

Wenn Sie auf regionsbezogene Fehler stoßen:

Probleme mit Git:

Stelle sicher, dass Git installiert ist und dein Repository unter der Git-Quellcodeverwaltung steht:

git --version
git status

AWS Für Transform Custom müssen sich die Repositorys unter der Git-Quellcodeverwaltung befinden.

Probleme bei der Ausführung der Transformation:

Wenn eine Transformation fehlschlägt:

Probleme bei der Wiederaufnahme der Konversation:

Wenn Sie eine Konversation nicht fortsetzen können:

Supportanfragen

Weitere Unterstützung erhalten Sie über die AWS Konsole unter AWS Support.

Wenn Sie ein Support-Ticket öffnen, geben Sie Folgendes an:

Probleme mit dem S3-Zugriff

Der benutzerdefinierte AWS Transform-Dienst stellt vorsignierte S3-URLs zur Verfügung, um das Hoch- und Herunterladen der potenziell großen Client-Computer mit Transformationsdateien to/from zu erleichtern. Das bedeutet, dass die CLI nicht nur mit den AWS Transform-Dienstendpunkten interagiert, sondern auch mit den S3-Dienstendpunkten. Diese Interaktionen verwenden vorsignierte URLs, sodass für die IAM-Anmeldeinformationen Ihres Kunden keine S3-Berechtigungen erforderlich sind. Manchmal können jedoch die Proxy-Serverkonfigurationen Ihres lokalen Computers und die S3-VPC-Endpunktrichtlinien Ihres Netzwerks diesen Datenverkehr einschränken.

Bitte schauen Sie sich die Speicherorte protokollieren detaillierteren Fehlermeldungen an, um die Ursache von Toolfehlern oder verweigerten S3-Zugriffen im Zusammenhang mit dem Herunterladen und Hochladen von Transformationsdateien zu ermitteln.

Wenn Sie einen VPN/Proxy Server verwenden, der die Umgebungsvariablen https_proxy und die no_proxy Umgebungsvariablen nutzt, sollten Sie erwägen, Ihrem no_proxy Umgebungsvariablenwert die folgenden Werte hinzuzufügen, um beispielsweise den Proxy für die benutzerdefinierten Dienstendpunkte S3 und AWS Transform zu umgehen:

Linux and macOS

export no_proxy=.s3.amazonaws.com,transform-custom.<region>.api.aws

Windows (PowerShell)

$env:no_proxy=".s3.amazonaws.com,transform-custom.<region>.api.aws"

Wenn Sie eine AWS PrivateLink für Amazon S3 in Ihrer VPC verwenden, ist für diese möglicherweise eine Richtlinie zur Einschränkung des S3-Datenverkehrs definiert. Bitte stellen Sie sicher, dass Ihre S3-VPC-Endpunktrichtlinie die Buckets im Besitz von AWS Transform Custom Service zulässt GetObject und PutObject für sie funktioniert. Dies kann erreicht werden, indem Sie Ihrer VPC-Endpunktrichtlinie die folgende Anweisung hinzufügen:

{
    "Effect": "Allow",
    "Principal": "*",
    "Action": ["s3:PutObject","s3:GetObject"],
    "Resource": "arn:aws:s3:::aws-transform-custom-*/*"
}

Explizite Deny Aussagen in Richtlinien haben Vorrang Allow vor Aussagen. Suchen Sie in den S3 VPC-Endpunktrichtlinien nach Deny Aussagen, die den Zugriff einschränken könnten.