EC2 インスタンスから CloudWatch にメトリクスとログをプッシュするには、統合された CloudWatch エージェントをどのようにインストールおよび設定すればいいですか?

所要時間2分
0

統合された Amazon CloudWatch エージェントを使用して、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスから Amazon CloudWatch にメトリクスとログをプッシュしたいと考えています。

解決策

**注意:**開始する前に、EC2 インスタンスでインターネット接続を確立します。EC2 インスタンスには、必要なエンドポイントに接続するためのインターネット接続が必要です。

EC2 インスタンスで CloudWatch エージェントを実行するための IAM ロールを作成する

1.    AWS ID およびアクセス管理 (IAM) コンソールを開きます。

2.    ナビゲーションペインで、[ロール] を選択します。

3.    [ロールを作成] を選択します。

4.    このロールを使用するサービスを選択する場合[EC2] を選択します。

5.    [Next: Permissions] を選択します。

6.    ポリシーのリストで、[CloudWatchAgentServerPolicy] チェックボックスを選択します。

7.    [Next: Tags] を選択し、[Next: Review] を選択します。

8.    [ロール名] に、ロールの名前 CloudWatchAgentServerRole などを入力します。

9.    (オプション) ロールの説明を入力します。

10.    CloudWatchAgentServerPolicy が、ポリシーの横に表示されていることを確認します。

11.    [ロールを作成] を選択します。

12.    IAM ロールを EC2 インスタンスにアタッチします。

EC2 インスタンスに統合 CloudWatch エージェントをダウンロードおよびインストールする

Amazon Linux、Amazon Linux 2、および Amazon Linux 2023

1.    CloudWatch エージェントをダウンロードするには、次のコマンドを実行します:

wget https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/amazon_linux/amd64/latest/amazon-cloudwatch-agent.rpm

前のコマンドで、リージョン を自分の AWS リージョンに置き換えます。

2.    CloudWatch エージェントをインストールするには、次のコマンドを実行します:

sudo rpm -U ./amazon-cloudwatch-agent.rpm

Windows

1.    CloudWatch エージェントをダウンロードするには、次のコマンドを実行します:

https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/windows/amd64/latest/amazon-cloudwatch-agent.msi

前のコマンドで、リージョン を自分の AWS リージョンに置き換えます。

2.    パッケージを含むディレクトリに移動し、次のコマンドを入力します:

msiexec /i amazon-cloudwatch-agent.msi

エージェント設定ファイルの作成

注意: エージェント設定ファイルを作成するウィザードを使用します。その後、メトリクスやログを追加または削除するには、ファイルを手動で編集します。詳細については、以下の**「エージェント設定ファイルウィザードを完了するためのヒント」**セクションを参照してください。

Amazon Linux、Amazon Linux 2、および Amazon Linux 2023

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard

Windows

cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"
amazon-cloudwatch-agent-config-wizard.exe

デフォルトでは、ウィザードは、次の場所にエージェント設定ファイルを作成します: C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json

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

Amazon Linux、Amazon Linux 2、および Amazon Linux 2023

CloudWatch エージェントを起動するには、以下のコマンドを実行します:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -c file:configuration-file-path -s

**注意:**前の例では、configuration-file-path を設定ファイルパスに置き換えます。

Windows

管理者として PowerShell に次のコマンドを入力します:

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -a fetch-config -m ec2 -c file:configuration-file-path -s

**注意:**前の例では、configuration-file-path を設定ファイルパスに置き換えます。

コマンド例:

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -a fetch-config -m ec2 -c file:'C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json' -s

これで、メトリクスとログが CloudWatch にプッシュされるようになります。デフォルトでは、エージェントは、NameSpace CWAgent にメトリクスをプッシュします。

エージェント設定ファイルウィザードを設定するためのヒント

  • StatsD デーモンを有効にしますか?およびCollectD からメトリクスを監視しますか? EC2 インスタンスに StatsDCollectD プラグインがインストールされている場合は、次の質問に対して [はい] を選択します。
  • **どのデフォルトメトリクス設定を適用しますか?**詳細設定の詳細については、「CloudWatch エージェントの予め定義されたメトリクスセット」を参照してください。その後、ユースケースに最適なオプションを選択します。
  • 移行用にインポートする既存の CloudWatch Logs エージェント設定ファイルはありますか? もし awslogs エージェントがインストールおよび実行されている場合は、[はい] を選択します。[はい] を選択した場合、ウィザードは、awslogs エージェント設定ファイル (/etc/awslogs/awslogs.conf または /var/awslogs/etc/awslogs.confx) を読み取って、監視する必要のあるログファイルを決定します。
  • AWS Systems Manager の機能である [パラメータストアに設定] を保存しますか? 後からファイルを再利用するために、 [パラメータストア] にエージェント設定ファイルを保存する場合は、**[はい] **を選択します。
    重要: エージェント設定ファイルをパラメータストアに保存する場合、エージェントを起動するためのコマンドは異なります。
  • ウィザードを終了すると、エージェント設定ファイルはデフォルトで、/opt/aws/amazon-cloudwatch-agent/bin/config.json に保存されます。このファイルを手動で編集すると、メトリクスやログを追加または削除することができます。

カスタム設定ファイルの例については、「CloudWatch エージェント設定ファイル」を参照してください: 完全な例

注意: エージェント設定ファイルを変更する場合、fetch-config コマンドを使用してエージェントを起動して、変更がエージェントに反映されていることを確認します。

CloudWatch エージェントを起動および停止する

詳細については、「CloudWatch エージェントの停止および再起動」を参照してください。

AWS公式
AWS公式更新しました 7ヶ月前
コメントはありません

関連するコンテンツ