

# CloudWatch エージェントを使用してメトリクス、ログ、トレースを収集する
<a name="Install-CloudWatch-Agent"></a>

CloudWatch エージェントは、Amazon EC2 インスタンス、オンプレミスサーバー、コンテナ化されたアプリケーションからメトリクス、ログ、トレースを収集するソフトウェアコンポーネントです。このエージェントにより、デフォルトで提供される基本的なモニタリングよりもさらに包括的にインフラストラクチャとアプリケーションをモニタリングできます。

**主な利点**
+ システムレベルのメトリクス (CPU、メモリ、ディスク、ネットワーク) を収集する 
+ お使いのアプリケーションからカスタムメトリクスを収集する
+ さまざまなソースからログを収集し、一元化する
+ 単一のツールで AWS とオンプレミス環境の両方をモニタリングする 
+ 収集したデータに基づいてアラームおよび通知を設定する 

CloudWatch エージェントを使用すると、以下のことを実行できます。
+ オペレーティングシステム全体で Amazon EC2 インスタンスから内部システムレベルのメトリクスを収集します。このメトリクスには、EC2 インスタンスのメトリクスに加えて、ゲスト内メトリクスを含めることができます。収集することができる追加のメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](metrics-collected-by-CloudWatch-agent.md)」を参照してください。
+ オンプレミスサーバーからシステムレベルのメトリクスを収集します。これには、ハイブリッド環境のサーバーや AWS によって管理されていないサーバーも含まれる可能性があります。
+ カスタムメトリクスは、`StatsD` および `collectd` プロトコルを使用して、アプリケーションまたはサービスから取得します。`StatsD` は、Linux サーバーと、Windows Server を実行するサーバーの両方でサポートされています。`collectd` は、Linux サーバーでのみサポートされています。
+ Linux または Windows Server を実行している Amazon EC2 インスタンスおよびオンプレミスサーバーから､ログを収集します。
**注記**  
CloudWatch エージェントは、FIFO パイプからのログの収集をサポートしていません。
+ メトリクスを CloudWatch または Amazon Managed Service for Prometheus、またはその両方に送信します。CloudWatch エージェント設定ファイルには、`metrics` セクションに `metrics_destinations` パラメータが含まれています。このパラメータでは、`cloudwatch`、`amp`、またはその両方を指定できます。
+ バージョン 1.300031.0 以降を使用すると、CloudWatch Application Signals が使用可能になります。詳細については、「[Application Signals](CloudWatch-Application-Monitoring-Sections.md)」を参照してください。
+ バージョン 1.300025.0 以降では、[OpenTelemetry](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-opentel) または [X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-xray-sdk) クライアント SDK からトレースを収集し、それらを X-Ray に送信できます。

  CloudWatch エージェントを使用すると、別途トレース収集デーモンを実行しなくてもトレースを収集できるため、実行および管理するエージェントの数を減らすことができます。

CloudWatch に送信されたメトリクスは、他の CloudWatch メトリクスと同様に CloudWatch で表示できます。CloudWatch エージェントにより収集されるメトリクスのデフォルトの CloudWatch 名前空間は `CWAgent` ですが、エージェントを設定するときに別の名前空間を指定することもできます。

CloudWatch エージェントによって収集されたログは、古い CloudWatch Logs エージェントによって収集されたログと同様に、Amazon CloudWatch Logs に処理され、保存されます。CloudWatch Logs の料金の詳細については、[Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing)をご覧ください。

CloudWatch エージェントによって収集されたメトリクスは、カスタムメトリクスとして請求されます。CloudWatch メトリクスの料金の詳細については、「[Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing)」を参照してください。

CloudWatch エージェントは MIT ライセンスの下でオープンソースであり、[GitHub でホスト](https://github.com/aws/amazon-cloudwatch-agent/)されています。CloudWatch エージェントの構築、カスタマイズ、または貢献をご希望の場合は、最新の手順について GitHub リポジトリを参照してください。セキュリティの問題の兆候を見つけても、GitHub などの公開フォーラムに投稿しないでください。代わりに、[脆弱性レポート](https://aws.amazon.com/security/vulnerability-reporting/)または [AWS セキュリティに直接 E メールを送信する](mailto:aws-security@amazon.com)の手順に従ってください。

CloudWatch エージェントは、コマンドラインを使用して手動でダウンロードおよびインストールできます。あるいは、AWS Systems Manager と統合することもできます。CloudWatch エージェントをインストールする一般的な流れは次のとおりです。

1. IAM ロールまたはユーザーを作成し、エージェントでサーバーからメトリクスを収集するか、必要に応じて AWS Systems Manager と統合できるようにします。

1. エージェントパッケージをダウンロードします。

1. CloudWatch エージェント設定ファイルを変更して、収集するメトリクスを指定します。

1. サーバーにエージェントをインストールして起動します。

**Topics**
+ [サポートされるオペレーティングシステム](supported-operating-systems.md)
+ [前提条件](prerequisites.md)
+ [CloudWatch エージェントパッケージをダウンロードする](download-CloudWatch-Agent-on-EC2-Instance-commandline-first.md)
+ [CloudWatch エージェントパッケージの署名の検証](verify-CloudWatch-Agent-Package-Signature.md)
+ [CloudWatch エージェントのインストール](install-CloudWatch-Agent-on-EC2-Instance.md)
+ [Security-Enhanced Linux (SELinux) で CloudWatch エージェントをセットアップする](CloudWatch-Agent-SELinux.md)
+ [CloudWatch エージェント設定ファイルを作成する](create-cloudwatch-agent-configuration-file.md)
+ [CloudWatch エージェントの起動](start-CloudWatch-Agent-on-premise-SSM-onprem.md)
+ [CloudWatch エージェントにより収集されるメトリクス](metrics-collected-by-CloudWatch-agent.md)
+ [関連するテレメトリで CloudWatch エージェントの使用](CloudWatch-Agent-RelatedEntities.md)
+ [CloudWatch エージェントの一般的なシナリオ](CloudWatch-Agent-common-scenarios.md)
+ [CloudWatch エージェント認証情報の優先設定](CloudWatch-Agent-Credentials-Preference.md)
+ [CloudWatch エージェントのトラブルシューティング](troubleshooting-CloudWatch-Agent.md)