メインコンテンツまでスキップ
非公開のページ
このページは非公開です。 検索対象外となり、このページのリンクに直接アクセスできるユーザーのみに公開されます。

Genie ZeroOpsを起動

備考

プレビュー

この機能は プライベート プレビュー段階です。試用については、Databricksの担当者にお問い合わせください。

ジョブとパイプライン ページで、監視対象のジョブ、パイプライン、テーブルを選択して、Genie ZeroOpsを起動して使用を開始してください。Genie ZeroOpsはその後、過去24時間分の知見をバックフィルし、確認して解決できるよう、新たに発生した問題の報告を続けます。概要については、Genie ZeroOpsを参照してください。

要件​

  • Genie ZeroOpsプライベートプレビューに登録されているDatabricksワークスペース。
  • 監視対象のジョブ、パイプライン、またはテーブルに対するOWNER、CAN MANAGE、またはCAN VIEW権限。
  • データ品質の問題を検出するために、Genie ZeroOpsは、監視することを選択したスキーマとテーブルでデータ品質モニタリングを有効にします。ジョブをモニタリングしても、それは有効になりません。Genie ZeroOps プライベートプレビューは無料ですが、データ品質モニタリングは標準価格で別途請求されます。
  • オプション:Git リポジトリからコードを実行するジョブの場合、リポジトリへの読み取りアクセス権を持つ Git 認証情報。修正からプルリクエストを作成するには、認証情報に書き込みアクセス権も必要です。Git 認証情報の追加を参照してください。

Genie ZeroOps のセットアップ​

初期のZeroOpsインボックス。監視するアセットの設定を促します。

  1. サイドバーで ワークフローアイコン。 ジョブ & パイプライン をクリックして、 ジョブ & パイプライン ページを開きます。

  2. Open ZeroOps ボタンをクリックします。

  3. Genie ZeroOpsをまだ構成していない場合は、構成するように求められます。Sparkle Genie Codeアイコン。 構成 ボタンをクリックして、Genie Codeチャットを開きます。

  4. Genie Codeが監視対象のリソースを尋ねてきたら、提案されたスコープを選択するか、独自のスコープを自然言語で説明してください:

プロンプト

Genie Codeに何を監視するかを伝えてください。例:

all owned jobs

スコープを設定すると、Genie ZeroOps は選択したアセットを分析し、すでに失敗したジョブや、古くなっている、または不完全なテーブルについて、過去 24 時間の知見をバックフィルします。次に、そのスコープ内の問題に対して見つかった知見を表示します。

いつでも Sparkle Genie Codeアイコン。 構成 ボタンを選択して、Genie ZeroOpsが監視する内容を調整できます。Genie ZeroOps設定の更新を参照してください。

知見とその根本原因を確認する​

ジョブとパイプライン ページからGenie ZeroOpsインボックスを開く以外に、フルページのGenie Codeからもアクセスできます。そこでは、スレッドリストに ZeroOpsインボックス として表示されます。

  1. インボックスで、オープンな知見をクリックしてスレッドを開きます。
  2. 根本原因分析と提案された修正を確認します。
  3. 同じ知見スレッド内で、Genie Codeに提案された修正を適用するよう依頼してください。または、ソースへのLinkをたどり、ご自身で修正を適用してください。
  4. Genie Codeは、ワークスペースに保存されているコードに修正を直接適用します。Gitに保存されているアセットの場合、プルリクエストを開くのに役立ちます。修正からプルリクエストを作成するを参照してください。
  5. 知見を解決済みとしてマークするには、受信トレイで 解決 をクリックします。それ以外の場合、Genie ZeroOpsは次のジョブ ランが成功した後に、自動的に知見を解決済みとしてマークします。状態は通常15分以内に更新されます。

失敗した内容、根本原因分析、および裏付けとなる証拠を表示する、オープンな ZeroOps 知見スレッド。

修正からプルリクエストを作成する​

ジョブがGitリポジトリからコードをランし、修正がコード変更である場合、Genie ZeroOpsに修正を新しいBranchにプッシュさせてからプル要求を開くことができます。Genie ZeroOpsは調査中に変更を準備し、知見に [PRの作成] オプションを表示します。明示的に指示しない限り、リポジトリに何もプッシュしません。

  1. 受信ボックスで、知見をクリックしてスレッドを開きます。
  2. 提案された修正を確認します。変更するには、スレッドで必要な変更を記述します。
  3. [PRを作成] をクリックし、プロンプトが表示されたらプッシュを確認します。Genie ZeroOpsは修正を新しいBranchにcommitしてプッシュします。
  4. プルリクエストを開くには、Genie ZeroOpsの返信にあるLinkをクリックするか、返信にLinkがない場合は新しいBranchからプルリクエストを作成します。次に、プルリクエストをレビューしてもらい、通常のプロセスでMergeします。

Genie ZeroOps 設定の更新​

セットアップ後にGenie ZeroOpsが監視する対象を変更するには、インボックスの右上隅にある Sparkle Genie Codeアイコン。 [Configure] をクリックします。Genie Codeチャットが開き、含める、または除外するジョブ、パイプライン、テーブルを説明できます。

設定後のZeroOpsインボックス。知見が開かれ、右上に [構成] ボタンが表示されています。

Genie ZeroOpsの設定を共有する​

ワークスペース内の他のユーザーと構成を共有して、それによって生成される知見に取り組めるようにします。受信トレイには、自分自身の知見と並んで、[ ソース構成 ]列に[ 私と共有 ]と表示された構成の知見が一覧表示されます。

注記

共有相手のユーザーは、基盤となる資産にアクセスできない場合でも、知見に含まれるコードの抜粋、提案された修正、サンプルデータの行を参照できます。共有しても、資産自体へのアクセス権は付与されません。

  1. 受信トレイの右上隅にあるSparkle Genie Codeアイコン。 設定 をクリックして、Genie Codeチャットを開きます。
  2. ZeroOps設定 カードで、 共有 をクリックします。
  3. ユーザーの選択... をクリックし、ワークスペースユーザーを選択して、 追加 をクリックします。共有する各ユーザーに対して繰り返します。
  4. 保存 をクリックします。

ユーザーとの共有を停止するには、 共有 ダイアログを開き、ユーザーの横にある削除アイコンをクリックして、 保存 をクリックします。

「ZeroOps設定の共有」ダイアログがGenie Codeチャットの上に開き、CAN MANAGE権限を持つ所有者と、CAN MANAGE 知見権限を持つ共有ユーザーが一覧表示されます。

共有ユーザーが実行できること​

共有相手のユーザーには、設定に対するCAN MANAGE 知見権限が付与されます。これらは、次のことができます。

  • 構成の知見を開き、根本原因と提案された修正を確認します。
  • 独自のスレッドで知見についてフォローアップし、根本原因について尋ねたり、提案された修正を改良したりできます。
  • 知見を 問題なし とマークします。状態は、知見を閲覧できるすべてのユーザーに対して変更されます。

共有したユーザーは、構成が監視する内容、共有相手、通知設定など、あなたの構成を変更することはできません。

調査指示のカスタマイズ​

カスタム指示を使用すると、問題の調査時に Genie ZeroOps が実行すべきこと、実行すべきでないことを指定できます。たとえば、再試行を推奨する前に上流データの鮮度を確認するように指示したり、特定のエラーを確認したときに特定のステップに従うように指示したりできます。

カスタム指示は、Genie ZeroOps 設定の調査にのみ適用され、ホームフォルダー内の Markdown ファイルに保存されます。

Text
/Workspace/Users/<your-username>/.assistant/zeroops/instructions.md

このファイルへのアクセスには、他のワークスペースファイルと同じワークスペース権限が適用されます。

指示を編集​

チャットインターフェイスの使用​

  1. 受信トレイの右上隅にあるSparkle Genie Codeアイコン。 設定 をクリックして、Genie Codeチャットを開きます。

  2. 自然言語でガイダンスを記述します:

プロンプト

Genie ZeroOpsが実行すべき内容をGenie Codeに伝えます(例:):

Text
When a job fails, check upstream data freshness before recommending a retry.

Genie Codeは、ガイダンスを指示に追加し、今後の調査でそれが考慮されます。

直接編集​

  1. Genie Code設定チャットで、 Your ZeroOps configuration カードを見つけて、 [View] をクリックします。
  2. Custom instructions で、 this file をクリックします。
  3. ファイルを編集します。また、その隣に開くチャットで変更内容を説明することもできます。

手順ファイルに内容がある場合、 カスタム指示 セクションに 設定済み と表示されます。

制限事項​

  • 設定に関する問題の新しい調査では、指示が読み込まれます。指示を保存しても、すでに進行中の調査は変更されません。
  • Genie ZeroOps は、ファイルの最初の 20,000 文字のみを読み取ります。関連性のないガイダンスや矛盾するガイダンスは調査の品質を低下させる可能性があるため、指示は簡潔かつ具体的に記述してください。
  • 各調査レポートには、指示が使用されたかどうかが記載されます。
  • 指示は、Genie ZeroOpsの安全性に関する制約やツールの権限を上書きすることはできません。Genie ZeroOpsが指示を適用しない場合、調査レポートにその理由が簡単に説明されます。

知見をフィルタリング​

  1. フィルター をクリックします。
  2. 解決済み などのステータスを選択します。
  3. フィルターを適用して受信トレイを更新します。

トラブルシューティング​

  • Genie ZeroOpsをセットアップしても知見が表示されない :期待するジョブ、パイプライン、またはテーブルに対するOWNER、CAN MANAGE、またはCAN VIEW権限があることを確認してください。Genie ZeroOpsは、権限を持つアセットのみを監視します。
  • Genie ZeroOpsはリポジトリにアクセスできません :Git認証情報が存在しないか、期限切れか、リポジトリにアクセスできません。ユーザー名をクリックし、 設定 > リンクされたアカウント を選択して、認証情報を追加または更新します。Git認証情報の追加を参照してください。
  • 知見に「PRを作成」が表示されません : ジョブがGitリポジトリのコードを実行していること、およびGit資格情報でそのリポジトリにアクセスできることを確認してください。Genie ZeroOpsは、修正がコードの変更である場合にのみ PRの作成 を提供します。
  • Genie ZeroOpsは修正をプッシュできません :Git認証情報にはリポジトリへの書き込みアクセス権が必要です。ユーザー名をクリックし、 設定 > リンクされたアカウント を選択して、資格情報を更新し、書き込みアクセス権が付与されるようにします。その後、Genie ZeroOpsに修正を再度プッシュするように依頼してください。