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à.

Risoluzione dei problemi

Questa sezione fornisce una guida per la risoluzione dei problemi più comuni con Transform custom. AWS

Posizioni dei log

AWS Transform CLI mantiene i log nelle seguenti posizioni:

Registri delle conversazioni:

Linux and macOS

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

Windows

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

Questi registri contengono la cronologia completa delle conversazioni per il debug di specifiche esecuzioni di trasformazione.

Log dei subagent:

Linux and macOS

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

Windows

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

Questi registri contengono l'output dei subagenti generati dall'agente principale durante le trasformazioni. Non è necessario gestire direttamente i subagenti.

Registri di debug per gli sviluppatori:

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

Questi registri forniscono informazioni dettagliate sulle operazioni e sugli errori della CLI. Ogni file di registro ha un limite di 5 MB prima del rollover. In questa directory possono essere presenti più log di debug, ad esempio debug1.log e debug2.log.

Problemi comuni

Problemi di installazione:

Se l'installazione non riesce, assicurati di aver installato Node.js 22 o versioni successive:

node --version

Effettua il download Node.js da, https://nodejs.org/en/download se necessario.

Problemi di autenticazione:

Verifica che AWS le tue credenziali siano configurate correttamente:

aws sts get-caller-identity

Assicurati che il tuo utente o ruolo IAM disponga delle transform-custom:* autorizzazioni richieste.

Problemi di connettività di rete:

Se riscontri errori di connessione, verifica l'accesso alla rete agli endpoint richiesti:

Se lavori in un ambiente con restrizioni Internet, aggiorna le regole del firewall per inserire questi URL nella lista consentita.

Problemi di configurazione della regione:

Se riscontri errori relativi alla regione:

Problemi con Git:

Assicurati che Git sia installato e che il tuo repository sia sotto il controllo del codice sorgente git:

git --version
git status

AWS Transform custom richiede che i repository siano sotto il controllo del codice sorgente git.

Problemi di esecuzione della trasformazione:

Se una trasformazione fallisce:

Problemi di ripresa della conversazione:

Se non riesci a riprendere una conversazione:

Ottenere supporto

Per ulteriore assistenza, visita l' AWS assistenza tramite la AWS console.

Quando apri un ticket di assistenza, includi:

Problemi di accesso a S3

Il servizio personalizzato AWS Transform fornisce URL prefirmati S3 per facilitare il caricamento e il download dei file di trasformazione potenzialmente grandi sui computer client. to/from Ciò significa che non solo la CLI interagisce con gli endpoint del servizio AWS Transform, ma interagisce anche con gli endpoint del servizio S3. Queste interazioni utilizzano URL prefirmati, pertanto le credenziali IAM del cliente non richiedono alcuna autorizzazione S3, ma a volte le configurazioni del server proxy del computer locale e le policy S3 VPC Endpoint della rete possono limitare questo traffico.

Esamina i messaggi di errore più dettagliati Posizioni dei log per aiutare come root a causare eventuali guasti agli strumenti o negato l'accesso a S3 in relazione al download e al caricamento dei file di trasformazione.

Se utilizzi un VPN/Proxy server che sfrutta le variabili di no_proxy ambiente https_proxy e, considera di aggiungere i seguenti valori al valore della variabile di no_proxy ambiente per bypassare il proxy per gli endpoint di servizio personalizzati S3 e AWS Transform, ad esempio:

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"

Se stai usando un AWS PrivateLink for Amazon S3 nel tuo VPC, è possibile che sia stata definita una policy per limitare il traffico S3. Assicurati che la tua policy sugli endpoint S3 VPC consenta GetObject e PutObject operi per i bucket di proprietà del servizio personalizzato Transform. AWS Ciò può essere ottenuto aggiungendo la seguente dichiarazione alla policy degli endpoint VPC:

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

DenyLe dichiarazioni esplicite nelle politiche hanno la precedenza sulle dichiarazioni. Allow Esamina le politiche di S3 VPC Endpoint per le Deny dichiarazioni che potrebbero limitare l'accesso.