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

Genie ZeroOpsを起動

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから Genie ZeroOps を有効にする必要があります。Databricksのプレビューを管理を参照してください。

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

要件​

  • Genie ZeroOps プレビューが有効になっているDatabricksワークスペース。ワークスペース管理者は、 [プレビュー] ページからそれを有効にする必要があります。「Databricks プレビューの管理」を参照してください。
  • 監視対象のジョブ、パイプライン、またはテーブルに対するOWNER、CAN MANAGE、またはCAN VIEW権限。
  • オプション: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は、知見が最初に受信トレイに表示されたときに通知を送信できます。Slack、Microsoft Teams、PagerDuty、汎用Webhook通知先をサポートしています。Genie ZeroOpsは現在、Eメール通知先をサポートしていません。

Genie ZeroOpsで通知を構成する前に、ワークスペース管理者がワークスペースに通知先を作成する必要があります。「通知先を管理する」を参照してください。

  1. Genie ZeroOps受信ボックスの右上隅にある Sparkle Genie Codeアイコン。 構成 をクリックします。

  2. Genie Codeに通知を構成するよう依頼してください。例えば:

プロンプト
Text
Send new ZeroOps insights to <destination-name>.

送信先名がわからない場合は、What notification destinations are available for ZeroOps insights?に尋ねて、応答から送信先を選択してください。 3. ZeroOps設定 カードで、 [表示] をクリックし、 [通知] を確認して、保存された送信先を確定します。

例:Webhookを使用してJira作業アイテムを作成する​

汎用Webhook通知先とJira クラウド自動化フローを使用して、新しい知見ごとに作業アイテムを作成します:

  1. Jira クラウドで、 受信Webhook Triggerを使用して自動化フローを作成します。Atlassianドキュメントの受信Webhook Triggerの設定を参照してください。

  2. 作業項目を作成 アクションを追加します。Jiraスマート値を使用してGenie ZeroOps webhookフィールドをマッピングします(例:)。

    Text
    Summary: {{webhookData.title}}

    Description:

    {{webhookData.insight_summary}}

    Asset type: {{webhookData.assets.first.asset_type}}
    Asset: {{webhookData.assets.first.asset_name}}
    View insight: {{webhookData.insight_link}}
  3. ワークスペース管理者に、Jira受信Webhook URLを使用して Webhook 通知送信先を作成するように依頼してください。Jiraでは、受信Webhookにシークレットが必要です。通知送信先はカスタムヘッダーをサポートしていないため、Atlassianのドキュメントに記載されている、シークレットを含むURL形式を使用してください。

  4. Genie ZeroOps設定チャットで、新しいWebhook送信先を選択します。

  5. 受信トレイに新しい知見が表示されたら、Jiraで対応する作業項目を確認してください。

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

ジョブとパイプライン ページから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を作成 をクリックして、修正を新しいBranchにプッシュします。代わりに選択したBranchにプッシュする場合は、スレッドで依頼してください:

プロンプト

Genie ZeroOpsにプッシュするBranchを指定します。例:

Text
Create a PR on the fix/daily-revenue branch
  1. プロンプトが表示されたら、プッシュを確定します。確認には、Genie ZeroOpsがプッシュするBranchが表示されます。Genie ZeroOpsは、修正をそのBranchにcommitし、プッシュします。

  2. プルリクエストを開くには、Genie ZeroOpsの返信にあるLinkをクリックしてください。返信にLinkがない場合は、Branchからプルリクエストを作成してください。次に、通常のプロセスを通じてプルリクエストをレビューしてMergeします。

名前を付けるBranchは、新規でも既存でも構いません。カスタム指示でBranchに名前を付けることもでき、 PRの作成 がそのBranchにプッシュされるようにすることができます。

Genie ZeroOpsが既存のBranchにプッシュする場合、修正を新しいcommitとして追加し、強制プッシュを行わないため、Branchの履歴は書き換えられません。Branchからプルリクエストが既に開かれている場合、新しいcommitがそれに表示されます。

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に修正を再度プッシュするように依頼してください。
  • Genie ZeroOpsは、指定したBranchにプッシュできません : GitプロバイダーがそのBranchへのプッシュを許可しているか確認してください。Branch保護ルールは、リポジトリのdefault Branchへのダイレクトプッシュなどをブロックする可能性があります。Genie ZeroOpsは強制プッシュを行わないため、Branchに既に存在するcommitを上書きする修正をプッシュすることはできません。