本文へスキップ

複合ログイベント設定

ホーム > プロジェクト選択 > アラートアイコン アラート通知 > イベント設定 > 複合ログ タブ

収集したログデータを条件に合わせてフィルタリングして警告通知を設定できます。ログイベントを使用するには、ログモニタリングを有効化する必要があります。ログモニタリングの有効化については、各製品のログドキュメントを参照してください。

  • 複合ログイベント: 設定したデータ照会範囲内のログを基準に、ログ検索条件を満たすログ数が閾値以上の場合にイベントが発生します。
ノート

権限

複合メトリクスイベントを設定するには通知設定権限が必要です。 通知設定権限は、ホーム画面 > プロジェクト選択 > 管理 > 統合メンバー管理で、権限を付与するメンバーの編集アイコンアイコンをクリックして設定できます。

基本オプション​

  • 検索: イベント名またはイベント受信タグを選択して目的のイベントを検索

  • JSONダウンロード/アップロード: イベントルールはJSONエディタで直接編集するか、ファイルにダウンロードして修正後に再アップロード可能

  • 通知メッセージ設定: 受信するメッセージの詳細項目を選択し、項目ごとに内容を編集

  • + イベント追加: 新しいログイベントを追加

    表 | 複合ログイベント一覧構成
    項目説明
    イベント名通知タイトルとして使用されるイベント名
    テンプレート複合ログテンプレート
    カテゴリログ分類名（ログフォルダ名）
    ルールイベントが発生する条件
    イベント状態が解消されたら追加通知CriticalとWarningレベルのイベントが解消されたとき、正常（RECOVERED）状態の通知を受信するかどうか
    - 有効: 進行中 → 正常状態に移行したときRECOVERED通知を送信し、イベント履歴で進行中/解消状態を区別して確認可能
    - 無効: 閾値を超えるたびに単発のイベントが発生
    イベント発生一時停止イベント通知発生後、同じイベントの発生を一定時間停止
    - 選択可能時間: 使用しない、5分、10分、15分、20分、30分、1時間、2時間、3時間、6時間、12時間、1日
    - 解消通知が有効な場合、正常（RECOVERED）状態の通知受信後、選択した時間中は同じイベントが発生しても通知されない
    インターバルログデータを照会する時間範囲
    イベント受信タグイベント通知を受け取るユーザーまたはグループ（受信タグ）
    編集アイコンイベントの編集と削除
    トグル無効アイコンイベントの有効化状態
    - 有効: 条件を満たすとイベント発生
    - 無効: イベントが動作せず、条件をチェックしない

イベント設定​

設定したデータ照会範囲内のログを基準に、ログ検索条件を満たすログ数が閾値以上の場合に警告通知を設定できる機能です。

複合ログイベントの追加​

  1. アラート通知 > イベント設定の複合ログ タブをクリックしてください。

  2. 画面右側の [ + イベント追加 ] ボタンをクリックしてください。

  3. イベントルール追加ウィンドウでログイベント条件を設定してください。詳細については、基本設定、詳細設定、追加設定を参照してください。

    複合ログイベントの追加

  4. イベントルール追加ウィンドウで設定が完了したら、[ 保存 ] ボタンをクリックしてください。

基本設定​

  • イベント名: イベントタイトルとして使用する名前を入力してください。

  • イベント有効化: トグルボタンを有効にすると、条件を満たしたときにイベントが発生します。

  • レベル: イベントレベル（Critical、Warning、Info）を選択してください。

詳細設定​

テンプレート（プリセット）、メッセージ、カテゴリ、フィルター、イベント発行条件を設定します。

テンプレート（プリセット）​

定義済みのプリセットを選択すると、フィルター、クエリタイプ、イベント発行条件が自動的に設定されます。プリセットを選択後、必要に応じて変更できます。

複合ログテンプレートの種類
プリセットクエリタイプデフォルトルール
使用しないnonerows > 10
2xxステータスコード件数countcount > 10
3xxステータスコード件数countcount > 10
4xxステータスコード件数countcount > 10
5xxステータスコード件数countcount > 10
正常ステータスコード(2xx, 3xx)件数count_v2include_minus_exclude_count > 10
エラーステータスコード(4xx, 5xx)件数count_v2include_minus_exclude_count > 10
エラー受信件数countcount > 10
例外受信件数countcount > 10
毎秒ログ発生件数rpsrps > 100
フィールド集計（Aggregation）aggravg > 1000
比率（Rate）raterate > 10
ユニーク値数（Cardinality）cardinalitycardinality > 100
パーセンタイル（Percentile）percentilep99 > 3000
メッセージ​

イベント発生時に受け取る通知メッセージを入力してください。メッセージに変数を使用して動的なメッセージを構成できます。

  • 例示: メッセージ ${host}でエラー${count}件発生 → 通知メッセージ web-01でエラー15件発生
表 | メッセージ変数
変数説明使用条件
${count}条件に一致するログ件数常に使用可能
${groupField}グループ化フィールド名グループ化通知のみ
${groupValue}グループ化フィールド値グループ化通知のみ
${フィールド名}グループ化フィールド値（フィールド名で直接参照）グループ化通知のみ
ノート

${count}変数はグループ化の有無に関わらず、すべての通知で使用できます。${groupField}、${groupValue}、${フィールド名}変数はグループ化フィールドが設定されている場合のみ置換されます。

カテゴリ​

ログ分類名（ログフォルダ名）をリストから選択するか、直接入力してください。カテゴリを選択してから検索キーと検索値を入力できます。

フィルター​

Luceneクエリ構文でログ検索条件を入力します。2種類の入力モードをサポートします。

  • フィルターモード クエリ検索アイコン: フィールドと値を選択してクエリを構成します。

  • コードモード クエリ検索アイコン: Luceneクエリを直接入力します。

    表 | Luceneクエリ例
    クエリ説明
    level:ERRORlevelフィールドがERRORのログ
    status_nxx:status_4xx OR status_nxx:status_5xx4xxまたは5xxステータスコード
    appender:accessLogaccessLog appenderのログ
    response_time.n:*response_time.nフィールドが存在するログ
    host:web-01 AND level:ERRORweb-01ホストのエラーログ
イベント発行条件​

クエリタイプ別に設定します。選択したテンプレート（プリセット）またはクエリタイプに応じて、追加設定項目が表示されます。

表 | イベント発行条件キーの意味
キー意味
rows / countフィルター条件に一致するログ件数
rps毎秒ログ発生件数（件数 / インターバル秒）
avg対象フィールド値の平均
sum対象フィールド値の合計
min対象フィールド値の最小値
max対象フィールド値の最大値
rate分子件数 / 分母件数 × 100（%）
cardinality対象フィールドのユニーク値数
p99 / p95 / p90 / p75 / p50対象フィールドのパーセンタイル値
include_minus_exclude_count含むフィルター件数 - 除外フィルター件数

  • 件数（count / none）: 設定したフィルター条件に一致するログの件数をカウントします。

    表 | 件数設定項目
    設定項目説明
    フィルターログ検索条件（Luceneクエリ）
    イベント発行条件件数 または 条件に一致するログ {演算子} {閾値}（例: count > 10）

  • 毎秒ログ発生件数（rps）: 設定したフィルター条件に一致するログの毎秒発生件数（Requests Per Second）を計算します。インターバル時間中の総件数をインターバル秒数で割って算出します。

    表 | 毎秒ログ発生件数設定項目
    設定項目説明
    フィルターログ検索条件（Luceneクエリ）
    イベント発行条件RPS {演算子} {閾値}（例: rps > 0.5）

  • フィールド集計（aggr）: 指定した数値フィールドの集計値（平均、合計、最小値、最大値）を計算します。イベント発行条件で集計方式をドロップダウンから選択できます。

    表 | フィールド集計設定項目
    設定項目説明
    フィルターログ検索条件（Luceneクエリ）
    対象フィールド集計対象の数値フィールド（例: response_time.n）
    イベント発行条件平均/合計/最小値/最大値 {演算子} {閾値}（例: avg > 1000）

  • 比率（rate）: 分子フィルターと分母フィルターの件数比率（%）を計算します。全ログに対する特定条件の比率を監視する際に有用です。

    表 | 比率設定項目
    設定項目説明
    フィルター（分子）比率計算の分子となるログ条件（例: level:ERROR）
    分母フィルター比率計算の分母となるログ条件（例: level:*）
    イベント発行条件比率（%） {演算子} {閾値}（例: rate > 10）
    • 例示: フィルター level:ERROR、分母フィルター level:*、ルール rate > 10 → 全ログ中のエラー比率が10%を超えると通知が発生

  • ユニーク値数（cardinality）: 指定したフィールドのユニーク値数を計算します。異常に多くの種類の値が発生する場合を検出する際に有用です。

    表 | ユニーク値数設定項目
    設定項目説明
    フィルターログ検索条件（Luceneクエリ）
    対象フィールドユニーク値を計算するフィールド（例: host）
    イベント発行条件ユニーク値数 {演算子} {閾値}（例: cardinality > 100）

  • パーセンタイル（percentile）: 指定した数値フィールドのパーセンタイル値を計算します。レスポンスタイムのテールレイテンシを監視する際に有用です。パーセンタイルの選択を変更すると、イベント発行条件のキーが自動的に更新されます。

    表 | パーセンタイル設定項目
    設定項目説明
    フィルターログ検索条件（Luceneクエリ）
    対象フィールドパーセンタイルを計算する数値フィールド（例: response_time.n）
    パーセンタイルP99、P95、P90、P75、P50から選択
    イベント発行条件P99/P95/... {演算子} {閾値}（例: p99 > 3000）
    表 | パーセンタイルの意味
    パーセンタイル意味
    P50中央値。全データの50%がこの値以下
    P75全データの75%がこの値以下
    P90全データの90%がこの値以下
    P95全データの95%がこの値以下
    P99全データの99%がこの値以下

  • 含む/除外件数（count_v2）: 含むフィルターの件数から除外フィルターの件数を引いた純件数を計算します。

    表 | 含む/除外件数設定項目
    設定項目説明
    フィルター（含む）含むログ条件（例: status_nxx:status_4xx OR status_nxx:status_5xx）
    フィルター除外除外するログ条件（例: status_nxx:status_4xx）
    分母フィルター比率計算用の分母（任意）
    イベント発行条件含む-除外件数 {演算子} {閾値}（例: include_minus_exclude_count > 10）
    • 例示: フィルター status_nxx:status_4xx OR status_nxx:status_5xx、フィルター除外 status_nxx:status_4xx → 4xx+5xxから4xxを除いた純5xx件数が10を超えると通知が発生
グループ化フィールド（Group By）​

グループ化フィールドを設定すると、そのフィールドの値ごとに独立して通知条件が判定されます。ドロップダウンからグループ化するフィールドを選択します。ドロップダウンをクリックすると、現在のカテゴリで使用可能なフィールド一覧がオートコンプリートで表示されます。

  • 例示: フィルター level:ERROR、グループ化フィールド host、ルール rows > 3

    表 | グループ化設定の比較
    項目グループ化なしグループ化あり
    判定単位全ログを1つに集計グループ値ごとに独立して集計
    通知発生1件条件を満たすグループ数分
    通知タイトルイベントタイトル[グループ値] イベントタイトル
    Stateful全体基準での状態遷移グループごとに独立した状態遷移

    • [web-01] エラー通知 — web-01でエラー8件 → 通知発生

    • [web-02] エラー通知 — web-02でエラー5件 → 通知発生

    • [api-01] エラー通知 — api-01でエラー2件 → 条件未達、通知なし

    ノート

    イベント状態が解消されたら追加通知を有効にした場合、グループごとに独立してABNORMAL → RECOVERED状態が遷移します。例えばweb-01のエラーが解消されると[web-01] RECOVERED通知が発生し、他のホストの状態には影響しません。

追加設定​

  • インターバル: 選択した時間（unset、1分、5分、10分、30分、1時間、12時間）間隔で通知条件を確認します。

  • 無音: イベント発生後、選択した時間（unset、1分、5分、10分、30分、1時間、12時間）中は同じイベントが発生しません。

  • イベント動作時間: 特定の時間帯（業務/非業務/メンテナンス時間など）にイベントが動作するようにタグを設定してください。タグを設定しない場合、イベントが有効な状態で24時間常時動作します。

    1. + 追加をクリックしてください。
    2. イベント動作時間で**+新しいタグを作成**をクリックしてください。
    3. イベント動作時間タグの作成でタグ名、曜日、時間、色を選択し、[ 適用 ] ボタンをクリックしてください。
    4. 作成したタグはタグリストで確認でき、チェックボックスを選択すると適用されます。
    5. 変更または削除するタグの編集アイコンアイコンをクリックして、イベント動作時間タグの編集でタグを編集または削除できます。
    注意

    タグを削除すると、そのタグが適用されているすべてのユーザーのタグが削除されます。ただし、イベントルールで使用中のタグは削除できません。

  • イベント受信タグ: イベントに受信タグを設定すると、そのタグを持つプロジェクトメンバーに通知が送信されます。受信タグを設定しない場合、プロジェクト内のすべてのユーザーに通知が送信されます。

    1. + タグ追加または+をクリックしてください。
    2. イベント受信タグウィンドウ下部の**+ 新しいタグを作成**をクリックしてください。
    3. タグ作成ウィンドウでタグ名を入力し、色を選択してから、[ タグ作成 ] ボタンをクリックしてタグを作成してください。
    4. 作成されたタグはタグリストの編集アイコンアイコンをクリックして編集または削除してください。
    5. イベント受信タグウィンドウのタグリストから目的のタグを選択すると適用されます。
    Tips

    イベント設定時にイベント受信タグを選択して、そのタグを持つプロジェクトメンバーとサードパーティプラグインに通知を送信できます。アラート通知 > 通知設定でプロジェクトメンバーとサードパーティプラグインにそれぞれタグを指定できます。

シミュレーション​

通知を保存する前に、過去のデータでシミュレーションして通知発生予測件数を確認できます。

  1. 通知設定を完了後、下部の時間範囲を選択してください。

  2. [ シミュレーション ] ボタンをクリックしてください。

  3. チャートに時間帯別データと通知発生回数が表示されます。

    ノート

    シミュレーション時間範囲を調整して、さまざまな時間帯の通知発生パターンを確認できます。直近1〜2分のデータはインデックスビルド遅延により照会されない場合があります。

  4. イベントルール追加ウィンドウで設定が完了したら、[ 保存 ] ボタンをクリックしてください。

ログエクスプローラーから通知を作成​

ログエクスプローラーから直接通知を作成できます。

  1. ログ > ログ検索メニューに移動してください。

  2. カテゴリと検索クエリを設定してください。

  3. 画面右上の [ イベント追加 ] ボタンをクリックしてください。

  4. Drawerで通知設定フォームが開き、現在のカテゴリと検索クエリが自動的に入力されます。

  5. 追加設定を完了し、[ 保存 ] ボタンをクリックしてください。

  6. 保存完了後、[ 移動 ] ボタンをクリックすると通知一覧に移動します。

イベントの編集/削除​

  1. アラート通知 > イベント設定の複合ログタブに移動してください。

  2. ログイベントリストで編集または削除するイベントの編集アイコンアイコンをクリックしてください。

  3. イベント設定画面でオプションを変更し、[ 保存 ] ボタンをクリックしてください。

    a. 選択したイベントを削除するには、イベント設定画面の右上の [ 削除 ] ボタンをクリックしてください。

イベントの共有​

メトリクスイベント設定を JSON ファイルとして保存し、他のユーザーと設定を共有したり、他のユーザーの設定を取り込んだりすることができます。

  • JSON ファイル名: event-rules-YYYYMMDD.json

エクスポート

  1. 画面右上の [ JSON エクスポートアイコン ] ボタンをクリックします。
  2. JSON 編集画面が表示されたら、[ エクスポートアイコン エクスポート ] ボタンをクリックします。
    • イベントを検索した状態でエクスポート機能を使用すると、検索結果のみが JSON ファイルとしてダウンロードされます。
  3. JSON ファイルがダウンロードされたら、共有したい他のユーザーに渡してください。

インポート

  1. 画面右上の [ インポートアイコン ] ボタンをクリックします。
  2. エクスポート 機能でダウンロードした JSON ファイルを選択します。
  3. JSON 編集画面が表示されたら、[ 一覧に追加 ] または [ 上書き ] を選択します。
注意

同じ種類の製品間での利用を推奨します。異なる製品のプロジェクトからイベント設定を取り込むことは可能ですが、正常に動作しない場合があります。

JSON 形式で編集する​

  1. 画面右上の [ JSON エクスポートアイコン ] ボタンをクリックします。

  2. 編集画面が表示されたら、JSON 形式に従って内容を修正してください。

  3. 修正が完了したら、画面下部の [ 保存 ] ボタンをクリックします。

ノート

修正した内容が JSON 形式に合っていない場合、画面下部にエラーメッセージが表示され、保存できません。表示されるエラーメッセージは、形式エラーの内容によって異なる場合があります。

JSON error

最終修正：