本文へスキップ

プロセスグループ設定

ホーム画面 > プロジェクト選択 > 実験室 > プロセスグループ設定

プロセスグループ設定は、プロジェクトに属するサーバーごとのプロセスをパターンベースでカスタムグループ化する設定メニューです。サーバー詳細画面で個々のプロセスを1つずつグループ化する代わりに、この画面で複数のサーバーのプロセスグループを一か所で作成・管理できます。プロジェクトの修正権限またはアラート設定権限が必要です。設定したプロセスグループ名は、infra_process_groupカテゴリのnameフィールドとして収集されます。

ノート

権限の詳細については、次のドキュメントを参照してください。

プロセスグループを追加する​

  1. ホーム画面からサーバーモニタリングプロジェクトを選択してください。

  2. 実験室 > プロセスグループ設定メニューを選択してください。

  3. 画面右上の + プロセスグループ 追加ボタンをクリックしてください。

  4. グループ設定ウィンドウが開いたら、以下の項目を入力してください。

    ItemDescription
    プロセスグループ名（必須）プロセスグループ名を入力してください。$1、$2を使用すると、プロセスパターンの括弧にマッチした文字列でグループを分けられます。詳細はプロセスパターン抽出を参照してください。
    プロセスパターン（必須）グループに含めるプロセスパターンを正規表現形式で入力してください。（例：java*yard*）
    プロセス除外パターングループ化時に除外するプロセスパターンを正規表現形式で入力してください。（例：except）
    プロセスUser（必須）パターンで定義されたプロセスを実行するユーザー情報を入力してください。
    活性化グループの有効化/無効化を設定してください。無効状態でもグループを保存できます。

  5. 追加ボタンをクリックしてください。設定したパターンに該当するプロセスが1つのグループにまとめられます。

    • プロセス名は、画面に表示されるプロセス名を基準とします。

    • プロセスグループ設定は、該当プロジェクトの選択したサーバーにのみ適用されます。

    • 既存のサーバー詳細画面のグループ化で追加したグループは、プロセスグループ設定では管理できません。

プロセスパターン抽出​

プロセスグループ名に$1、$2を使用すると、プロセスパターンの括弧( )にマッチした文字列でグループ名を作成します。抽出した値ごとにグループが作成されるため、1つのルールで複数のプロセスをグループ別に分けられます。jarファイルごとにルールを作成する必要はありません。

グループ名に$数字が含まれない場合、パターン抽出は動作せず、従来どおり入力した名前で1つのグループを作成します。

情報

プロセスパターン抽出は、Linux・Windowsはエージェント2.9.27以上、Unix（AIX・HP-UX・Solaris）は1.4.18以上でサポートします。これより低いバージョンでは、入力した名前（$1など）のまま1つのグループになります。

使用例​

以下は、コマンドラインにwhatap.server.front.jarまたはwhatap.server.yard.jarを含むプロセスをグループに分ける例です。

プロセスグループ名プロセスパターン作成されるグループ
$1/whatap\.server\.(\w+)\.jarfront、yard
$1/(whatap\.server\.\w+\.jar)whatap.server.front.jar、whatap.server.yard.jar（ファイル名全体）
whatap-$1/whatap\.server\.(\w+)\.jarwhatap-front、whatap-yard
$1_svc/whatap\.server\.(\w+)\.jarfront_svc、yard_svc
$0whatap\.server\.\w+\.jarwhatap.server.front.jar、whatap.server.yard.jar（パターンにマッチした文字列全体）
$1python3? .*?([\w-]+)\.pyPythonスクリプト名ごとのグループ（例：daily_report）
$1-$2(java|python3?) .*?([\w.-]+)\.(?:jar|py)2つの括弧の組み合わせ（例：java-whatap.server.front）

記述ルール​

  • $0はパターンにマッチした文字列全体です。

  • $1、$2は、開き括弧(を左から数えた順番です。

  • (?: )はまとめるだけで、番号を付けません。

  • $12は12番目の括弧として解釈されます。$1の後に数字を続けるには、$1-2のように区切り文字を入れてください。

  • ${1}、$name、$$はサポートしません。

  • 正規表現はプロセスのコマンドライン全体を対象とし、一部のみマッチしてもマッチとみなします。

  • 大文字と小文字を区別します。

  • パターンが複数回マッチした場合は、最も左の位置でマッチした値を使用します。

動作方式​

  • 参照した括弧が存在しないか空の場合は、入力した名前（例：$1）のままグループになります。

  • 固定名ルールを先に評価し、パターン抽出ルールは後に評価します。1つのプロセスは、最初にマッチしたルール1つにのみ属します。

  • グループは1つのルールにつき最大20個、サーバーごとのパターン抽出グループは合計最大100個まで作成されます。上限を超えたプロセスは、入力した名前のまま1つのグループにまとめられます。

  • グループ名は最大128文字で、超えた部分は切り捨てられます。

  • マッチするプロセスがない場合、固定名ルールはプロセス数0として表示されますが、パターン抽出ルールは表示されません。

  • 抽出した名前が他のルールの固定名と同じ場合は、1つのグループにまとめられます。

注意事項​

  • 括弧の範囲を広く取らないでください。(.*)\.jarのように記述すると、コマンドラインの前半全体がグループ名になります。

  • 数値、日付、ポート、PIDなど、プロセスごとに異なる値は括弧で取得しないでください。プロセスごとに新しいグループが作成され、消えたグループも24時間、値が0の行として残ります。

  • 番号が不要な部分は(?: )でまとめ、括弧の番号がずれないようにしてください。

  • 繰り返される括弧は、最後にマッチした値のみが残ります。繰り返し全体を取得するには、((?:...)+)のように外側をもう一度括弧で囲んでください。

  • whatap.confを直接編集する場合は、バックスラッシュを2回入力してください（例：\\w）。サービス画面で保存すると自動的に処理されます。

グループ適用対象を指定する​

プロセスグループを適用するサーバー範囲を指定できます。個々のサーバーを1つずつ選択する方式のほかに、プロジェクト全体やOSタイプ、ホスト名パターンで対象を指定できます。

ItemDescription
全体プロジェクトに属するすべてのサーバーにグループ適用
サーバーの直接選択グループを適用するサーバーを直接選択
OSタイプパターン指定したOSタイプに該当するサーバーにグループ適用
ホスト名パターン指定したホスト名パターンに該当するサーバーにグループ適用
ノート

適用対象を指定しない場合、特定サーバー選択方式がデフォルトで使用されます。

OSタイプパターンとホスト名パターンは、正規表現ではなくワイルドカードで入力し、大文字と小文字を区別しません。複数のパターンを指定すると、そのうちいずれか1つでも一致するサーバーが対象になります。

プロセスのグループ化は、Linux・Windowsはエージェント2.9.18以上、Unix（AIX・HP-UX・Solaris）は1.4.9以上でサポートします。条件を満たさないエージェントは対象として選択できません。

マッチしたサーバーのプレビュー​

ホスト名パターンまたはOSタイプパターンで対象を指定すると、入力したパターンに実際にマッチするサーバーのリストを保存前に確認できます。パターンを入力すると、マッチしたサーバー数とサーバーリストが画面に表示されます。意図した範囲より広く、または狭く指定していないかを保存前に点検する際に使用します。

  • パターンを入力する前は案内文のみが表示され、パターンを入力するとマッチ結果に変わります。

  • ワイルドカード（*）は、1つのパターンにつき最大2つまで使用できます。3つ以上入力すると警告を表示します。

  • パターンは最大10個まで登録できます。

プロセスグループ一覧画面の検索も改善しました。適用対象を基準にグループを検索でき、有効・無効を切り替えるスイッチ列がリストの先頭に移動しました。

プロセスグループを編集する​

  1. 実験室 > プロセスグループ設定メニューを選択してください。

  2. 編集するグループの管理 編集アイコンアイコンをクリックしてください。

  3. グループ設定ウィンドウで項目を変更し、保存ボタンをクリックしてください。

プロセスグループをコピーする​

プロセスグループを1つ以上のプロジェクトに一度にコピーできます。同じグループ設定を複数のプロジェクトで再利用する際に活用します。

  1. 実験室 > プロセスグループ設定メニューを選択してください。

  2. コピーするグループを1つ以上選択すると、上部にコピーボタンが表示されます。コピーをクリックすると、プロセスグループコピーウィンドウが開きます。

  3. コピー先のプロジェクトを選択してください。現在のプロジェクトを含め、複数のプロジェクトを一度に選択できます。

  4. コピーをクリックしてください。選択したグループが、コピー先プロジェクトごとに新しいグループとして作成されます。

  • コピーは元のグループと同じグループ名で作成されます。

  • コピーは常に無効状態で作成されます。各プロジェクトで設定を確認した後、有効化してください。

  • コピー先には、設定の編集(修正)権限があるプロジェクトのみ選択できます。

  • コピーしたグループを確認・管理するには、コピー先プロジェクトでプロセスグループ設定機能が有効になっている必要があります。

  • コピー先プロジェクトに同じ名前のグループがすでに存在する場合、そのプロジェクトにはコピーされず、スキップされます。

ノート

グループ適用対象(サーバー選択)の処理

元のグループの適用対象が特定サーバー選択方式の場合、他のプロジェクトにコピーすると、選択されたサーバー一覧はコピーされません。サーバー一覧はプロジェクトごとに異なるためです。OSタイプパターンやホスト名パターンで指定した適用対象はプロジェクトに依存しないため、そのままコピーされます。

プロセスグループを削除する​

  1. 実験室 > プロセスグループ設定メニューを選択してください。

  2. 削除するグループ行の右側にある削除アイコンボタンをクリックしてください。

  3. 確認メッセージが表示されたら、削除ボタンをクリックしてください。

注意

削除したプロセスグループの過去データは保持されますが、以降の新しいデータは収集されません。

最終修正：