検知ルール¶
システムには豊富な検知ルールが組み込まれており、各種データのモニタリング要件に正確に一致し、誤アラートやアラート漏れを効果的に防ぎます。
設定フロー¶
モニターを作成するには、次の順序で設定を完了します:
- ルールタイプを選択:検知設定のデータ範囲とアルゴリズムロジックを決定します;
- 検知設定:タイプごとに異なる設定項目があります;
- イベント通知:イベントのタイトル、内容、関連情報、およびデータ欠損イベントの内容を定義します;
- アラート設定:通知ポリシーとミュート期間を設定します;
- 関連付け:ダッシュボードとの関連付けを設定します;
- 権限:操作権限を設定します。
「検知設定」はルールタイプによって変わりますが、イベント通知、アラート設定、関連付け、権限はすべてのルールタイプで同じ設定ロジックです。
ルールタイプ¶
監視目標に応じて、適切な検知ロジックを選択できます:
ルール名 |
データ範囲 |
基本説明 |
|---|---|---|
| しきい値検知 | すべて | 設定したしきい値に基づいてメトリクスデータの異常を検知します |
| 急変検知 | メトリクス(M) | 履歴データに基づいてメトリクスの突発的な異常挙動を検知します。主にビジネスデータや時間ウィンドウが短いシーンに適しています |
| 区間検知 | メトリクス(M) | 動的なしきい値範囲に基づいてメトリクスの異常データポイントを検知します。主にトレンドが安定した時系列に適しています |
| 区間検知 V2 | メトリクス(M) トレース(T) ユーザーアクセスデータ(R) |
動的なしきい値範囲に基づいてメトリクスの異常データポイントを検知します。主にトレンドが安定した時系列に適しています |
| 外れ値検知 | メトリクス(M) | 特定のグループ下の検知対象について、メトリクス/統計データに外れ値の偏りがあるかどうかを検知します |
| ログ検知 | ログ(L) | ログデータに基づいて業務アプリケーションの異常を検知します |
| プロセス異常検知 | プロセスオブジェクト(O::host_processes) |
定期的にプロセスデータを検知し、プロセスの異常状況を把握します |
| インフラストラクチャ稼働検知 V2 | オブジェクト(O) | インフラストラクチャオブジェクトデータに基づいて稼働条件を設定し、インフラストラクチャの安定性を監視します |
| APM 指標検知 | トレース(T) | アプリケーションパフォーマンスモニタリング(APM)データに基づいてしきい値ルールを設定し、異常状況を検知します |
| RUM 指標検知 | ユーザーアクセスデータ(R) | リアルユーザーモニタリング(RUM)データに基づいてしきい値ルールを設定し、異常状況を検知します |
| 複合検知 | すべて | 複数のモニターの結果を式で組み合わせて 1 つのモニターにし、組み合わせ後の結果に基づいてアラートを発します |
| Synthetic テスト異常検知 | Synthetic データ(D::类型) |
Synthetic モニタリングデータに基づいてしきい値ルールを設定し、異常状況を検知します |
| ネットワークデータ検知 | ネットワーク(N) | ネットワークデータに基づいてしきい値ルールを設定し、ネットワークパフォーマンスの安定性を検知します |
| 外部イベント検知 | その他 | 指定した URL アドレスを通じて、サードパーティシステムで発生した異常イベントまたは記録を POST リクエストで HTTP サーバーに送信し、イベントデータを生成します |
| インフラストラクチャ変更検知 | オブジェクト(O) | インフラストラクチャのライフサイクルを追跡し、各種変更行為を監視して、設定ドリフトや不正操作などの異常状況を正確に識別します |
| プログラマブル検知 | すべて | スクリプトで検知ルールを作成します。主にルールが多様で比較的複雑な監視シーンに適しています |
ルールタイプを選択すると、「検知設定」モジュールの選択可能なパラメータがそれに応じて変わります。イベント通知以降の設定はすべてのタイプで共通です。
検知設定¶
検知ルールのタイプごとに、対応する検知頻度、検知区間、検知メトリクスを設定できます。
検知設定はルールタイプによって大きく異なります。対応するタイプの詳細設定ドキュメントを参照してください。
データ欠損¶
データ欠損とは、識別済みの検知対象に対して継続的にデータが照会できない状態を指します。データ欠損の処理アクションを提供するモニターでは、検知設定 > データ欠損でアクションを選択し、欠損期間を入力して保存すると、以降の検知に適用されます。
データ欠損イベントを生成する必要がある場合は、次の 2 つの方法から選択できます:
| 処理アクション | イベント生成方法 |
|---|---|
| データ欠損イベントをトリガー | 同じオブジェクトの各欠損ラウンドで 1 回イベントを生成し、復旧後に再び欠損した場合は新たに生成できます。各欠損ラウンドで 1 回異常を記録するシーンに適しています。 |
| データ欠損イベントを継続的にトリガー | 同じオブジェクトが欠損条件を継続的に満たす場合、データが復旧するまで検知頻度に従ってイベントを生成します。未復旧の欠損オブジェクトを継続的に追跡するシーンに適しています。 |
欠損期間はトリガー開始条件を決定し、検知頻度は以降の検知と継続イベントの生成ペースを決定します。たとえば、欠損期間を 10 分、検知頻度を 5 分に設定した場合、10 分間の欠損条件を満たした後、以降の各検知で条件を満たすたびに 1 回イベントを生成します。検知対象ごとに個別に判定され、復旧後に再び欠損した場合は新しい処理ラウンドが開始されます。
継続方式は連続トリガー判定を有効化とは独立しています。後者は引き続き、しきい値条件を連続して満たす必要がある回数を制御します。新規作成時はデフォルトでイベントをトリガーしないが選択され、既存のモニターは保存済みのアクションに従って実行を継続します。
イベント生成後の実際の通知は、関連付けられたアラートポリシーとミュート設定によって決まります。繰り返しアラートで繰り返し通知の間隔を制御できます。ミュート期間中もイベントは記録され続け、ミュートルールに従って該当する通知が抑制されます。
データ待機ウィンドウ¶
データ待機ウィンドウはすべてのモニタータイプに適用されます。予定実行時刻に達すると、モニターは指定時間だけ待機してから検知判定を実行し、データ遅延による誤検知の可能性を低減します。
- デフォルト値は待機しないです;
- 選択可能な待機時間は 1 分、2 分、3 分、5 分、10 分、15 分、30 分です;
- 待機時間は隣接する 2 回の予定実行時刻の間隔より短くする必要があります。そうでない場合、モニターを保存できず、「データ待機ウィンドウは監視実行間隔より短くする必要があります」と表示されます。Crontab モードでも同様に、隣接する 2 回の予定実行時刻で検証されます。
たとえば、モニターが 10:00 に実行予定で、データ待機ウィンドウを 5 分に設定した場合、タスクは約 10:05 に実行を開始します。待機は実行時刻を遅らせるだけで、クエリの時間範囲は変更しません。検知区間が直近 1 時間の場合、引き続き 09:00 ~ 10:00 のデータをクエリします。
詳細な実行ロジックについては、モニターの内部原理を参照してください。
ストリーミング集約高速化¶
ストリーミング集約はモニターのクエリを高速化するために使用します。有効にすると、システムがクエリ戦略を自動選択し、条件を満たす場合にストリーミング集約を使用します。無効にすると、検知は元のクエリパスを使用します。クラウド統合メトリクスで履歴データのバックフィルがある場合は、高速化を無効にすることを推奨します。
通常のモニター、AI インテリジェントモニター、またはAI モニターを新規作成または編集する際、検知設定の末尾で高速化方式を選択でき、保存後は以降の検知に適用されます。
| 設定方式 | 適用ルール |
|---|---|
| ワークスペース設定に従う(デフォルト) | 管理 > ワークスペース設定 > モニターストリーミング集約高速化の現在の設定を使用します。ワークスペース設定を変更して保存すると、既存のモニターは以降の検知で自動的に追従し、個別に再保存する必要はありません。 |
| 個別設定 | 現在のモニターに対して個別に有効化または無効化し、ワークスペース設定より優先されます。たとえば、ワークスペース側で無効にしても、個別に有効化したモニターは引き続き自動戦略に従ってクエリします。 |
ワークスペース設定に従うモニターを他のワークスペースにインポートした後は、インポート先ワークスペースの現在の設定を使用します。
高速化を無効にすると、クエリ時間が増加する可能性があります。この設定は検知クエリのパスのみを制御します。履歴データが後から更新された場合、アラート値と事後再照会の結果に依然として差異が生じる可能性があります。
イベント通知¶
モニターのトリガー時に生成されるイベントのタイトル、内容、通知先メンバー、および関連処理を定義します。
イベントタイトル¶
アラートのトリガー条件となるイベント名を定義します。事前定義されたテンプレート変数を使用できます。
注意
最新バージョンでは、イベントタイトルを入力するとモニター名が同期して生成されます。古いモニターではモニター名とイベントタイトルが一致していない場合があるため、最新バージョンに同期することを推奨します。
イベント内容¶
イベント通知の内容を記述します。トリガー条件を満たすと、システムはこの内容を外部に送信します。通常、次の情報が含まれます:
イベント内容は構文検証とテンプレートプレビューをサポートしており、保存前に変数や条件分岐のレンダリング結果を確認できます。
関連リンク¶
+ リンクをクリックすると、システムが現在の検知メトリクスに基づいてジャンプリンクを自動生成します。リンクアドレスには、現在のドメイン、ワークスペース ID、検知時間範囲({{df_check_range_start}} ~ {{df_check_range_end}})、および動的フィルター条件が含まれます。
| リンクタイプ | 説明 | 設定要件 |
|---|---|---|
| カスタムリンク | 任意の URL をサポートし、テンプレート変数を使用できます | 完全なリンクアドレスを手動で入力する必要があります |
| 関連ログを表示 | ログエクスプローラーにジャンプします | 自動生成され、挿入後にフィルター条件と時間範囲を調整できます |
| 関連トレースを表示 | トレースエクスプローラーにジャンプします | 自動生成され、現在の trace_id またはサービス名を自動的に関連付けます |
| 関連プロファイルを表示 | プロファイルエクスプローラーにジャンプします | 自動生成され、サービス名と時間範囲を自動入力します |
| 関連コンテナを表示 | コンテナオブジェクトの詳細にジャンプします | 自動生成され、コンテナ名とホストタグを自動照合します |
| 関連 Pod を表示 | Pod オブジェクトの詳細にジャンプします | 自動生成され、Pod 名と名前空間を自動入力します |
| 関連プロセスを表示 | プロセスオブジェクトの詳細にジャンプします | 自動生成され、ホストとプロセス名を自動照合します |
| 関連セッションを表示 | RUM セッションリプレイにジャンプします | 自動生成され、Session ID を自動入力します |
| 関連ビューを表示 | RUM ビューエクスプローラーにジャンプします | 自動生成され、ビューパスを自動入力します |
| 関連エラーを表示 | RUM エラーエクスプローラーにジャンプします | 自動生成され、エラータイプと時間範囲を自動入力します |
| 関連リソースを表示 | RUM リソースエクスプローラーにジャンプします | 自動生成され、リソースパスを自動入力します |
| 関連 Synthetic モニタリングを表示 | Synthetic テストの詳細にジャンプします | 自動生成され、Synthetic テスト名を自動的に関連付けます |
| 関連ダッシュボードを表示 | 指定したダッシュボードにジャンプします | ダッシュボード ID と名前を手動で補足する必要があり、ビュー変数と時間範囲を調整できます |
リンク形式の例:
ログエクスプローラー:[関連ログを表示](<{{STUDIO_CONSOLE_BASE_URL}}/logIndi/log/all?time={{df_check_range_start}},{{df_check_range_end}}&w={{df_workspace_uuid}}>)
トレースエクスプローラー:[関連トレースを表示](<{{STUDIO_CONSOLE_BASE_URL}}/tracing/link/all?time={{df_check_range_start}},{{df_check_range_end}}&w={{df_workspace_uuid}}>)
テンプレート変数¶
+ 変数をクリックして事前定義されたテンプレート変数を挿入します。変数はイベントのトリガー時に実際の値に動的に置き換えられます:
| 変数 | 説明 |
|---|---|
{{df_dimension}} |
検知ディメンションオブジェクト |
{{df_monitor_checker_name}} |
現在のモニター名 |
{{df_monitor_name}} |
所属アラートポリシー名 |
{{Result}} |
検知結果の数値 |
{{df_status}} |
イベントステータス(error/warning/ok) |
{{df_event_id}} |
イベントの一意の識別子 |
クリックして、サポートされているすべてのテンプレート変数を表示します。
詳細設定¶
「詳細設定」では、DQL を使用してイベントに関連データのコンテキストを埋め込みます。
1. 関連ログを追加
クリックするとテンプレートが自動生成されます:
{% set dql_data = DQL("L::RE(`.*`):(`message`) { `index` = 'default' } LIMIT 1") %}
{{ dql_data.message | limit_lines(10) }}
設定のポイント:
-
{index= 'default' }を実際のインデックス名に置き換える必要があります -
RE(``.*``)は正規表現マッチをサポートします。例:RE(``error\|exception``) -
limit_lines(10)は出力行数を制限し、通知が長くなりすぎるのを防ぎます
2. 関連エラースタックを追加
クリックするとテンプレートが自動生成されます:
{% set dql_data = DQL("T::re(`.*`):(`error_message`,`error_stack`){ (`source` NOT IN ['service_map', 'tracing_stat', 'service_list_1m', 'service_list_1d', 'service_list_1h', 'profile']) AND (`error_stack` = exists()) } LIMIT 1") %}
{{ dql_data.error_message | limit_lines(10) }}
{{ dql_data.error_stack | limit_lines(10) }}
設定のポイント:
-
source NOT IN [...]は統計系の集約データを除外し、元のトレースのみを保持します -
(error_stack= exists())はスタック情報を含むエラーが返されることを保証します
通知先メンバー(@)¶
クリックしてワークスペースメンバーを選択します。
適用ロジック:
- 関連インシデントが有効な場合に限り、
@ メンバー設定が有効になり、指定メンバーにここでのイベント内容が送信されます; - この設定はアラート設定の通知先と互いに独立しており、アラート通知の範囲には影響しません。
通知内容のカスタマイズ¶
デフォルトでは、システムはイベント内容をアラート通知内容として使用します。実際に外部へ送信する通知をカスタマイズする必要がある場合は、ここでスイッチを有効にして通知情報を入力できます。
- 独立したエディターを展開し、外部へ送信する通知内容を個別に定義できます;
- 元のイベント内容は、イベント詳細の表示用としてプラットフォーム内に引き続き保持されます;
- 独立したエディターでも、Markdown、テンプレート変数、関連リンク、詳細設定を同様にサポートします。
データ欠損イベント¶
データ欠損(データ未報告)時の通知内容をカスタマイズします。この種のイベントが最終的に外部へ送信されるときのタイトル、内容などの情報を併せて設定できます。
カスタム設定がない場合、システムは公式のデフォルトテンプレートを使用して欠損アラートを送信します。
カスタマイズしたデータ欠損イベント内容も構文チェックとテンプレートプレビューをサポートし、プレビューでは現在入力されているデータ欠損のタイトルと内容が使用されます。
関連インシデント¶
関連付けを有効にすると、このモニターで異常イベントが発生した際に、インシデントが同期して作成されます。
設定項目¶
- 自動作成されたインシデントにタグを追加し、インシデントセンターでの分類・フィルタリングを容易にします;
-
イベントレベルとインシデントレベルのマッピング関係を設定します。複数のルールを追加できます。
- 致命的/重大/重要/警告/データ欠損レベルのイベントが発生した場合、新しいインシデントレベル P0/P1/P2/P3/... を同期して作成します。
ここで作成されたインシデントは、インシデントセンターで確認できます(❗️この種のインシデントにはタグのフィルター条件が含まれます)。
連携メカニズム¶
- イベントのトリガー時にインシデントセンターへインシデント記録を自動的に作成し、インシデントの説明にはイベント内容が自動的に同期されます;
- イベント内容内の @ メンバーリストに基づいて、インシデント新規作成通知を送信します;
- インシデントセンターでインシデント詳細を確認でき、システムはそのインシデントに関連するエンドツーエンドの関連データ(パフォーマンスメトリクス、エラーログ、呼び出しトレース、インフラストラクチャトポロジーなど)を自動的に関連付けて表示します。
アラート設定¶
モニターがトリガー条件を満たすと、指定された通知先にアラートメッセージを即座に送信します。
アラートポリシー¶
作成済みのアラートポリシーを選択します。複数選択できます。ポリシー名をクリックすると詳細を展開して確認でき、アラートポリシーを編集をクリックすると設定を変更できます:
| 設定項目 | 説明 |
|---|---|
| 通知設定 | このポリシーにバインドされた通知先グループ(例:全部など)を表示します |
| 繰り返しアラート | 同じイベントについて、指定時間内(例:10 分)は重複したアラート通知を送信しません |
| アラート集約 | 集約方式(例:AI 集約) |
| 集約期間 | 指定時間内(例:5 分)の新規イベントを 1 つのアラート通知に集約して送信します。期間を超えた後の新規イベントは、新しいアラート通知に集約されます |
関連付け¶
作成済みのダッシュボードを選択し、モニターとダッシュボードの関連付けを確立して、すばやくジャンプし、監視データを可視化して確認できるようにします。
権限¶
モニターの操作権限を設定し、ユーザーごとにロールと権限レベルに応じた適切な操作を保証します。現在のワークスペースの Owner は、ここでの操作権限設定の影響を受けません。
- この設定を有効にしない場合:「モニター設定管理」のデフォルト権限に従います;
- この設定を有効にし、カスタム権限対象を選択した場合:作成者と権限を付与された対象のみが、このモニターに設定されたルールの有効化/無効化、編集、削除を行えます;
- この設定を有効にしたが、カスタム権限対象を選択していない場合:作成者のみがこのモニターの有効化/無効化、編集、削除の権限を持ちます。
さらに、ワークスペース Owner は権限設定の一元管理を通じて、管理者、ロール、またはメンバーにモニター操作権限を一括付与できます。権限を付与された対象は、カスタム操作権限が有効なすべてのモニターを操作でき、各モニターのカスタム権限対象に個別に追加する必要はありません。
検知を今すぐトリガー¶
ルール設定の完了後、検知を今すぐトリガーをクリックするとテストを 1 回手動実行し、現在のルール設定全体の効果を検証できます。テスト実行では実際のアラート通知は発生しません。
アラートキャッシュ保護メカニズム¶
設定の完了後、モニターは実行期間中に次の保護ポリシーを適用します。システムは次のメカニズムにより、高基数集約による過剰な検知対象の生成がシステム負荷を引き起こすのを防ぎます:
| フェーズ | トリガー条件 | システムの動作 |
|---|---|---|
| しきい値警告 | 検知対象数がシステム制限の 80%(80,000 件)に達した場合 | システム通知をトリガーし(1 日最大 1 回)、クエリ条件とグループ設定の確認を促します |
| 上限超過保護 | 検知対象数がシステム上限の 100,000 件に達した場合 | モニターを自動的に一時停止して通知を送信し、一時停止期間中は実行を停止します |
アラートキャッシュの上限は 100,000 件、警告比率は 80% です。
一時停止からの復旧メカニズム¶
モニターがアラートキャッシュの上限超過によりシステムから一時停止された後、次のいずれかの操作を実行すると自動的に復旧します:
-
クエリ条件を変更してモニターを再保存する
-
モニターを直接再保存する
システムはアラートキャッシュのマークを自動的にクリアし、モニターの通常動作を再開します。追加の操作は不要です。
さらに読む¶
モニタールールの作成に成功した後、次の操作が必要になる場合があります:



