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

Standorte protokollieren

AWS Transform CLI verwaltet Protokolle an den folgenden Speicherorten:

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 Gesprächsverlauf 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 Logs enthalten Ausgaben von Subagenten, die der Hauptagent bei Transformationen erzeugt. Sie müssen die 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:

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

node --version

Laden Sie https://nodejs.org/en/download es bei 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 Netzwerkkonnektivität:

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

Wenn Sie in einer Umgebung mit eingeschränktem Internet arbeiten, aktualisieren Sie die Firewallregeln, um diese URLs zuzulassen.

Probleme mit der Konfiguration der Region:

Wenn regionsbezogene Fehler auftreten:

Probleme mit Git:

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

git --version
git status

AWS Transform custom erfordert, dass die Repositorys der Git-Quellcodeverwaltung unterliegen.

Probleme bei der Ausführung der Transformation:

Wenn eine Transformation fehlschlägt:

Probleme bei der Wiederaufnahme der Konversation:

Wenn du eine Konversation nicht fortsetzen kannst:

Supportanfragen

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

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

Probleme mit dem S3-Zugriff

Der benutzerdefinierte AWS Transform-Service verkauft vorsignierte S3-URLs, um das Hoch- und Herunterladen der potenziell großen Transformationsdateien to/from auf Client-Computern zu erleichtern. Das bedeutet, dass die CLI nicht nur mit den AWS Transform-Dienstendpunkten interagiert, sondern auch mit den S3-Dienstendpunkten. Bei diesen Interaktionen werden vorsignierte URLs verwendet, 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 überprüfen Sie die Standorte protokollieren für detailliertere Fehlermeldungen, die helfen, Toolfehler oder S3-Zugriffsverweigerungen im Zusammenhang mit dem Herunterladen und Hochladen von Transformationsdateien zu beheben.

Wenn Sie einen VPN/Proxy Server verwenden, der die Umgebungsvariablen https_proxy und no_proxy 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 in Ihrer VPC einen AWS PrivateLink für Amazon S3 verwenden, ist für diese möglicherweise eine Richtlinie zur Beschränkung des S3-Datenverkehrs definiert. Bitte stellen Sie sicher, dass Ihre S3-VPC-Endpunktrichtlinie die benutzerdefiniertenPutObject, diensteigenen AWS Transform-Buckets zulässt GetObject und 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. Überprüfen Sie die S3-VPC-Endpunktrichtlinien auf Deny Anweisungen, die den Zugriff einschränken könnten.