Jira

備考

プレビュー

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

Lakewatch アラートをJiraに課題としてエクスポートします。アラートが作成されると、LakewatchはJira課題を作成し、アラートの変更に応じてそれを更新します。送信先全体のエクスポートの動作については、アラート通知先を参照してください。

Jiraへのエクスポートは一方向で、LakewatchからJiraに行われます。Lakewatchは、アカウントのEメールとAPIトークンを使用してJira クラウドにサインインします。

前提条件

Jiraを設定する

• パブリックインターネットからHTTPS経由で到達可能なJiraインスタンス。Lakewatchは、Private Linkの背後にあるEndpointなどのプライベートネットワークに配信できません。
• ターゲットプロジェクトで課題を作成および更新できるJiraアカウント。
• そのアカウントのAPIトークン。Atlassianのアカウント設定で作成します。

APIトークンをUnity Catalogシークレットとして保存する

Jira APIトークンを、Lakewatch環境 のカタログの スキーマ内のUnity Catalogシークレット に保存します。__lakewatch シークレットの選択 にはそのスキーマからのシークレットが一覧表示され、 シークレットの作成 によってそのスキーマにシークレットが作成されます。Lakewatchはシークレット名のみを保存し、シークレット値は保存しません。

このシークレットは、事前に <catalog>.__lakewatch で作成しておくか、Jiraエクスポートの設定中に シークレットを作成 ボタンを使用して作成することができます。いずれの場合も、シークレットを作成するにはカタログに対する USE CATALOG が必要であり、かつ __lakewatch スキーマの所有権、あるいはそのスキーマに対する CREATE SECRET と USE SCHEMA の両方の権限が必要です。ステップについては、シークレットの作成を参照してください。

必要な権限

Jiraエクスポートを構成するには、以下が必要です：

• READ SECRET APIトークンを保持するUnity Catalogシークレット、またはその親スキーマまたはカタログ。Lakewatchは、構成を保存する際にシークレットを読み取れることを確認します。それを付与するには、「シークレットの権限を管理する」を参照してください。
• Lakewatch環境のカタログに対するMANAGE権限。設定を構成を参照してください。

APIトークンを変更するには、同じUnity Catalogシークレットの値を更新します。Lakewatchは次のエクスポートで新しい値を使用し、設定に変更はありません。別のシークレットを使用するには、設定で シークレットの選択 または シークレットの作成 をクリックして保存します。

アラート通知先としてJiraを設定する

アラート 設定セクションで、アラートのJira送信先を構成します。

1. Lakewatchサイドバーで、 設定 に移動し、 アラート を開きます。
2. 配信 で、 アラート通知先 を Jira に設定します。
3. JiraインスタンスURL に、課題が登録されるJiraインスタンスを入力します（例：https://acme.atlassian.net）。
4. プロジェクトキー に、課題が作成されるプロジェクトを入力します。
5. 「 ユーザーのEメール 」に、APIトークンとペアになっているアカウントのEメールアドレスを入力します。
6. APIトークンシークレット の場合は、 シークレットの選択 をクリックしてAPIトークンを保持するシークレットを選択するか、 シークレットの作成 をクリックしてページを離れずにAPIトークンからシークレットを作成します。このフィールドにはシークレットの名前が表示され、値は表示されません。
7. defaultの課題タイプ に、TaskやIncidentのように作成する課題タイプを入力します。このフィールドは必須であり、Lakewatchはdefaultを入力しません。プロジェクトにその課題タイプがない場合、Jiraはエクスポートを拒否します。
8. 変更を保存します。

すべてのアラート設定のリファレンスについては、「 設定の構成」を参照してください。

トラブルシューティング

• Jiraで課題が作成されない： インスタンスURLまたはプロジェクトキーが間違っているか、アカウントがプロジェクトで課題を作成できません。インスタンスURL、プロジェクトキー、およびアカウントとAPIトークンがプロジェクトで課題を作成できることを確認します。
• 設定が保存されません ：Unity Catalog のシークレットを読み取る権限がないか、シークレットが Lakewatch 環境とは別のカタログにあるか、インスタンス URL が HTTPS を使用していないか、プライベート・ネットワークを指しています。シークレット、そのカタログ、およびインスタンス URL へのアクセスを確認してください。
• シークレットの選択 にシークレットが表示されない場合： シークレットの選択 には、環境のカタログの__lakewatchスキーマでアクセス権を持つシークレットのみが表示されます。そこにシークレットを保存するか、そのシークレットにREAD SECRETを要求してください。
• 認証失敗 : ユーザーEメールまたはAPIトークンが正しくありません。Eメールがトークンとペアになっているアカウントであることを確認し、シークレットに保存されているトークンが有効であることを確認してください。
• APIトークンをローテーションしました ：Unity Catalogシークレットを新しい値で更新します。エクスポート構成の変更は不要です。