CodeDeploy エージェントログを に送信する CloudWatch

エージェント CodeDeploy メトリクスとログデータは、統合 CloudWatch エージェント を使用するか、より単純に CloudWatch エージェント CloudWatch を使用して に送信できます。

エージェントをインストールし、 CloudWatch エージェントで使用するように設定するには、以下の手順に従います CodeDeploy。

前提条件

開始する前に、以下のタスクを完了します。

• CodeDeploy エージェントをインストールし、実行されていることを確認します。詳細については、「 CodeDeploy エージェントをインストールする」および「 CodeDeploy エージェントが実行されていることを確認します。」を参照してください。

• CloudWatch エージェントをインストールします。詳細については、 CloudWatch 「 エージェントのインストール」を参照してください。

• CodeDeploy IAM インスタンスプロファイルに次のアクセス許可を追加します。

  • CloudWatchLogsFullAccess

  • CloudWatchAgentServerPolicy

  CodeDeploy インスタンスプロファイルの詳細については、ステップ 4: Amazon IAMインスタンスのEC2インスタンスプロファイルを作成する「」の「」を参照してくださいの開始方法 CodeDeploy。

CodeDeploy ログを収集するように CloudWatch エージェントを設定する

CloudWatch エージェントを設定するには、ウィザードをステップスルーするか、設定ファイルを手動で作成または編集します。

ウィザードを使用して CloudWatch エージェントを設定するには (Linux)

1. CloudWatch 「エージェント設定の実行ウィザード」の説明に従ってウィザードを実行します。

2. ウィザードで、Do you want to monitor any log files? と表示されたら、1 と入力します。

3. エージェント CodeDeploy ログファイルを次のように指定します。

   1. には、 CodeDeploy ログファイルのパスLog file pathを入力します。例: /var/log/aws/codedeploy-agent/codedeploy-agent.log。

   2. Log group name には、ロググループ名 (例: codedeploy-agent-log) を入力します。

   3. Log stream name には、ログストリーム名 (例: {instance_id}-codedeploy-agent-log) を入力します。

4. Do you want to specify any additional log files? と表示されたら、1 と入力します。

5. エージェント CodeDeploy デプロイログを次のように指定します。

   1. には、 CodeDeploy デプロイログファイルのパスLog file pathを入力します。例: /opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log。

   2. Log group name には、ロググループ名 (例: codedeploy-agent-deployment-log) を入力します。

   3. Log stream name には、ログストリーム名 (例: {instance_id}-codedeploy-agent-deployment-log) を入力します。

6. Do you want to specify any additional log files? と表示されたら、1 と入力します。

7. CodeDeploy エージェントアップデーターログを次のように指定します。

   1. Log file path には、 CodeDeploy アップデーターログファイルのパスを入力します。例: /tmp/codedeploy-agent.update.log。

   2. Log group name には、ロググループ名 (例: codedeploy-agent-updater-log) を入力します。

   3. Log stream name には、ログストリームの名前 (例: {instance_id}-codedeploy-agent-updater-log) を入力します。

ウィザードを使用して CloudWatch エージェントを設定するには (Windows)

1. CloudWatch 「エージェント設定の実行ウィザード」の説明に従ってウィザードを実行します。

2. ウィザードで、Do you want to monitor any customized log files? と表示されたら、1 と入力します。

3. 次のように CodeDeploy ログファイルを指定します。

   1. Log file path には、パス と CodeDeploy エージェントログファイルを入力します。例: C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt。

   2. Log group name には、ロググループ名 (例: codedeploy-agent-log) を入力します。

   3. Log stream name には、ログストリーム名 (例: {instance_id}-codedeploy-agent-log) を入力します。

4. Do you want to specify any additional log files? と表示されたら、1 と入力します。

5. エージェント CodeDeploy デプロイログを次のように指定します。

   1. には、 CodeDeploy デプロイログファイルのパスLog file pathを入力します。例: C:\ProgramData\Amazon\CodeDeploy\deployment-logs\codedeploy-agent-deployments.log。

   2. Log group name には、ロググループ名 (例: codedeploy-agent-deployment-log) を入力します。

   3. Log stream name には、ログストリームの名前 (例: {instance_id}-codedeploy-agent-deployment-log) を入力します。

設定ファイルを手動で作成または編集して CloudWatch エージェントを設定するには (Linux)

1. CloudWatch 「エージェント設定ファイル を手動で作成または編集する」の説明に従って、 CloudWatch エージェント設定ファイル を作成または編集します。

2. ファイル名は /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json で、次のコードが含まれていることを確認してください。

   ...
   "logs": {
       "logs_collected": {
           "files": {
               "collect_list": [
                   {
                       "file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
                       "log_group_name": "codedeploy-agent-log",
                       "log_stream_name": "{instance_id}-agent-log"
                   },
                   {
                       "file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
                       "log_group_name": "codedeploy-agent-deployment-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                   },
                   {
                       "file_path": "/tmp/codedeploy-agent.update.log",
                       "log_group_name": "codedeploy-agent-updater-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
                   }
               ]
           }
       }
   }
   ...

設定ファイルを手動で作成または編集して CloudWatch エージェントを設定するには (Windows)

1. CloudWatch 「エージェント設定ファイル を手動で作成または編集する」の説明に従って、 CloudWatch エージェント設定ファイル を作成または編集します。

2. ファイル名は C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json で、次のコードが含まれていることを確認してください。

   ...
   "logs": {
           "logs_collected": {
               "files": {
                   "collect_list": [
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
                           "log_group_name": "codedeploy-agent-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-log"
                       },
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
                           "log_group_name": "codedeploy-agent-deployment-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                       }
                   ]
               },
               ...
           }
       },
   ...

エージェントを再起動する CloudWatch

変更を加えたら、 CloudWatch 「エージェント の開始」の説明に従って CloudWatch エージェントを再起動します。