通知の送信先を管理する

このページでは、ワークスペースの通知先を作成して構成する方法について説明します。

システム通知は、ワークフローで実行イベント (開始、成功、失敗) が発生したときに通知するメッセージです。 既定では、通知はユーザーの電子メール アドレスに送信されますが、管理者は Webhook を使用して代替の通知の送信先を構成できます。 これにより、Azure Databricksとのイベントドリブン統合を構築できます。

管理者は、Unity カタログ オブジェクトの特権要求など、ワークスペース ユーザーからアクセス要求を受け取るように通知先を構成することもできます。

通知の送信先を管理するには、Azure Databricks ワークスペース管理者である必要があります。 送信先を構成すると、すべてのユーザーがそれを使用できるようになります。

ネットワーク要件

  • Azure Databricksは、セキュリティのために HTTPS の使用を強制します。 通知先は、信頼された証明機関によって署名された Secure Sockets Layer (SSL) 証明書を使用することが必要です。
  • 通知先は、ワークスペース コントロール プレーンとデータ プレーン送信 IP アドレスの両方を許可リストに追加する必要があります。

    • コントロール プレーン Web アプリの IP アドレスについては、Azure Databricks サービスと資産のIP アドレスとドメインを参照してください。

    • データ プレーンの送信 IP アドレスについては、Azure Databricks アカウント チームに連絡してください。 送信 IP アドレスを含む JSON ファイルへの URL を受け取ります。 ワークスペースのデータ プレーンリージョンのファイルを検索し、ネットワーク スタック内の対応する送信 IP アドレスを許可リストに登録します。

      Azure Databricksは、送信 IP を 30 日に 1 回更新できます。 更新された IP は公開から 60 日後にアクティブになるため、アクティブ化ウィンドウが閉じる前にファイルを定期的に確認し、許可リストを更新します。

      リリース間の変更を追跡するには、JSON ファイルの連続するバージョンを保存し、 timestampSeconds 値を比較します。 次の場所にあるエントリをフィルター処理します。

      • service フィールドはDatabricksです。
      • platform フィールドはazureです。
      • type フィールドはoutboundである

新しい通知の送信先を作成する

新しい通知の送信先を構成するには

  1. ワークスペースの上部バーでユーザー名を選択し、ドロップダウンから [設定] を選択します。
  2. [ワークスペース管理者] セクションで、[通知] タブをクリックします。
  3. [管理] ボタンをクリックします。
  4. [+ ターゲットの追加] をクリックします。
  5. 送信先の種類を選択します。 現時点では、次の送信納先がサポートされています。
    • Email
    • スラック
    • Webhook
    • Microsoft Teams
    • ページャーデューティ
  6. 種類に基づいて宛先を構成します。
  7. Create をクリックしてください。

宛先ごとに異なる資格情報を使用する

宛先の構成は、Azure Databricks ワークスペースに安全に暗号化されて格納されます。 サード パーティのエンドポイントが侵害された場合にセキュリティを強化するために、Azure Databricksは、構成された各宛先に対して異なる資格情報を使用することをお勧めします。 次のようなものが含まれます。

  • Slack: 通知の送信先の URL。
  • MS Teams: 通知の送信先の URL。
  • PagerDuty: 通知を PagerDuty サービスに一意にルーティングするために使われる統合キー。
  • Webhook: 通知を配信するときに HTTP 基本認証を使ってサード パーティのエンドポイントに対する認証を行うために使われるユーザー名とパスワード。

構成された宛先ごとに異なるシークレットを使用すると、Azure Databricks ワークスペース内の他のすべての宛先の操作に影響を与えることなく、個々の通知先のアクセスを個別に取り消すことができます。

Slack 送信先

Slack の送信先を設定するには、「Slack での Incoming Webhook の利用」の手順に従います。 生成された URL をAzure Databricks通知先に貼り付けます。

Webhook をジョブに追加する

宛先を構成した後は、ジョブの ジョブ通知 設定でそれらの宛先にアクセスできます。 詳細については、「ジョブに通知を追加する」を参照してください。

各ジョブは、イベントの種類ごとに最大 3 つのシステム宛先をサポートします。 ジョブ通知を構成するときは、電子メール アドレスを手動で入力する必要があります。

制限事項

現在、通知先には次の制限があります。

  • Databricks SQL とジョブの通知のみを構成できます。
  • メール通知の送信先には、受信者のアドレスの長さに 1,300 文字の制限があります。
  • カスタム通知本文の場合、Slack や MS Teams などの電子メール以外の宛先は HTML 形式をサポートしていません。 一部の通知先ではマークダウンがサポートされています。
  • ジョブの場合、メールの送信先はジョブの設定で手動で設定する必要があります。
  • Last updated on