ログ検知¶
本文書の位置づけ
本文書は検知ルール設定フローの 2 番目のステップです。設定完了後、メイン文書に戻りステップ 3:イベント通知を続けてください。
ログ検知機能は、ワークスペース内でログコレクターが生成するすべてのログデータを監視するために使用します。ログのキーワードに基づくアラートルールを設定することで、想定される動作と一致しない異常パターン(ログテキストに現れる異常なタグ、エラー率が高すぎるなど)を迅速に識別し、潜在的なセキュリティ脅威やシステム問題をいち早く発見して対応できます。
IT モニタリングシナリオにおけるコード異常やタスクスケジューリングの検知などに適しています。例えば、ログのエラー率が高すぎる場合の監視などです。
検知設定¶
検知頻度¶
検知を実行する時間周期を設定します。
-
プリセットオプション:1 分、5 分(デフォルト)、15 分、30 分、1 時間、6 時間、12 時間、24 時間;
-
Crontab モード:「Crontab モードに切り替え」をクリックするとカスタム周期を設定でき、秒、分、時、日、月、週などの周期に基づく定期タスクの実行状況を設定できます。
検知期間¶
各検知でクエリするデータの時間範囲を設定します(❗️検知期間は検知頻度以上である必要があり、実際のデータ報告周期と一致させることで、検知漏れや誤検知を避けてください)。
- プリセットオプション:
| 検知頻度 | 検知期間(ドロップダウン選択肢) |
|---|---|
| 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 日)。
検知メトリクス¶
DQL に基づいて検知データソースと集計方法を定義し、一定の時間範囲内で、指定した検知対象のログ一覧に設定したキーワードを含むログの件数を監視します(❗️カーディナリティの高いフィールドを検知ディメンションとして選択しないでください。設定が不適切でトリガー条件が緩すぎる場合、頻繁なアラートが発生する可能性があります。現在のクエリの最大返却件数は 10 万件です)。
設定要素¶
| 設定項目 | 説明 |
|---|---|
| インデックス | 現在の検知メトリクスが属するインデックス。複数選択できます。 ❗️ログ > インデックスでインデックスを設定した後、チャートクエリのデータソースで「ログ」を選択する際に、異なるインデックスに対応するログ内容を選択できます。デフォルトはインデックス default です |
| ソース | 現在の検知メトリクスのデータソース。すべて(*)または指定した単一のデータソースを選択できます |
| キーワード検索 | キーワード検索をサポートし、ログテキスト内の特定の内容をマッチングするために使用します |
| フィルター条件 | メトリクスのタグに基づいて検知メトリクスのデータをフィルタリングし、検知するデータ範囲を限定します。1 つまたは複数のタグフィルターを追加できます。あいまい一致およびあいまい不一致のフィルター条件をサポートします |
| 集計アルゴリズム | デフォルトでは "*" が選択され、対応する関数は count(ログ件数の統計)です。他のフィールドを選択すると、関数は自動的に count distinct(重複しないデータポイント数の取得)に変わります |
| 検知ディメンション | データ内の対応する文字列型(keyword)フィールドを検知ディメンションとして選択できます。現在、検知ディメンションは最大 3 つのフィールドまで選択できます。複数の検知ディメンションフィールドの組み合わせにより、確定的な検知対象を特定し、システムはある検知対象に対応する統計メトリクスがトリガー条件のしきい値を満たすかどうかを判定し、満たす場合はイベントを生成します。(例えば、検知ディメンションとして host と host_ip を選択した場合、検知対象は {host: host1, host_ip: 127.0.0.1} となります。)❗️検知対象が「ログ」の場合、デフォルトでは status、host、service、source、filename が検知ディメンションとなります |
| クエリ方式 | シンプルクエリと式クエリをサポートします。 ❗️クエリ方式が式クエリで複数のクエリを含む場合、ログ検知対象は同一です。例えば、式クエリ A の検知対象が「ログ」の場合、式クエリ B の検知対象も「ログ」となります |
クリックするとクエリ方式の詳細を表示できます。
トリガー条件¶
トリガー条件と重大度を設定します。クエリ結果が複数の値の場合、いずれかの値がトリガー条件を満たすとイベントが生成されます。
致命的、重大、重要、警告の 4 段階のしきい値、および正常復旧条件を設定できます。
| レベル | 設定 | 説明 |
|---|---|---|
| 致命的 | Result >= [値] の場合 |
最高レベルのアラート。即時対応が必要 |
| 重大 | Result >= [値] の場合 |
高レベルのアラート。優先的に対応が必要 |
| 重要 | Result >= [値] の場合 |
中レベルのアラート。注意が必要 |
| 警告 | Result >= [値] の場合 |
低レベルのアラート。留意が必要 |
| 正常 | [N] 回の検知でイベントが生成されない |
検知ルールの有効化後、設定したカスタム検知回数内にデータ検知結果が異常(致命的、重大、重要、警告)から正常に復旧した場合、復旧アラートイベントがトリガーされます。 ❗️復旧アラートイベントはアラートミュートの制限を受けません。復旧アラートイベントの検知回数を設定していない場合、アラートイベントは復旧せず、イベント > 未復旧イベント一覧に表示され続けます |
詳細はイベントレベルについてを参照してください。
連続トリガー判定¶
有効にすると、トリガー条件を継続的に満たした場合にのみイベントが生成され、一時的な変動による誤検知を防ぎます(❗️設定の上限は 10 回です)。
大量アラート保護¶
システムではデフォルトで有効です。
1 回の検知で生成されるアラート数がプリセットのしきい値を超えた場合、システムは自動的にステータス別集約ポリシーに切り替わります:アラート対象を個別に処理することなく、イベントステータスに基づいて少数のサマリーアラートを生成して送信します。
これにより、通知の適時性を確保しつつ、アラートノイズを大幅に削減し、アラートが多すぎることによるタイムアウトのリスクを回避できます。
このスイッチを有効にすると、以降モニターが異常を検知して生成するこの種のイベント詳細には、履歴と関連イベントが表示されなくなります。
データ欠損¶
検知メトリクスの検知期間内のクエリ結果が空の場合の処理ポリシー:
| オプション | 説明 |
|---|---|
| イベントをトリガーしない(デフォルト) | データがない場合にイベントをトリガーしません。データの欠落が許容されるシナリオに適しています。 |
| クエリ結果を 0 とみなす | 空のデータを 0 値とみなし、設定したトリガー条件に従って異常イベントを生成するかどうかの判定を続けます。 |
| データ欠損イベントをトリガー | 同一オブジェクトで欠損が発生するたびに 1 回データ欠損イベントを生成し、復旧後に再度欠損した場合は新たに生成できます。 |
| データ欠損イベントを継続的にトリガー | 同一オブジェクトが欠損条件を継続的に満たす場合、検知頻度に従ってデータが復旧するまで欠損イベントを生成します。設定方法はデータ欠損を参照してください。 |
| 致命的イベントをトリガー | データがない場合に致命的レベルのイベントをトリガーします。 |
| 重大イベントをトリガー | データがない場合に重大レベルのイベントをトリガーします。 |
| 重要イベントをトリガー | データがない場合に重要レベルのイベントをトリガーします。 |
| 警告イベントをトリガー | データがない場合に警告レベルのイベントをトリガーします。 |
| 復旧イベントをトリガー | データがない場合に復旧イベントをトリガーします。 |
イベントをトリガーするアクションを選択した後、欠損期間を入力します。検知期間の時間間隔以上(≥)に設定することを推奨します。欠損と異常条件が同時に満たされた場合、システムは欠損処理の結果を優先して適用します。
トリガー条件、データ欠損、情報生成を同時に設定した場合、トリガーの判定は以下の優先順位に従います:データ欠損 > トリガー条件 > 情報イベント生成。
つまり、まず欠損かどうかを判定し、次にしきい値に達したかどうかを判定し、最後に情報イベントを生成するかどうかを判定します。
情報生成¶
このオプションを有効にすると、情報生成条件を設定する必要があります。検知結果が「致命的」「重大」「重要」「警告」のいずれのしきい値もトリガーせず、かつ情報生成条件を満たした場合にのみ、システムは「情報」イベントを書き込みます。
正常な状態変化や低優先度の情報を記録する必要があるシナリオに適しています。
後続の設定¶
上記の検知設定が完了したら、引き続き以下を設定してください: