異常検知

ホーム > プロジェクト選択 > アラート通知 > イベント設定 > 異常検知 タブ

異常検知 は、メトリクスデータが通常と異なる上昇・下降パターンを示したときにイベントを発生させる機能です。正常範囲を自動で学習する方式と、感度を直接指定する方式から選んで設定できます。

画面構成

異常検知タブはAutomatic BaselineとAdaptive Rangeの2つのセクションで構成され、セクションごとに異常の判定方式が異なります。

Section	Description
Automatic Baseline	過去データの時間帯・曜日パターンを学習し、正常範囲を自動で設定。ユーザーは対象と発生条件のみを指定
Adaptive Range	指標ごとに設定した感度（敏感・普通・鈍感）を基準に正常範囲を調整。ユーザーがカテゴリ・フィールド・フィルターとパターン感度を指定

ノート

Automatic Baselineは現在、アプリケーションモニタリング（Java、Node.js、Python、PHP、.NET、Go）でのみ提供します。

異常検知イベントは状態ベースで動作します。異常を検知すると発生通知を送信し、正常に戻ると解消通知を送信します。

基本オプション

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

• アラート通知追加: 新しい異常検知イベントを追加

• 折りたたむ: セクションを折りたたむ、または広げる

Automatic Baselineの一覧

セクションタイトル右側の 対象 は、現在設定している対象数と、プロジェクトで設定できる最大対象数を表示します（例: 2/20）。無効にしたルールも対象数に含まれます。対象数が上限に達した場合は、使用していないルールを削除して空きを作ります。

Item	Description
No.	一覧の順番
活性化	ルールの動作を切り替えるトグル。オフにしてもルールは削除されない
	ルールを修正
イベント名	ルール名
範囲	ルールを適用する単位（プロジェクト・エージェント・エージェント種類）
レベル	発生条件を設定した通知レベル（危険・警告・情報）
対象	範囲がエージェントまたはエージェント種類の場合に選択した対象。プロジェクト範囲は -
ミュート	イベント発生後、同じイベントを再度発生させない時間
受信タグ	通知を受け取る受信タグ。指定しない場合は すべて受信
	ルールを削除

プロジェクト範囲のルールは、テンプレートごとに1行が一覧に常に表示されます。ルールを設定していない行のトグルをオンにすると、デフォルト条件（危険レベル、3回連続発生）でルールが作成されます。プロジェクト行のルールを削除すると、行は残り設定のみ初期化されます。

Adaptive Rangeの一覧

Item	Description
No.	一覧の順番
活性化	ルールの動作を切り替えるトグル。オフにすると条件を検査しない
	ルールを修正
イベント名	ルール名
レベル	イベントの重要度（危険・警告・情報）
カテゴリ	異常を検知するメトリクスカテゴリ
フィールド	異常を検知する指標（メトリクスフィールド）
フィルター	異常検知の対象データの範囲を制限する条件
上昇/落下パターン	上昇パターンと下降パターンの感度
	ルールを削除

イベント設定

異常検知イベントはセクションごとに追加します。Automatic Baselineはテンプレートと対象を選び、発生条件のみを設定します。Adaptive Rangeはカテゴリ・フィールドとパターン感度を直接指定します。

Automatic Baselineルールの追加

1. Automatic Baselineセクション右上の [ アラート通知追加 ] ボタンをクリックします。

2. Automatic Baseline 画面で イベント対象の選択、基本情報と通知設定、シミュレーション を順に設定します。

3. [ 保存 ] ボタンをクリックします。

イベント対象の選択

1. 範囲 ドロップダウンで エージェント または エージェント種類 を選択します。

2. 対象 ドロップダウンでイベントを適用する対象を選択します。複数選択が可能です。

プロジェクト全体に適用するルールは、イベント追加ではなく一覧のプロジェクト行で設定します。プロジェクト行の アイコンをクリックします。

基本情報と通知設定

1. イベント活性化 トグルでルールを動作させるかどうかを設定します。

2. テンプレート ドロップダウンで検知する指標のテンプレートを選択します。現在はエラー率テンプレート（Error Rate Anomaly）を提供します。テンプレートはルール作成後に変更できません。

3. イベント名 と メッセージ を入力します。メッセージに変数を入れると、イベント発生時点の実際の値に置き換わります。

   ノート

   使用可能な変数

   • ${metricValuePer}: エラー率（%）
   • ${metricThresholdPer}: 基準線（%）
   • ${errorCount}: エラー件数
   • ${txCount}: リクエスト数
   • ${runLength}: 連続発生回数

   テンプレートごとに使用できる変数は、メッセージ入力欄横の 使用可能な変数 ツールチップで確認できます。

4. 発生回数 でレベル（危険・警告・情報）ごとの発生条件を設定します。判定は5分単位で行い、次の2つの方式から選択できます。

   • 連続 を選択すると、異常判定がn回連続したときにイベントが発生します。nは1から288の間で入力します。
   • 最近 を選択すると、指定した時間内に異常判定がn回発生したときにイベントが発生します。時間は5分から24時間の間で選択し、n × 5分より短く設定することはできません。

   条件はレベルごとに1つずつ、最大3つまで設定でき、1つ以上を有効にする必要があります。デフォルトは危険レベル3回連続（約15分）です。

5. ミュート ドロップダウンで、イベント発生後に同じイベントを再度発生させない時間を選択します。

6. 受信タグ と イベント動作時間 を設定します。設定方法は イベント受信タグ と イベント動作時間 で説明します。

シミュレーション

条件を設定した後に [ シミュレーション ] ボタンをクリックすると、過去データに条件を適用した場合の通知予想件数を確認できます。チャートにはエラー率、正常範囲からしきい値までのバンド、イベント発生区間を表示します。照会期間は最大30日です。

Adaptive Rangeルールの追加

1. Adaptive Rangeセクション右上の [ アラート通知追加 ] ボタンをクリックします。

2. イベント基本情報, メトリクス, 異常検知, 付加情報 を順に設定します。

イベント基本情報

1. イベントレベル（Critical, Warning, Info）を選択します。

   • イベントの重要度および通知レベルが決定されます。

2. イベント発生時に受信する通知メッセージを入力します。

   • メッセージ内で変数を使用すると、イベント発生時点の実際の値を含めることができます。
   ノート

   使用可能な変数

   • $pcode: プロジェクトコード
   • $category: カテゴリ
   • $field: フィールド
   • $value: 発生値
   • $oname: イベント対象

メトリクス

1. カテゴリ を選択します。

   • 異常を検知するメトリクスデータの基準となるカテゴリです。

2. イベント発生条件に使用する フィールド を選択します。複数選択が可能です。

3. イベント対象を絞り込むためのフィルターを選択します。複数選択が可能です。

異常検知

1. 上昇パターン と 下降パターン の感度を選択します。

2. 各パターンのトグルボタンをクリックして、有効または無効を切り替えます。

   • 上昇パターンのみを検知する場合: 上昇パターン ON, 下降パターン OFF

   • 下降パターンのみを検知する場合: 下降パターン ON, 上昇パターン OFF

付加情報

イベント動作時間

勤務時間、非勤務時間、点検時間など、特定の時間帯にイベントが動作するようタグを設定します。タグを設定しない場合、イベントは有効な状態で 24 時間常時動作します。

1. + 追加 をクリックします。

2. イベント動作時間 で + 新しいタグ作成 をクリックします。

3. イベント動作時間タグ作成 で タグ名、曜日、時間、色 を選択し、[ 適用 ] ボタンをクリックします。

4. 作成したタグはタグ一覧で確認でき、チェックボックスを選択すると適用されます。

5. 修正または削除するタグの をクリックし、イベント動作時間タグ修正 で編集または削除できます。

注意

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

イベント受信タグ

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

1. + タグ追加 または + をクリックします。

2. イベント受信タグ 画面下部の + 新しいタグ作成 をクリックします。

3. タグ作成 画面でタグ名を入力し、色を選択した後、[ タグ作成 ] ボタンをクリックします。

4. 作成したタグは、タグ一覧の をクリックして修正または削除できます。

5. イベント受信タグ 画面の タグ一覧 から適用したいタグを選択します。

Tips

イベント設定時にイベント受信タグを選択すると、該当タグを持つプロジェクトメンバーおよび 3rd-party プラグインに通知を送信できます。アラート通知 > 通知設定 で、それぞれにタグを割り当てることができます。

イベントの修正

1. アラート通知 > イベント設定 の 異常検知 タブに移動します。

2. 修正するルール行の アイコンをクリックします。

3. 設定画面でオプションを修正し、[ 保存 ] ボタンをクリックします。

Automatic Baselineルールは、テンプレート以外の範囲・対象・発生条件などを修正できます。

イベントの削除

1. アラート通知 > イベント設定 の 異常検知 タブに移動します。

2. 削除するルール行の アイコンをクリックします。

3. 削除確認画面で [ 削除 ] ボタンをクリックします。