知見で問題を検出して解決する
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
Insightsは、お客様が要求しなくても、Lakebaseプロジェクトのテレメトリを定期的にレビューし、問題と早期警告を提示するバックグラウンドエージェントです。このページでは、プロジェクトのInsightsを有効にし、実際の知見について、発見された内容、その重要性、および対応方法を最初から最後まで説明します。
会話型でオンデマンドな代替手段として、または知見をさらに調査するには、Genieによる問題の診断と修正を参照してください。
可観測性に対して別途料金はかかりません。そのコストは、お客様が既に使用している製品にバンドルされています。テレメトリのエクスポートは、取り込み使用量にカウントされ、LakehouseにDeltaテーブルとして保存することは、Databricksが管理するストレージにカウントされ、Genieに問い合わせることは、Genieの使用量にカウントされます。
前提条件
- AWSまたはAzure上の、稼働中のコンピュートを備えたLakebase オートスケール プロジェクト。
- テレメトリを受信するためのUnity Catalogカタログとスキーマ ( Default storage ではない)。
プロジェクトの知見を有効にする
監視構成によって制御される、プロジェクトごとの知見ラン。まだ持っていない場合は、まず作成して割り当ててください。
構成ウィザードで、 知見を有効にする がオンになっていることを確認してください。それがないと、構成は事前に何も検知することなくテレメトリーをUnity Catalogに書き込むことができます。また、知見がテレメトリーを分析する頻度について、 分析頻度 を設定することもできます。
知見を見つける
知見のランは継続的ではなく、定期的なスケジュールで実行されます。そのため、実際の課題が発生してから知見が表示されるまでに遅延が生じることをご了承ください。エージェントをオンにした後、特に新しいプロジェクトで有効にした直後は、しばらくお待ちください。
知見は2つの場所に表示されます：
- ワークスペース全体のリスト ：左側のナビゲーションで、 知見 をクリックします。これは、構成が適用されるすべてのプロジェクトで知見を集計します。絞り込むために、 検索 または フィルター を使用します。たとえば、プロジェクトや重大度で絞り込めます。
- 単一プロジェクトのビュー : プロジェクトを開き、 モニタリング に移動し、 知見 tabを選択します。そのプロジェクトの知見のみを表示します。
各行には、 重大度 (例: 軽微または中程度)、 知見 のタイトル、属する プロジェクト 、問題の対象となる 時間枠 、および設定した ステータス (例: オープン) が表示されます。
知見の読み方
知見をクリックして、その詳細ページを開きます。すべての知見は、単なる通知ではなく、診断として上から下へ読み取られる同じ構造に従います。
- 概要 — 何が起きているかを平易な言葉で説明します。
- エビデンス — 診断を裏付ける特定のシグナルと値がテーブル内にあります。
- 推奨事項 — それぞれの理由を添えた具体的な次のステップ。
知見が見つけるものと診断の表現方法は、お使いのテレメトリーに完全に依存するため、ユーザーが見る知見は以下のものと一致しません。以下は、期待できる詳細レベルを示すために含まれている実際の知見です。
例：「アイドルセッションにより4つのUPDATEがロックされました」
この知見のサブタイトル「アイドルセッションがロックを保持。UPDATE待機時間の合計は749秒」は、すでに確認すべき場所を示しています。
サマリーでは、何が起こったかを説明しています。セッションがトランザクションを開始し、行ロックを保持したままアイドル状態になり、データベース自身のアイドル・イン・トランザクション・タイムアウトによって強制的に閉じられるまで、約9.5分間その状態が続きました。エビデンステーブルは、終了ログエントリ、および通常はミリ秒単位で完了するUPDATEに対して、4回の呼び出しにわたって合計749秒のUPDATE待機時間（それぞれ平均187秒）を含む具体的な数値でそれを裏付けています。
推奨事項：
idle_in_transaction_session_timeoutを安全な値 （30～60秒など）に調整して、アイドル状態のセッションが、他のクエリーを何分もブロックすることなく、ロックを迅速に解放するようにしてください。- 未クローズのトランザクションを監査し、短いチェックアウトタイムアウトで接続プーリングを使用してください 。これにより、トランザクションを開いてアイドル状態になったクライアントが無期限にロックを保持することができなくなります。
証拠が何を定量化しているかに注目してください。「クエリーが遅かった」だけでなく、正確にどのセッションが原因であったか、どれくらいの時間ロックを保持したか、そして他のクエリーにどれくらいの待機時間を発生させたかを定量化しています。重要度は利用可能なデータから推測されるため、重要度のみに基づいて行動する前に、根拠を読んで根本原因を確認してください。
知見に対応する
知見を読んだ後、ループを閉じるには3つの方法があります。
- エビデンスと推奨事項をガイドとして使用して、 推奨事項を自分で適用してください。
- 知見の詳細ページで 「Genieで修正」 をクリックすると、インタラクティブエージェントに引き渡され、会話形式で調査を続けることができます。これは、推奨事項に対して行動する前により多くのコンテキストが必要な場合、または修正にデータベース側の変更が伴う場合に役立ちます。Genie を使用した問題の診断と修正を参照してください。
- 対応済みであるか、またはアクションが不要であると判断した後、 ステータスを更新 （例えば、却下または解決済みとしてマーク）します。
検出結果が自動的に消えることがあります。
知見は独自のスケジュールで再評価されるため、ステータスを変更しなくても、発見事項がリストから消えることがあります。たとえば、一度限りの一括ロードのような一時的なイベントが後続のウィンドウで再発生しない場合や、その背後にあるコンピュートがゼロにスケーリングされ、問題のあるセッションがなくなった状態で新しく再開される場合などです。発見事項がアクティブリストから消えても、それが却下されたことや、何かがうまくいかなかったことを意味するものではありません。これは、最新の評価ウィンドウにはもはや条件が存在しないことを反映しています。
知見を表示するには、設定を作成するために必要な権限とは別に、ワークスペースで ワークスペース アクセス が必要です。ワークスペースアクセスがないユーザーは、プロジェクトを表示できる場合でも知見を開くことができません。
次のステップ
- Genie で問題を診断して修正する ― 会話形式で調査を続けるか、最初から新しい調査を開始する。
- AIアシストによるトラブルシューティングの概要 — 知見とGenieがどのように連携するか、および現在の制限事項。
- Lakebaseプロジェクトを監視する : その他の可観測性ツールを参照してください。「オブザーバビリティ」を参照してください。