# CloudWatch Application Insights で使用される AWS Systems Manager (SSM) ドキュメント
<a name="appinsights-ssm-documents"></a>

Application Insights は、このセクションに記載されている SSM ドキュメントを使用して、AWS Systems Manager がマネージドインスタンスで実行するアクションを定義します。これらのドキュメントでは、Systems Manager の `Run Command` 機能を使用して、Application Insights のモニタリング機能の実行に必要なタスクを自動化しています。これらのドキュメントの実行スケジュールは、Application Insights によって管理されており、変更することはできません。

SSM ドキュメントの詳細については、「AWS Systems Manager ユーザーガイド」の「[AWS Systems Manager ドキュメント](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html)」を参照してください。

## CloudWatch Application Insights によって管理されるドキュメント
<a name="ssm-documents-appinsights-managed"></a>

次の表は、Application Insights によって管理される SSM ドキュメントの一覧です。


| ドキュメント名 | 説明 | 実行スケジュール | 
| --- | --- | --- | 
|  `AWSEC2-DetectWorkload`  |  Application Insights によるモニタリング対象として設定できるアプリケーション環境で実行されているアプリケーションを自動検出します。  |  このドキュメントはアプリケーション環境で 1 時間ごとに実行され、アプリケーションに関する最新の詳細情報を取得します。  | 
|  `AWSEC2-CheckPerformanceCounterSets`  |  Amazon EC2 Windows インスタンスでパフォーマンスカウンターの名前空間が有効になっているかどうかを確認します。  |  このドキュメントはアプリケーション環境で 1 時間ごとに実行され、対応する名前空間が有効になっている場合にのみパフォーマンスカウンターのメトリクスをモニタリングします。  | 
|  `AWSEC2-ApplicationInsightsCloudwatchAgentInstallAndConfigure`  |  アプリケーションコンポーネントのモニタリング設定に基づいて、CloudWatch エージェントをインストールして設定します。  |  このドキュメントは 30 分ごとに実行され、CloudWatch エージェントの設定が常に正確で最新の状態になるようにします。また、このドキュメントは、メトリクスの追加や削除、ログ設定の更新など、アプリケーションのモニタリング設定に変更が加えられた直後にも実行されます。  | 

## AWS Systems Manager によって管理されるドキュメント
<a name="ssm-documents-aws-managed"></a>

次のドキュメントは、CloudWatch Application Insights によって使用され、Systems Manager によって管理されます。

**`AWS-ConfigureAWSPackage`**  
Application Insights はこのドキュメントを使用して、Prometheus エクスポーターディストリビューターパッケージのインストールとアンインストールを行い、ワークロード固有のメトリクスを収集し、顧客の Amazon EC2 インスタンスでワークロードを包括的にモニタリングできるようにします。CloudWatch Application Insights は、相関関係のあるターゲットワークロードがインスタンスで実行されている場合にのみ、Prometheus エクスポーターディストリビューターパッケージをインストールします。

次の表は、Prometheus エクスポーターディストリビューターパッケージと、相関関係のあるターゲットワークロードの一覧です。


| Prometheus エクスポーターディストリビューターパッケージ名 | ターゲットワークロード | 
| --- | --- | 
|  `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`  |  SAP HANA HA  | 
|  `AWSObservabilityExporter-JMXExporterInstallAndConfigure`  |  Java/JMX  | 
|  `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`  |  SAP HANA  | 
|  `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`  |  NetWeaver  | 
|  `AWSObservabilityExporter-SQLExporterInstallAndConfigure`  |  SQL サーバー (Windows) と SAP ASE (Linux)  | 

**`AmazonCloudWatch-ManageAgent`**  
Application Insights はこのドキュメントを使用して、インスタンスで CloudWatch エージェントのステータスと設定を管理し、オペレーティングシステム全体で Amazon EC2 インスタンスから内部システムレベルのメトリクスとログを収集します。