翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CodeDeploy エージェントログを CloudWatch に送信する
CodeDeploy エージェントのメトリクスとログデータを CloudWatch に送信するには、[統合した CloudWatch エージェント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html)、またはより簡単に CloudWatch エージェントを使用します。
以下の手順に従って CloudWatch エージェントをインストールし、CodeDeploy エージェントで使用するように設定します。
## 前提条件
開始する前に、以下のタスクを完了します。
+ CodeDeploy エージェントをインストールし、実行されていることを確認します。詳細については、「[CodeDeploy エージェントをインストールする](codedeploy-agent-operations-install.md)」および「[CodeDeploy エージェントが実行されていることの確認](codedeploy-agent-operations-verify.md)」を参照してください。
+ CloudWatch エージェントをインストールします。詳細については、「[CloudWatch エージェントのインストール](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html)」を参照してください。
+ 次のアクセス権現を CodeDeploy IAM インスタンスプロファイルに追加します。
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
CodeDeploy インスタンスプロファイルの詳細については、[CodeDeploy の開始方法](getting-started-codedeploy.md) の「[ステップ 4: Amazon EC2 インスタンス用の IAM インスタンスプロファイルを作成する](getting-started-create-iam-instance-profile.md)」を参照してください。
## CodeDeploy ログを収集するための CloudWatch エージェントの設定
CloudWatch エージェントは、ウィザードを使用するか、設定ファイルを手動で作成または編集することで設定できます。
**ウィザードを使用して CloudWatch エージェントを設定する (Linux)**
1. 「[CloudWatch エージェント設定ウィザードを実行する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)」の説明に従ってウィザードを実行します。
1. ウィザードで、`Do you want to monitor any log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのログファイルを次のように指定します。
1. `Log file path` には、CodeDeploy ログファイルのパス (例: **/var/log/aws/codedeploy-agent/codedeploy-agent.log**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-log**) を入力します。
1. `Do you want to specify any additional log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのデプロイログを次のように指定します。
1. `Log file path` には、CodeDeploy デプロイログファイルのパス (例: **/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-deployment-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**) を入力します。
1. `Do you want to specify any additional log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのアップデータログを次のように指定します。
1. `Log file path` には、CodeDeploy アップデータログファイルのパス (例: **/tmp/codedeploy-agent.update.log**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-updater-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-updater-log**) を入力します。
**ウィザードを使用して CloudWatch エージェントを設定する (Windows)**
1. 「[CloudWatch エージェント設定ウィザードを実行する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)」の説明に従ってウィザードを実行します。
1. ウィザードで、`Do you want to monitor any customized log files?` と表示されたら、**1** と入力します。
1. CodeDeploy ログファイルを次のように指定します。
1. `Log file path` には、パスまたは CodeDeploy エージェントのログファイル (例: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-log**) を入力します。
1. `Do you want to specify any additional log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのデプロイログを次のように指定します。
1. `Log file path` には、CodeDeploy デプロイログファイルのパス (例: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**) を入力します。
1. `Log group name` には、ロググループ名 (例:**codedeploy-agent-deployment-log**) を入力します。
1. `Log stream name` には、ログストリームの名前 (例: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**) を入力します。
**設定ファイルを手動で作成または編集して CloudWatch エージェントを設定する (Linux)**
1. 「[CloudWatch エージェント設定ファイルを手動で作成または編集する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)」の説明に従って CloudWatch エージェント設定ファイルを作成または編集します。
1. ファイル名は `/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 エージェント設定ファイルを手動で作成または編集する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)」の説明に従って CloudWatch エージェント設定ファイルを作成または編集します。
1. ファイル名は `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 エージェントを起動する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet)」の説明に従って CloudWatch エージェントを再起動します。