システムイベント

備考

プレビュー

Lakewatchは プライベート プレビュー段階です。アクセスをリクエストするには、Databricksアカウントチームにお問い合わせください。

システムイベント とは、Lakewatchがシステムの正常性または構成に関する問題を検出したときに生成されるイベントレコードです。たとえば、検出ルールが関連付けられたままのテーブルが削除された場合などです。各システムイベントは、必ず1つのシステムエラーに関連付けられ、問題の概要、関連するリソースの種類と名前（特定の検出ルールやデータソースなど）、およびエラーメッセージやスタックトレースなどの詳細が含まれます。

システムイベントを表示するには、 システムエラー に移動し、システムエラーを開いて、関連するイベントを表示します。システムイベントを直接クエリーするには、system_events システムテーブルを使用します。

システムイベントは何をTriggerしますか？

システムイベントは、Lakewatchが自動プロセス中にエラーまたは正常性の問題に遭遇したときに生成されます。一般的なシナリオは次のとおりです。

• 検出ルール実行エラー : フィルタの適用、カスタムSQLまたはカスタム関数の実行、入力ビューの生成、または出力の書き込み中にルールが失敗します。
• データソース パイプライン エラー ：データソース パイプラインが実行中に失敗するか、失敗した状態または予期しない状態になります。
• 構成の問題 ：リソース間の不一致（削除されたテーブルに関連する検出ルールがまだ存在する場合など）。
• ジョブの調整失敗 : ジョブグループ内の1つ以上のリソースが、繰り返し試行しても調整に失敗します。
• ワークスペース接続エラー ：LakewatchがAPIサーバーに到達できないか、Databricksシークレットベースの認証がハウスキーピングタスク中に失敗しました。
• メトリクス報告の失敗 : システムが検出ルールまたはデータソースのメトリクスをAPIサーバーに報告できていません。

データソースのランの失敗

データソースのランが失敗すると、Lakewatchはシステムイベント（および対応するシステムエラー）を記録します。そのresource_typeはDatasourceであり、そのresource_nameは影響を受けたデータソースを識別します。summaryとdetailsは、Lakewatchの内部サービスの詳細を公開することなく、失敗の説明（パイプラインエラーやソース接続の問題など）を示します。

調査とリカバリを行うには：

• システムエラー に移動し、データソースのエラーを開いて概要と詳細を確認するか、resource_type = 'Datasource'でフィルター処理されたsystem_eventsシステムテーブルをクエリーします。
• データソースの概要ページから、 ジョブの表示 をクリックして、実行履歴とLogの基盤となる Databricks ジョブのランを開きます。
• ソースアクセスに失敗した場合は、実行アイデンティティのソースへのアクセス権を復元してください。IDが変更されていない場合、次回のスケジュールされたランは自動的に回復します。実行アイデンティティを再割り当てするか、別の設定を変更した場合は、データソースをインラインで編集し、 保存 をクリックします。「 データソースの監視と障害からの復旧」を参照してください。

システムイベント システムテーブル

Lakewatchは、ワークスペースのシステムイベントの完全なセットを含むシステムテーブルをsystem.lakewatch.system_eventsに提供します。このテーブルをクエリーして、システムイベントの分析、システムエラーとの関連付け、カスタムレポートやダッシュボードの構築ができます。

注記

システムイベントはシステムテーブルで利用できますが、システムエラーは利用できません。

スキーマ

列	Type	説明
alert_id	STRING	システムイベントの一意の識別子。
event_time	TIMESTAMP	システムイベントが生成された時刻（UTC）。
resource_type	STRING	関与するリソースのタイプ： Datasource、 Rule、 Case、または System。
resource_name	STRING	リソースの内部名。
resource_display_name	STRING	リソースのわかりやすい表示名。
summary	STRING	問題の簡単な説明。
details	STRING	エラーメッセージやスタックトレースなど、拡張情報。
state	STRING	システムイベントの現在の状態: open、 dismissed、または exported。
filename	STRING	エラーが発生したソースファイル（該当する場合）。該当しない場合は空の文字列。
line_no	INT	該当する場合、ソースファイルの行番号。適用されない場合は-1。
grouping_id	STRING	リソースタイプ、リソース名、サマリー、イベント日のSHA-256ハッシュ。同じgrouping_idを持つシステムイベントは、同じ日の同じ問題を表します。

列	Type	説明
alert_id	STRING	システムイベントの一意の識別子。
event_time	TIMESTAMP	システムイベントが生成された時刻（UTC）。
resource_type	STRING	関与するリソースのタイプ： Datasource、 Rule、 Case、または System。
resource_name	STRING	リソースの内部名。
resource_display_name	STRING	リソースのわかりやすい表示名。
summary	STRING	問題の簡単な説明。
details	STRING	エラーメッセージやスタックトレースなど、拡張情報。
state	STRING	システムイベントの現在の状態: open、 dismissed、または exported。
filename	STRING	エラーが発生したソースファイル（該当する場合）。該当しない場合は空の文字列。
line_no	INT	該当する場合、ソースファイルの行番号。適用されない場合は-1。
grouping_id	STRING	リソースタイプ、リソース名、サマリー、イベント日のSHA-256ハッシュ。同じgrouping_idを持つシステムイベントは、同じ日の同じ問題を表します。

その他のリソース

• システムエラー