APMインサイトプロセス監視ルール
正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
APMインサイト自動プロファイラーは、Site24x7フルスタックエージェントをインストールすると、サーバー上で実行されているアプリケーションを自動的に検出し、適切なAPM Insightエージェントをアタッチすることで、アプリケーションパフォーマンス監視（APM）を簡素化します。これにより、Java、.NET、Python、Node.js、およびその他のサポートされている言語に対して個別のエージェントを手動でインストールして管理する必要がなくなります。
サーバーで多くのアプリケーションを実行している場合、そのすべてを監視したくない場合があります。そこで役立つのがAPMインサイトプロセス監視ルールです。
APMインサイトプロセス監視ルールとは
APM Insightプロセス監視ルールを使用すると、AutoProfilerが監視するアプリケーションを決定する条件を定義でき、環境内のAPMを完全に制御できます。設定されたルールに一致するプロセスにのみ、監視に必要なAPM Insightエージェントがアタッチされます。
プロセス監視ルールは、次のパスで設定できます：［管理］ → ［サーバー監視］ → ［APMプロセス監視ルール］。
| フィールド | 説明 |
|---|---|
| ルール名 | ルールの一意な名前です。このフィールドは必須です。 |
| カスタムアプリケーション名 | デフォルトでは、AutoProfilerは監視作成時にアプリケーション名を割り当てます。必要に応じて、このフィールドを使用してアプリケーションにカスタム名を指定できます。カスタム名はAutoProfilerによって割り当てられたデフォルト名を上書きし、［プロセスのディスカバリー］および［アプリケーション］セクションに表示されます。 |
| 説明 | ルールが監視対象とするアプリケーションプロセスの種類について簡単な説明をします。 |
| 条件数 | ルールで定義されている条件の数を表示します。 |
| 監視エージェント | ルールがeBPFまたは従来のAPM監視を使用するかどうかを示します。 |
| ルールを有効化 | ルールの有効化または無効化ができます。 |
カスタムルールはいくつでも作成できますが、一度に有効にできるルールは50個までです。
デフォルトルール
Site24x7は、一般的なアプリケーションタイプを迅速に特定するためのデフォルトのプロセス監視ルールセットを提供します。デフォルトルールの動作は次のとおりです：
- デフォルトルールは有効化または無効化できますが、編集はできません。
- デフォルトルールを複製して、カスタマイズ版を作成できます。
- ［デフォルトを表示］チェックボックスで、デフォルトルールの表示・非表示を切り替えることができます。
カスタムルール
新しいカスタムルールを作成するには、［APMプロセス監視ルールを追加］をクリックします。
- ルール名：ルールの一意な名前を入力します。
- 説明：わかりやすい説明を入力します（任意）。これらの詳細により、後でルールを簡単に特定し、管理できます。
- 監視エージェント：
- eBPF-APM：LinuxカーネルレベルでeBPFを使用したエージェントレス監視を提供します。コードの変更なしでアプリケーションを自動的に検出し、レイテンシー、スループット、エラーなどの主要なメトリクスを収集します。これにより、オーバーヘッドなしでパフォーマンスを迅速に可視化できます。Linuxでのみ利用可能です。
- 従来のAPM：完全なエージェントベースの監視で、アプリケーションコードをより深く可視化します。
APMインサイトプロセス監視条件
APM Insightプロセス監視条件を使用すると、アプリケーションプロセスを特定し、監視するための正確な基準を定義できます。1つ以上の条件を設定することで、どのプロセスを監視するかを正確に制御できます。
最大10個の条件を追加できます。それ以上追加するには、既存の条件を削除する必要があります。ルールを適用するには、設定されたすべての条件を満たす必要があり（論理AND）、正確で的を絞ったアプリケーション監視が保証されます。
条件パラメーター
| パラメーター | 説明 |
|---|---|
| コマンド | プロセスコマンドに一致します。 |
| コマンドライン | アプリケーションプロセスのコマンドライン文字列全体に一致します。 |
| ワーキングディレクトリ | アプリケーションプロセスの現在のワーキングディレクトリに一致します。 |
| IISアプリケーションプール名 | IISアプリケーションプール名に一致します（Windowsのみ）。 |
演算子
| 演算子 | 説明 |
|---|---|
| 次と一致する | 値に完全に一致します。 |
| 次と一致しない | 指定された値以外のすべての値に一致します。 |
| 次を含む | 指定された値をどこかに含む値に一致します。 |
| 次を含まない | 指定されたテキストを含まない値に一致します。 |
| 次で始まる | 指定されたテキストで始まる値に一致します。 |
| 次で終わる | 指定されたテキストで終わる値に一致します。 |
値：これは必須フィールドです。指定した値は、実際に実行されているアプリケーションプロセスに対して評価され、ルールが一致するかどうかを判断します。ルールが意図したとおりに機能するように、正しく入力してください。
条件は［+ ］ボタンで追加し、［× ］ボタンで削除できます。条件を入力した後、［保存］をクリックしてルールを適用します。カスタムルールを削除するには、［削除］をクリックします。
このページで変更を行った後、ルールを有効にするには、監視対象のアプリケーションを再起動してください。
ユースケース
アプリケーションエンジニアリングチームは、複数の環境のサーバーで同じJavaベースのサービス、payment-service.jarを実行しています。本番環境と開発環境の両方のインスタンスが同時に実行されている中で、APM Insightを使用して本番環境のインスタンスのみを監視したいと考えています。
以下は、同じアプリケーションの2つの異なるインスタンスに属するコマンドライン文字列です。1つは開発環境で実行され、もう1つは本番環境で実行されています。本番環境を監視し、開発環境は監視しないようにします。
本番環境：
java -Xms1g -Xmx2g -jar payment-service.jar -XX:+ParallelRefProcEnabled -Dspring.profiles.active=prod
開発環境：
java -Xms512m -Xmx512m -jar payment-service.jar -Dspring.profiles.active=dev
両方のプロセスは同じJavaコマンドとアプリケーションJAR（payment-service.jar）を使用しますが、コマンドラインで指定されたSpringプロファイルによって区別されます。
本番環境のインスタンスのみが監視されるようにするには、次の条件でカスタムプロセス監視ルールを作成できます：
ルール名：Payment service prod monitoring rule
設定された条件：
- コマンドがjava
- コマンドラインが-jar payment-service.jarを含む
- コマンドラインが-Dspring.profiles.active=devを含まない
このルールを有効にすると、APMインサイト 自動プロファイラーは本番環境のプロセスにのみJavaエージェントをアタッチし、開発環境のインスタンスは無視します。このようにして、監視するアプリケーションプロセスを簡単に制御し、オーバーヘッドを削減しながら正確な可視性を確保できます。