メインコンテンツまでスキップ

Genie を使用した問題の調査と修正

Lakebase UI で、Genie がデータベースを調査して修正します。ユーザー自身の言葉で問題を記述すると、Genieがsystem.lakebaseのテレメトリーとプロジェクトの設定を読み取って、ライブのPostgresの状態、クエリープラン、待機イベント、DDLやスキーマ変更の履歴などの状況を把握します。お客様ご自身で気づいた問題、または Insights が検出し、 Genieで修正 が診断を引き継ぐ問題から始めます。Genie はプロジェクトの構成の調整もサポートします。

Genie works as a step-by-step conversation.It shows its reasoning and asks you to approve each action, including the クエリー it runs while investigating.Any fix, including a database change, needs your explicit confirmation before it's applied.

このページでは、アプリケーションが依然としてクエリーする列を削除するデプロイという、一般的な本番運用のインシデントを取り上げ、Genieに支援を求めるプロセス全体がどのようなものかを示します。

Prerequisites​

  • AWSまたはAzure上のLakebaseプロジェクト。詳細については、Postgresデータベースの取得を参照してください。
  • 取得したテレメトリーに基づく調査を行う場合: Lakebase Observability in System Tables のプレビューが有効になっており、かつsystem.lakebaseのテーブルへのアクセスまたはそれらから生成された知見へのアクセスのいずれかが必要です。それらのいずれもない場合、Genieはプロジェクトの現在の状態と構成に基づいて動作します。See Lakebase telemetry in system tables.

シナリオ​

スキーマの変更により、定期的デプロイの一部として ALTER TABLE users DROP COLUMN bio がランとして実行されます。アプリケーションはそのプロファイルページで引き続きその列を読み取ります。数分以内に、プロファイルページの要求が column "bio" does not exist で失敗し始め、アプリケーションのエラー率が上昇します。

Genieの調査のフロー​

What Genie finds and recommends depends on your data and the issue behind it, so your investigation differs in its details.プロジェクトから Genie を開き、プロジェクト、Branch、Endpoint のコンテキストを自動的に取得して、症状を説明します。一般的な調査は、次の4つの段階で構成されます。

You describe the symptom​

平易な言葉で質問します: "エラー率が上昇しているのはなぜですか?" 原因や失敗したクエリー、関わっているテーブルを知る必要はありません。

Genie が相関関係を把握し、履歴を読み取る​

エラーの原因となったクエリーに関連付けられ、何が変更されたかを確認するためにDDL履歴をチェックします。DDL履歴にはすべての変更が記録されるわけではありません(コンピュートがスケールゼロから再開するのと同時に行われた変更は見落とされる可能性があります)。そのため、レコードが欠落している場合、Genieはその旨を伝え、テーブルの現在の列とクエリーが期待する内容との比較にフォールバックします。いずれにせよ、bioを削除された列として特定します。これはInsightsが読み取る履歴と同じであるため、Genieはバックグラウンドの知見が中断したところから再開できます。

Genie proposes a recovery, grounded in what it found​

通常、変更の直前に作成されたポイントインタイムのBranch(**本番運用**とストレージを共有するインスタントなコピーオンライトのクローンで、あらゆる修正に対して安価に起動できる)から始まります。そこからの復旧は対話形式で行われます。Genieが欠落しているデータを現在のテーブルにコピーし直すか、アプリケーションを復元されたBranchに切り替えます。一部のパスでは、Genieが自分自身では検出できない接続文字列など、途中で詳細情報の入力が求められます。

You confirm before anything is applied​

Genie never restores, modifies, or applies a fix on its own.アクションが実行されたことがレポートされますが、それに依存する前に Lakebase UI で結果に影響するアクション(復元ポイント、削除された Branch)を確認してください。

制限事項​

  • Customizations、Automations、Spaces、Add contextなどの一般的なGenie UI要素は、Genieには表示されますが、Lakebaseでは効果がありません。
  • A Genie conversation continued from outside the Lakebase UI (for example, from a ノートブック) keeps the conversation history but loses the original page's tools and context.Start new investigations from inside the Lakebase project for the most reliable results.
  • BranchとEndpointは、「本番運用」のような表示名ではなく、内部IDで表示されます。Genieの回答が、どのBranchまたはEndpointを指しているのか曖昧な場合は、Lakebase UIでIDをクロスリファレンスしてください。詳細については、テレメトリーの制限事項を参照してください。

次のステップ​