ウィザードを使用して CloudWatch エージェント設定ファイルを作成する
エージェント設定ファイルウィザード、amazon-cloudwatch-agent-config-wizard
、は以下のような一連の質問を表示します。
-
エージェントを Amazon EC2 インスタンスとオンプレミスサーバーのどちらにインストールするか。
-
サーバーで Linux と Windows Server のどちらが実行されているか。
-
エージェントがログファイルを CloudWatch Logs に送信するようにするか。持っている場合は、既存の CloudWatch Logs エージェント設定ファイルを持っているか。持っている場合、CloudWatch エージェントは、このファイルを使用してサーバーから収集するログを判別できます。
-
エージェントがログファイルを CloudWatch Logs に送信する場合、それらのログファイルを保持する必要がある期間。デフォルト値の
-1
にすると、ログアイテムは無期限に保持されるように設定されます。 -
サーバーからメトリクスを収集する場合は、デフォルトのメトリクスセットの 1 つを監視するか、収集するメトリクスのリストをカスタマイズしますか。
-
StatsD
またはcollectd
プロトコルを使用して、アプリケーションまたはサービスからカスタムメトリクスを取得しますか。 -
既存の SSM Agent から移行しますか?
ウィザードの開始前に AWS 認証方法および設定ファイルを所定の場所に置いた場合、ウィザードは使用する認証情報と AWS リージョンを自動検出できます。これらのファイルの詳細については、AWS Systems Manager ユーザーガイドの設定ファイルと認証情報ファイルを参照してください。
ウィザードでは、AWS 認証ファイルのデフォルトの認証情報を確認するとともに、次のような AmazonCloudWatchAgent
セクションを探します。
[AmazonCloudWatchAgent] aws_access_key_id =
my_access_key
aws_secret_access_key =my_secret_key
また、このウィザードには、デフォルトの認証情報、AmazonCloudWatchAgent
の認証情報、および Others
オプションが表示されます。使用する認証情報を選択することができます。Others
を選択した場合は、認証情報を入力できます。
my_access_key
および my_secret_key
で、Systems Manager Parameter Store に書き込むアクセス許可がある IAM ユーザーのキーを使用します。CloudWatch エージェントに必要な IAM ユーザーの詳細については、「オンプレミスサーバーで CloudWatch エージェントを使用するための IAM ユーザーを作成する」を参照してください。
AWS 設定ファイルで、エージェントからメトリクスを送信する先のリージョンを指定できます ([default]
セクションのリージョンと異なる場合)。デフォルトでは、Amazon EC2 インスタンスが配置されているリージョンにメトリクスが発行されます。メトリクスを別のリージョンに発行する場合は、ここでリージョンを指定します。次の例では、メトリクスを us-west-1
リージョンに発行しています。
[AmazonCloudWatchAgent] region = us-west-1
CloudWatch エージェントの事前定義されたメトリクスセット
ウィザードは、異なる詳細レベルを持つ、事前定義されたメトリクスセットで設定されます。これらのメトリクスのセットを次の表に示します。これらのメトリクスの詳細については、CloudWatch エージェントにより収集されるメトリクスを参照してください。
注記
Parameter Store では、標準とアドバンストの階層のパラメータをサポートしています。これらのパラメータ層は、これらの表で説明されているメトリクス詳細のベーシックレベル、標準レベル、アドバンストレベルとは関係ありません。
Linux を実行する Amazon EC2 インスタンス
詳細レベル | 含められるメトリクス |
---|---|
Basic (ベーシック) |
Mem: mem_used_percent Disk: disk_used_percent
|
Standard |
CPU: Disk: Diskio: Mem: Swap: |
アドバンスト |
CPU: Disk: Diskio: Mem: Netstat: Swap: |
Linux を実行しているオンプレミスサーバー
詳細レベル | 含められるメトリクス |
---|---|
Basic (ベーシック) |
Disk: Diskio: Mem: Net: Swap: |
Standard |
CPU: Disk: Diskio: Mem: Net: Swap: |
アドバンスト |
CPU: Disk: Diskio: Mem: Net: Netstat: Swap: |
Windows Server を実行する Amazon EC2 インスタンス
注記
この表に記載されているメトリクス名は、メトリクスがどのようにコンソールに表示されるかを示しています。実際のメトリクス名には、最初の単語が含まれていない場合があります。例えば、LogicalDisk % Free Space
の実際のメトリクス名は % Free Space
です。
詳細レベル | 含められるメトリクス |
---|---|
Basic (ベーシック) |
Memory: LogicalDisk: |
Standard |
Memory: Paging: Processor: PhysicalDisk: LogicalDisk: |
アドバンスト |
Memory: Paging: Processor: LogicalDisk: PhysicalDisk: TCP: |
Windows Server を実行しているオンプレミスサーバー
注記
この表に記載されているメトリクス名は、メトリクスがどのようにコンソールに表示されるかを示しています。実際のメトリクス名には、最初の単語が含まれていない場合があります。例えば、LogicalDisk % Free Space
の実際のメトリクス名は % Free Space
です。
詳細レベル | 含められるメトリクス |
---|---|
Basic (ベーシック) |
Paging: Processor: LogicalDisk: PhysicalDisk: Memory: Network Interface: |
Standard |
Paging: Processor: LogicalDisk: PhysicalDisk: Memory: Network Interface: |
アドバンスト |
Paging: Processor: LogicalDisk: PhysicalDisk: Memory: Network Interface: TCP: |
CloudWatch エージェント設定ウィザードを実行する
CloudWatch エージェント設定ファイルを作成するには
-
CloudWatch エージェント設定ウィザードを開始するには、次のように入力します。
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard
Windows Server を実行しているサーバーで、次のように入力します。
cd "C:\Program Files\Amazon\AmazonCloudWatchAgent" amazon-cloudwatch-agent-config-wizard.exe
-
質問に答えて、サーバーの設定ファイルをカスタマイズします。
-
設定ファイルをローカルに保存する場合、設定ファイル
config.json
は Linux サーバーでは/opt/aws/amazon-cloudwatch-agent/bin/
に保存され、Windows Server ではC:\Program Files\Amazon\AmazonCloudWatchAgent
に保存されます。これで、エージェントをインストールする他のサーバーにこのファイルをコピーできます。Systems Manager を使用してエージェントをインストールおよび設定する場合、ファイルを Systems Manager Parameter Store に保存するかどうかを確認するよう求められたら、必ず「Yes」と回答してください。SSM Agent を使用して CloudWatch エージェントをインストールしていない場合でも、ファイルを Parameter Store に保存することもできます。Parameter Store にファイルを保存できるようにするには、十分なアクセス権限を持つ IAM ロールを使用する必要があります。詳細については、「CloudWatch エージェントで使用する IAM ロールとユーザーを作成する」を参照してください。