アプリケーションパフォーマンス指標検知¶
本文書の位置づけ
本文書は、検知ルール設定フローの 2 番目のステップです。設定完了後、メイン文書に戻りステップ 3:イベント通知に進んでください。
データ範囲:トレース(T)。ワークスペース内の APM の主要指標データをモニタリングするために使用します。システムは指定された期間内の条件に一致するトレース数を集計し、カスタムしきい値を超えた場合に異常イベントをトリガーします。
検知設定¶
検知頻度¶
検知を実行する時間周期を設定します。
-
プリセットオプション:1 分、5 分、10 分、15 分、30 分、1 時間
-
Crontab モード:「Crontab モードに切り替える」をクリックするとカスタム周期を設定でき、秒、分、時、日、月、週などの周期に基づいて定期タスクの実行スケジュールを設定できます。
検知区間¶
各検知でクエリするデータの時間範囲を設定します(❗️検知区間は検知頻度以上とし、実際のデータ報告周期と一致させる必要があります。検知漏れや誤検知を避けるためです)。
| 検知頻度 | 検知区間(ドロップダウン選択肢) |
|---|---|
| 30s | 1m/5m/15m/30m/1h/3h |
| 1m | 1m/5m/15m/30m/1h/3h |
| 5m | 5m/15m/30m/1h/3h |
| 15m | 15m/30m/1h/3h/6h |
| 30m | 30m/1h/3h/6h |
| 1h | 1h/3h/6h/12h/24h |
| 6h | 6h/12h/24h |
| 12h | 12h/24h |
| 24h | 24h |
- カスタム形式:検知区間をカスタム入力できます。例:
20m(直近 20 分)、2h(直近 2 時間)、1d(直近 1 日)。
検知指標¶
検知データの指標を設定します。次の 2 つの検知モードをサポートします:
-
サービス指標
-
トレース統計
注意
検知ディメンションには高カーディナリティフィールドを選択しないでください。設定が不適切でトリガー条件が緩すぎる場合、頻繁なアラートが発生する可能性があります。現在、クエリの最大返却件数は 10 万レコードです。
サービス指標¶
現在のワークスペース内の APM サービスを監視します。
| 設定項目 | 説明 |
|---|---|
| サービス | 現在のワークスペース内の APM サービスを選択します。「すべて」または特定のサービスを選択できます |
| 指標 | 具体的な検知指標には、リクエスト数、エラーリクエスト数、リクエストエラー率、1 秒あたりの平均リクエスト数、平均レスポンスタイム、P50 レスポンスタイム、P75 レスポンスタイム、P90 レスポンスタイム、P99 レスポンスタイムが含まれます |
| フィルター条件 | 指標のタグに基づいて検知データをフィルターし、検知範囲を限定します。1 つ以上のタグフィルターを追加でき、あいまい一致とあいまい不一致のフィルター条件をサポートします |
| 検知ディメンション | 設定データ内の対応する文字列型(keyword)フィールドを検知ディメンションとして選択できます。現在、最大 3 つのフィールドを選択できます。複数の検知ディメンションフィールドの組み合わせにより、特定の検知対象(例:{service: svc1, host: host1})を特定できます |
| 追加情報 | イベント内容を豊富にするために、追加表示するフィールド情報を選択します |
トレース統計¶
指定された期間内の条件に一致するトレース(Span)数を集計し、カスタムしきい値を超えた場合に異常イベントをトリガーします。サービストレースの異常エラー通知に使用できます。
| 設定項目 | 説明 |
|---|---|
| ソース | 統計対象のトレースデータソース(サービス)を選択します。キーワード入力によるフィルターをサポートします |
| フィルター条件 | タグでトレース span をフィルターし、検知するデータ範囲を限定します。1 つ以上のタグフィルター条件を追加できます |
| 集計アルゴリズム | デフォルトでは「*」が選択され、対応する集計関数は count(Span 数をカウント)です。他のフィールドを選択すると、集計関数は自動的に count distinct(キーワードが出現するデータポイント数を取得、つまり重複排除集計)に変わります |
| 検知ディメンション | 設定データ内の対応する文字列型(keyword)フィールドを検知ディメンションとして選択できます。現在、最大 3 つのフィールドを選択できます。複数の検知ディメンションフィールドの組み合わせにより、特定の検知対象を特定できます |
トリガー条件¶
トリガー条件と重大度を設定します。クエリ結果が複数値の場合、いずれかの値がトリガー条件を満たすとイベントが生成されます。
致命的、重大、重要、警告の 4 段階のしきい値と、正常の復旧条件を設定できます。
| レベル | 設定 | 説明 |
|---|---|---|
| 致命的 | Result >= [値] の場合 |
最高レベルのアラート。直ちに対応が必要 |
| 重大 | Result >= [値] の場合 |
高レベルのアラート。優先的に対応が必要 |
| 重要 | Result >= [値] の場合 |
中レベルのアラート。注意が必要 |
| 警告 | Result >= [値] の場合 |
低レベルのアラート。留意が必要 |
| 正常 | [N] 回の検知でイベントが発生しない |
検知指標が「致命的」「重大」「重要」「警告」の異常イベントをトリガーした後、連続 N 回の検知がすべて正常であれば「正常」イベントを生成します。異常イベントが復旧したかどうかを判定するために使用します。設定を推奨します |
詳細は、イベントレベル説明を参照してください。
詳細オプション¶
連続トリガー判定¶
有効にすると、トリガー条件を継続的に満たした場合にのみイベントを生成し、一時的な変動による誤検知を防ぎます(❗️設定上限は最大 10 回です)。
大量アラート保護¶
システムではデフォルトで有効です。
1 回の検知で生成されるアラート数が事前設定のしきい値を超えると、システムは自動的にステータス別集約戦略に切り替えます:アラート対象を 1 つずつ処理するのではなく、イベントステータスに基づいて少数のサマリーアラートを生成して通知します。
これにより通知の適時性を確保しつつ、アラートノイズを大幅に削減し、大量のアラート処理によるタイムアウトのリスクを回避できます。
このスイッチが有効な場合、以降モニターが異常を検知して生成するこの種のイベント詳細には、履歴と関連イベントが表示されません。
復旧条件¶
復旧条件と重大度を設定します。クエリ結果が複数値の場合、いずれかの値がトリガー条件を満たすと復旧イベントが生成されます。
レベルごとに独立した復旧しきい値を設定し、段階的復旧を実現します。例えば、重大アラートは値が 70 以下に低下すると復旧し、重要アラートは 80 以下で復旧できます。
デフォルトの復旧ロジック
レベル別復旧条件の設定を有効にしていない場合、デフォルトでは検知結果がトリガー条件を満たさなくなると自動的に復旧します。
データ欠損¶
検知指標の検知区間内のクエリ結果が空の場合の処理戦略:
| オプション | 説明 |
|---|---|
| イベントをトリガーしない(デフォルト) | データがない場合にアラートを生成しません。データ欠損を許容するシナリオに適しています |
| クエリ結果を 0 とみなす | 空のデータを 0 値とみなしてしきい値判定を行います |
| データ欠損イベントをトリガーする | 同一オブジェクトで各検知ラウンドの欠損が発生するたびにデータ欠損イベントを 1 回生成し、復旧後に再度欠損した場合は新たに生成できます。 |
| データ欠損イベントを継続的にトリガーする | 同一オブジェクトが欠損条件を継続的に満たす場合、検知頻度に従って欠損イベントを生成し、データが復旧するまで続けます。設定方法はデータ欠損を参照してください。 |
| 致命的イベントをトリガーする | データがない場合に致命的レベルのイベントをトリガーします |
| 重大イベントをトリガーする | データがない場合に重大レベルのイベントをトリガーします |
| 重要イベントをトリガーする | データがない場合に重要レベルのイベントをトリガーします |
| 警告イベントをトリガーする | データがない場合に警告レベルのイベントをトリガーします |
| 復旧イベントをトリガーする | データがない場合に復旧イベントをトリガーします |
トリガー条件、データ欠損、情報生成を同時に設定した場合、次の優先順位でトリガーを判定します:データ欠損 > トリガー条件 > 情報イベント生成。
つまり、最初に欠損かどうかを判定し、次にしきい値をトリガーするかどうかを判定し、最後に情報イベントを生成するかどうかを判定します。
情報生成¶
このオプションを有効にすると、情報生成条件を設定する必要があります。検知結果が「致命的」「重大」「重要」「警告」のいずれのしきい値もトリガーせず、かつ情報生成条件を満たす場合にのみ、システムは「情報」イベントを書き込みます。
正常な状態変化や優先度の低い情報を記録する必要があるシナリオに適しています。
後続の設定¶
上記の検知設定を完了したら、引き続き次の設定を行ってください: