イベントセンター¶
イベントセンターは、Guanceにおける統合イベント検索・分析プラットフォームです。モニター、インテリジェントモニタリング、SLO、セキュリティモニタリング、監査、OpenAPI など、複数のソースからイベントデータを集約し、多次元フィルタリング、詳細表示、関連分析の機能を提供します。
イベントセンターはイベントの集約と検索のみを行い、イベントの生成、ルール設定、通知送信は行いません。イベントは各ソースモジュールで個別に生成され、自動的にここに集約されます。
イベントソース¶
| ソース | 生成方法 | df_source 値 |
|---|---|---|
| モニター | モニターモジュールで検出ルールを設定し、条件を満たすとトリガー | monitor |
| インテリジェントモニタリング | AI アルゴリズムがメトリクスの異常パターンを自動検出 | smartMonitor |
| 変更イベント | Kubernetes クラスターにおける期待パターンと異なる実行アクティビティのイベントレコード | change |
| SLO | SLO モジュールでサービス品質目標を設定し、違反時にトリガー | slo |
| セキュリティチェック | セキュリティモジュールで検出された異常動作や脆弱性アラート | security |
| 監査イベント | Guanceプラットフォーム上でのユーザー操作レコード | audit |
| カスタムイベント | OpenAPI 経由で能動的に書き込み | user |
イベント内容の構成¶
イベント内容は、ソースシステムが生成時に決定します。イベントセンターは表示のみを行います。
モニターを例にとると、イベント内容はルールを作成 > イベント通知で設定したテンプレートに基づき、変数による動的補完が可能です。
| 変数（例） | 説明 | 例 |
|---|---|---|
{{Result}} |
検出結果値 | 85.5 |
{{df_dimension_tags}} |
イベントディメンション | {"host":"web01"} |
{{df_monitor_checker_name}} |
モニター名 | ホスト CPU 監視 |
システムが実際の監視データに基づいて変数を置換し、最終的なイベント内容を生成します。
下図のように、イベントタイトルを ログ検出-マルチインデックス と定義し、イベント内容に DQL クエリ文や変数が含まれる場合、システムは実際の監視データに基づいて最終結果を生成・表示します。
ルールが異常を検出した後、イベント > イベント詳細で関連するイベント内容を確認できます。
イベントフィールドリファレンス¶
共通フィールド¶
最終的なイベントレコードには通常、以下のフィールドが含まれます。
フィールド |
説明 |
|---|---|
date / timestamp |
発生時間。単位: 秒 |
df_date_range |
時間範囲。単位: 秒 |
df_check_range_start |
検出範囲の開始時間。単位: 秒 |
df_check_range_end |
検出範囲の終了時間。単位: 秒 |
df_issue_start_time |
今回の最初の障害発生時間。単位: 秒 |
df_issue_duration |
今回の障害の継続時間。単位: 秒（df_issue_start_time から本イベントまで） |
df_source |
イベントソース。monitor, user, system, custom, audit を含む |
df_status |
イベントステータス。ok, info, fatal, warning, error, critical, nodata, nodata_ok, nodata_as_ok, manual_ok を含む |
df_sub_status |
イベント詳細ステータス（df_status の補完） |
df_event_id |
イベントユニーク ID |
df_title |
タイトル |
df_message |
説明 |
モニターイベント固有フィールド¶
df_source = monitor の場合、以下のフィールドが追加で存在します。
フィールド |
説明 |
|---|---|
df_dimension_tags |
検出ディメンションラベル。例: {"host":"web01"} |
df_monitor_id |
アラートポリシー ID |
df_monitor_name |
アラートポリシー名 |
df_monitor_type |
所属タイプ: カスタムモニタリングイベントは custom、SLO イベントは slo、インテリジェントインスペクションイベントは bot_obs 固定 |
df_monitor_checker |
実行関数名。例: custom_metric など |
df_monitor_checker_sub |
検出フェーズ: データ途絶検出フェーズで生成された場合は nodata、通常検出フェーズで生成された場合は check |
df_monitor_checker_id |
モニター ID |
df_monitor_checker_name |
モニター名 |
df_monitor_checker_value |
イベント発生時の異常値 |
df_monitor_checker_value_dumps |
イベント発生時の異常値（JSON シリアライズ） 利用側でデシリアライズして元の値を取得可能 |
df_monitor_checker_value_with_unit |
イベント発生時の異常値（最適単位） |
df_monitor_checker_ref |
モニター関連。検出設定の DQL 文に関連するフィールドのみ |
df_monitor_checker_event_ref |
モニターイベント関連。df_dimension_tags と df_monitor_checker_id にのみ関連するフィールド |
df_monitor_ref_key |
セルフホストインスペクションの関連キー。セルフホストインスペクションとの対応に使用 |
df_fault_id |
今回の障害 ID。最初の障害イベントの df_event_id を値とする |
df_fault_status |
今回の障害ステータス。df_status、df_sub_status の冗長フィールドで、OK かどうかを示す。値は以下の通り。ok: 正常 fault: 障害 |
df_fault_start_time |
今回の障害の開始時間。 |
df_fault_duration |
今回の障害の継続時間。単位: 秒（df_issue_start_time から本イベントまで） |
df_event_detail |
イベント検出詳細 |
df_event_report |
インテリジェントモニタリングレポートデータ |
df_user_id |
手動復旧時、操作者のユーザー ID |
df_user_name |
手動復旧時、操作者のユーザー名 |
df_user_email |
手動復旧時、操作者のユーザーメール |
df_crontab_exec_mode |
実行モード。選択可能な値。crontab manual |
df_site_name |
現在の Guance サイト名 |
df_workspace_name |
所属ワークスペース名 |
df_workspace_uuid |
所属ワークスペース UUID |
df_label |
モニターラベル。モニターで指定したラベルがこのフィールドに格納される |
df_alert_policy_ids |
アラートポリシー ID（リスト） |
df_alert_policy_names |
アラートポリシー名（リスト） |
df_matched_alert_policy_rules |
アラートポリシー名と一致したすべてのルール名（リスト） |
df_channels |
イベントが所属するインシデントチャンネルリスト |
df_at_accounts |
@アカウント情報 |
df_at_accounts_nodata |
@アカウント情報（データ途絶時） |
df_message_at_accounts |
障害アラートメッセージ内の @ユーザー 詳細情報リスト |
df_nodata_message_at_accounts |
データ途絶アラートメッセージ内の @ユーザー 詳細情報リスト |
df_workspace_declaration |
ワークスペースの属性クレーム |
df_matched_alert_members |
メンバー送信を選択した場合、一致したすべてのアラート通知メンバー情報リスト |
df_matched_alert_upgrade_members |
メンバー送信を選択した場合、一致したすべてのアラートエスカレーション通知メンバー情報リスト |
df_matched_alert_member_groups |
メンバー送信を選択した場合、一致したすべてのメンバーグループ名 |
df_charts |
モニター設定にグラフが追加され、かつ本アラートイベントでメッセージ送信が必要な場合に追加されるグラフ情報 |
df_alert_info |
アラート通知情報を記録 |
df_is_silent |
イベントがミュートされているかどうか。文字列 "true" / "false" で指定 |
df_sent_target_types |
本イベントで送信済みの、重複しないアラート通知オブジェクトタイプリスト |
df_check_targets |
モニター設定の検出時間、検出メトリクスを記録 |
df_check_condition、df_check_condition_expr |
モニター設定のトリガールールを記録 |
df_check_rules |
モニター設定の検出回数、検出ルールを記録 |
df_check_targets |
モニター設定の検出時間、検出メトリクスを記録 |
df_check_condition |
モニター設定のトリガールールを記録 |
df_check_interval |
モニター設定の検出頻度を記録 |
df_fault_end_time |
障害復旧時間を記録 |
監査イベント固有フィールド¶
df_source = audit の場合、以下のフィールドが追加で存在します。
| フィールド | 説明 |
|---|---|
df_user_id |
操作者ユーザー ID |
df_user_name |
操作者ユーザー名 |
df_user_email |
操作者ユーザーメール |
| {その他のフィールド} | 具体的な監査データ要件に基づくその他のフィールド |
カスタムイベント固有フィールド¶
df_source = user の場合、以下のフィールドが追加で存在します。
| フィールド | 説明 |
|---|---|
df_user_id |
作成者ユーザー ID |
df_user_name |
作成者ユーザー名 |
df_user_email |
作成者ユーザーメール |
| {その他のフィールド} | ユーザー操作により発生するイベントのその他のフィールド |
イベントの検索と表示¶
イベントセンターは複数のエクスプローラーを提供し、さまざまなシナリオにおけるイベントの検索・分析ニーズに対応します。
| イベント表示ディメンション | 説明 | コア機能 |
|---|---|---|
| すべてのイベント | 全量イベント検索 | 現在のワークスペース内のすべてのソースからのイベントデータを集約表示。リスト/グラフの2つの表示モードをサポートし、多次元フィルタリング、検索、エクスポート、スナップショット保存などの機能を提供 |
| 未復旧イベント | アクティブな障害追跡 | 直近48時間以内に df_status != ok のイベントを集中表示。df_fault_id で集約し、障害継続時間を表示 |
| 変更イベント | K8s 変更監査 | Kubernetes クラスターにおける期待パターンと異なる実行アクティビティのイベントレコードを記録し、変更前後の構成差分を表示 |
| インテリジェントモニタリングイベント | AI 異常表示 | インテリジェントモニタリングアルゴリズムが検出した異常パターンイベントを表示。分析レポート、アラート通知、履歴レコードを含む |
| イベント詳細 | 単一イベントの詳細分析 | 任意のイベントをクリックして進入し、基本属性、拡張フィールド、アラート通知、履歴レコード、関連イベント、関連 SLO などの完全な情報を表示 |
関連情報¶
「イベント」という基本概念を理解した後、以下が必要になるかもしれません。