AWS CodeDeploy
ユーザーガイド (API バージョン 2014-10-06)

CodeDeploy EC2/オンプレミス デプロイのログデータの表示

CodeDeploy デプロイで作成されたログデータを表示するには、CloudWatch コンソールに集約データを表示するように Amazon CloudWatch Logs エージェントを設定するか、個別のインスタンスにログインしてログファイルを確認します。

注記

ログは、AWS Lambda や Amazon ECS デプロイではサポートされていません。EC2/オンプレミス デプロイのみに作成できます。

Amazon CloudWatch コンソールでのログファイルデータの表示

インスタンスに Amazon CloudWatch Logs エージェントがインストールされていると、そのインスタンスに対するすべてのデプロイのログデータは、CloudWatch コンソールで表示できるようになります。分かりやすいように、インスタンス別に表示するのではなく、Amazon CloudWatch Logs を使用してログファイルを集中的にモニタリングすることをお勧めします。Amazon CloudWatch ログエージェントの設定の詳細については、「CloudWatch Logs コンソールでの CodeDeploy ログの表示」を参照してください。

インスタンスでのログファイルの表示

個別のインスタンスのデプロイログデータを表示するには、インスタンスにサインインして、エラーや他のデプロイイベントに関する情報を参照します。

Amazon Linux、RHEL および Ubuntu Server の各インスタンスのデプロイログファイルを表示するには

Amazon Linux、RHEL、および Ubuntu Server の各インスタンスのデプロイログは、次の場所に保存されています。

/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log

Amazon Linux、RHEL、および Ubuntu Server の各インスタンスのデプロイログを表示または分析するには、インスタンスにサインインし、次のコマンドを入力して CodeDeploy エージェントのログファイルを開きます。

less /var/log/aws/codedeploy-agent/codedeploy-agent.log

エラーメッセージのログファイルを参照するには、次のコマンドを入力します。

コマンド 結果
& ERROR ログファイルでエラーメッセージのみを表示します。ERROR という単語の前後に 1 つのスペースを使用します。
/ ERROR 次のエラーメッセージを検索します。¹
? ERROR 前のエラーメッセージを検索します。² ERROR という単語の前後に 1 つのスペースを使用します。
G ログファイルの末尾に移動します。
g ログファイルの先頭に移動します。
q ログファイルを終了します。
h 追加のコマンドについて参照します。

¹ / ERROR と入力してから、次のエラーメッセージを検索するには、n と入力します。前のエラーメッセージを検索するには、N と入力します。

² ? ERROR と入力してから、次のエラーメッセージを検索するには n 、前のエラーメッセージを検索するには N と入力します。

また、次のコマンドを入力して CodeDeploy スクリプトのログファイルを開くこともできます。

less /opt/codedeploy-agent/deployment-root/deployment-group-ID/deployment-ID/logs/scripts.log

エラーメッセージのログファイルを参照するには、次のコマンドを入力します。

コマンド 結果
&stderr ログファイルでエラーメッセージのみを表示します。
/stderr 次のエラーメッセージを検索します。¹
?stderr 前のエラーメッセージを検索します。²
G ログファイルの末尾に移動します。
g ログファイルの先頭に移動します。
q ログファイルを終了します。
h 追加のコマンドについて参照します。

¹ /stderr と入力してから、次のエラーメッセージを前方に検索するには、n と入力します。前のエラーメッセージを後方に検索するには、 N と入力します。

² ?stderr と入力してから、次のエラーメッセージを後方に検索するには、n と入力します。前のエラーメッセージを前方に検索するには、N と入力します。

Windows Server インスタンスのデプロイログファイルを表示するには

CodeDeploy エージェントのログファイル: Windows Server インスタンスで CodeDeploy エージェントのログファイルは次の場所に保存されています。

C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt

Windows Server インスタンスで CodeDeploy エージェントのログファイルを表示または分析するには、インスタンスにサインインし、次のコマンドを入力してファイルを開きます。

notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt

ログファイルでエラーメッセージを参照するには、Ctrl+F キーを押し、ERROR [ と入力してから、Enter キーを押して最初のエラーを見つけます。

CodeDeploy スクリプトログファイル: Windows Server インスタンスのデプロイログは次の場所に保存されています。

C:\ProgramData\Amazon\CodeDeploy\deployment-group-id\deployment-id\logs\scripts.log

各パラメーターの意味は次のとおりです。

  • deployment-group-idexamplebf3a9c7a-7c19-4657-8684-b0c68d0cd3c4 などの文字列

  • deployment-id は、d-12EXAMPLE などの識別子

次のコマンドを入力して CodeDeploy スクリプトのログファイルを開きます。

notepad C:\ProgramData\Amazon\CodeDeploy\deployment-group-ID\deployment-ID\logs\scripts.log

ログファイルでエラーメッセージを参照するには、Ctrl+F キーを押し、stderr と入力してから、Enter キーを押して最初のエラーを見つけます。