View a markdown version of this page

トラブルシューティング - AWS 変換
ログの場所一般的な問題サポート情報S3 アクセスの問題

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トラブルシューティング

このセクションでは、 AWS 変換カスタムの一般的な問題をトラブルシューティングするためのガイダンスを提供します。

ログの場所

AWS Transform CLI は、次の場所にログを保持します。

会話ログ:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/<timestamp>-conversation.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\<timestamp>-conversation.log

これらのログには、特定の変換実行をデバッグするための会話履歴がすべて含まれています。

サブエージェントログ:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/subagents/<name>.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\subagents\<name>.log

これらのログには、変換中にメインエージェントがスポーンするサブエージェントからの出力が含まれています。サブエージェントを直接管理する必要はありません。

開発者デバッグログ:

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

これらのログは、CLI オペレーションとエラーに関する詳細情報を提供します。各ログファイルには、ロールオーバー前に 5MB の制限があります。このディレクトリには、debug1.log や debug2.log など、複数のデバッグログが存在する場合があります。

一般的な問題

インストールの問題:

インストールが失敗した場合は、Node.js 22 以降がインストールされていることを確認します。

node --version

必要に応じて、https://nodejs.org/en/download から Node.js をダウンロードします。

認証の問題:

AWS 認証情報が正しく設定されていることを確認します。

aws sts get-caller-identity

IAM ユーザーまたはロールに必要なtransform-custom:*アクセス許可があることを確認します。

ネットワーク接続の問題:

接続エラーが発生した場合は、必要なエンドポイントへのネットワークアクセスを確認します。

  • transform-cli.awsstatic.com

  • transform-custom.<region>.api.aws

  • *.s3.amazonaws.com

インターネットが制限された環境で作業する場合は、ファイアウォールルールを更新してこれらの URLs。

リージョン設定の問題:

リージョン関連のエラーが発生した場合:

  • リージョンがサポートされていることを確認します。

  • 設定を上書きする可能性のある環境変数を確認します。 echo $AWS_REGION $AWS_DEFAULT_REGION

  • リージョン設定を確認します。 aws configure get region

  • 必要に応じてリージョンを更新します。 aws configure set region <your-region>

  • デバッグログでリージョン解決の詳細を確認する

Git の問題:

Git がインストールされ、リポジトリが git ソース管理下にあることを確認します。

git --version
git status

AWS 変換カスタムでは、リポジトリが git ソース管理対象である必要があります。

変換実行の問題:

変換が失敗した場合:

  1. で会話ログを確認する ~/.aws/atx/custom/<conversation_id>/logs/

  2. 変換出力でビルドまたはテストの失敗を確認する

  3. ビルドコマンドがプロジェクトに対して正しいことを確認する

  4. インタラクティブモードで変換を実行してフィードバックを提供してみてください

会話の再開に関する問題:

会話を再開できない場合:

  • 会話が 30 日未満であることを確認する

  • 会話 ID が正しいことを確認する

  • ネットワーク接続があることを確認する

サポート情報

詳細については、 AWS コンソールから AWS サポートを参照してください。

サポートチケットを開くときは、以下を含めます。

  • からの会話ログ ~/.aws/atx/custom/<conversation_id>/logs/

  • からのサブエージェントログ ~/.aws/atx/custom/<conversation_id>/logs/subagents/

  • からのログのデバッグ ~/.aws/atx/logs/

  • 問題を再現するステップ

  • AWS 変換 CLI バージョン (atx --version)

S3 アクセスの問題

AWS Transform カスタムサービスは S3 の署名付き URLs を提供し、クライアントマシンとの間で大きな変換ファイルのアップロードとダウンロードを容易にします。つまり、 CLI は AWS Transform サービスエンドポイントとやり取りするだけでなく、S3 サービスエンドポイントともやり取りします。これらのやり取りでは署名付き URLs を使用するため、クライアントの IAM 認証情報に S3 アクセス許可は必要ありませんが、ローカルマシンのプロキシサーバー設定やネットワークの S3 VPC エンドポイントポリシーによってこのトラフィックが制限されることがあります。

変換ファイルのダウンロードとアップロードに関連するツールの障害や S3 アクセス拒否の根本原因となる詳細なエラーメッセージログの場所については、「」を参照してください。

https_proxy 環境変数と no_proxy環境変数を活用する VPN/プロキシサーバーを使用している場合は、no_proxy環境変数値に次の値を追加して S3 のプロキシをバイパスし、カスタムサービスエンドポイントを AWS 変換することを検討してください。次に例を示します。

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"

VPC で AWS Amazon S3 用の PrivateLink を使用している場合、S3 トラフィックを制限するようにポリシーが定義されている可能性があります。S3 VPC エンドポイントポリシーで AWS 、変換カスタムサービス所有バケットの GetObjectおよび PutObjectオペレーションが許可されていることを確認してください。これは、VPC エンドポイントポリシーに次のステートメントを追加することで実現できます。

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

ポリシーの明示的なDenyステートメントは、 Allowステートメントよりも優先されます。アクセスを制限している可能性があるDenyステートメントについては、S3 VPC エンドポイントポリシーを確認してください。