Benachrichtigungsziele verwalten

Auf dieser Seite erfahren Sie, wie Sie Benachrichtigungsziele für Ihren Arbeitsbereich erstellen und konfigurieren.

Systembenachrichtigungen sind Meldungen, die Ihnen mitteilen, wann bei Ihrem Workflow ein Ausführungsereignis auftritt (Start, Erfolg und Fehler). Standardmäßig werden Benachrichtigungen an Benutzer-E-Mail-Adressen gesendet, aber Administratoren können alternative Benachrichtigungsziele mit Webhooks oder der Databricks Genie App für Slack und Microsoft Teams (Beta) konfigurieren. Auf diese Weise können Sie ereignisgesteuerte Integrationen mit Azure Databricks erstellen.

Administratoren können auch Benachrichtigungsziele für den Empfang von Zugriffsanforderungen von Arbeitsbereichsbenutzern konfigurieren, z. B. Berechtigungsanforderungen für Unity Catalog-Objekte.

Sie müssen ein Azure Databricks Arbeitsbereichsadministrator sein, um Benachrichtigungsziele zu verwalten. Nachdem ein Ziel konfiguriert wurde, ist es für alle Benutzer*innen verfügbar.

Netzwerkanforderungen

Für webhook-basierte Ziele muss der empfangende Endpunkt folgende Anforderungen erfüllen:

• Azure Databricks erzwingt die Verwendung von HTTPS zur Sicherheit. Das Benachrichtigungsziel muss von einer vertrauenswürdigen Zertifizierungsstelle signierte Secure Sockets Layer-Zertifikate (SSL-Zertifikate) verwenden.
• Das Benachrichtigungsziel muss sowohl die Arbeitsbereichsteuerungsebene als auch die ausgehenden IP-Adressen der Datenebene zur Zulassungsliste hinzufügen:

  • Informationen zu Webapp-IP-Adressen für die Steuerungsebene finden Sie unter IP-Adressen und Domänen für Azure Databricks Dienste und Objekte.

  • Informationen zu ausgehenden IP-Adressen der Datenebene finden Sie in der ip-ranges.json Datei, die Azure Databricks veröffentlicht. Durchsuchen Sie die Datei nach der Datenebenenregion Ihres Arbeitsbereichs, und lassen Sie die entsprechenden ausgehenden IP-Adressen in Ihrem Netzwerkstapel auflisten.

    Azure Databricks können die ausgehenden IPs so oft wie einmal alle 30 Tage aktualisieren. Aktualisierte IPs werden 60 Tage nach der Veröffentlichung aktiv. Überprüfen Sie daher die Datei regelmäßig, und aktualisieren Sie Ihre Zulassungsliste, bevor das Aktivierungsfenster geschlossen wird.

    Um Änderungen zwischen Versionen nachzuverfolgen, speichern Sie aufeinander folgende Versionen der JSON-Datei, und vergleichen Sie den timestampSeconds Wert. Filtereinträge, bei denen:

    • Das service Feld ist Databricks
    • Das platform Feld ist azure
    • Das type Feld ist outbound

Erstellen eines neuen Benachrichtigungsziels

So konfigurieren Sie ein neues Benachrichtigungsziel

1. Wählen Sie in der oberen Leiste des Arbeitsbereichs Ihren Benutzernamen und anschließend in der Dropdownliste Einstellungen aus.
2. Klicken Sie im Abschnitt Arbeitsbereichsadministrator auf die Registerkarte Benachrichtigungen.
3. Klicken Sie anschließend auf die Schaltfläche Verwalten.
4. Klicken Sie auf + Ziel hinzufügen.
5. Wählen Sie einen Zieltyp aus. Derzeit werden die folgenden Ziele unterstützt:
   • E-Mail
   • Slack
   • Webhook, mit optionaler OAuth-Authentifizierung (Beta)
   • Microsoft Teams
   • PagerDuty
6. Konfigurieren Sie das Ziel basierend auf dem Typ.
7. Klicken Sie auf Erstellen.

Verwenden Sie unterschiedliche Anmeldeinformationen für jedes Ziel

Die Konfiguration eines Ziels wird sicher in Ihrem Azure Databricks Arbeitsbereich verschlüsselt gespeichert. Für Ziele, bei denen Sie eine URL oder Zugangsdaten angeben müssen, empfiehlt Azure Databricks, für jedes konfigurierte Ziel unterschiedliche Zugangsdaten zu verwenden. Dies begrenzt die Auswirkungen, falls ein Drittanbieter-Endpunkt kompromittiert wird. Dazu gehören:

• Slack mit einem Webhook: die URL, an die die Benachrichtigung gesendet wird.
• Microsoft Teams mit einem Webhook: die URL, an die die Benachrichtigung gesendet wird.
• PagerDuty: Der Integrationsschlüssel, der verwendet wird, um Benachrichtigungen eindeutig an einen PagerDuty-Dienst weiterzuleiten.
• Webhook: ein Benutzername und Passwort für HTTP Basic-Authentifizierung oder eine Client-ID und ein Client-Geheimnis für OAuth-Authentifizierung (Beta).

Durch die Verwendung verschiedener geheimer Schlüssel für jedes konfigurierte Ziel können Sie den Zugriff einzelner Benachrichtigungsziele einzeln widerrufen, ohne den Betrieb aller anderen Ziele in Ihrem Azure Databricks Arbeitsbereich zu beeinträchtigen.

OAuth-Authentifizierung für Webhook-Ziele

Verwenden Sie OAuth 2.0 Client-Zugangsdaten, um Benachrichtigungen an einen Endpunkt zu senden, der ein Zugriffstoken benötigt. Azure Databricks erhält das Token von Ihrem Identitätsanbieter und verwendet es, um die Benachrichtigungsanfrage zu authentifizieren.

Ihr Identitätsanbieter muss den Client-Credentials-Grant unterstützen. Sowohl der empfangende Endpunkt als auch der Token-Endpunkt müssen HTTPS verwenden.

Um ein OAuth-Webhook-Ziel zu erstellen:

1. InEinstellungsbenachrichtigungen> klicke auf Verwalten und dann +Ziel hinzufügen.
2. Geben Sie einen Namen ein und wählen Sie Webhook als Typ.
3. Für den Authentifizierungsmodus wählen Sie OAuth aus.
4. Geben Sie die folgenden Werte ein:
   • URL: Der Endpunkt, der Benachrichtigungen empfängt.
   • Client-ID und Kundengeheimnis: Die von Ihrem Identitätsanbieter ausgestellten Zugangsdatendaten.
   • Token-Endpunkt-URL: Der Endpunkt, von dem Azure Databricks ein Zugriffstoken erhält.
   • Umfang und Zielgruppe: Geben Sie diese optionalen Werte ein, falls Ihr Identitätsanbieter dies verlangt. Trennen Sie mehrere Bereiche durch Kommas.
5. Klicken Sie auf Erstellen.

Die Client-ID, das Client-Geheimnis und die Token-Endpunkt-URL werden zusammen benötigt. OAuth kann nicht mit HTTP Basic-Authentifizierung kombiniert werden.

Um die Konfiguration zu überprüfen, öffnen Sie das Dreipunktmenü des Ziels und klicken Sie auf Test. Azure Databricks erhält einen Zugriffstoken und sendet eine Beispielbenachrichtigung. Wenn der Test fehlschlägt, überprüfen Sie die Zugangsdaten, Scopes, Audience, Empfängerberechtigungen und Netzwerkzugang zu beiden Endpunkten.

Slack-Ziel

Um ein Webhook-basiertes Slack-Ziel einzurichten, befolgen Sie die Anweisungen unter Eingehende Webhooks für Slack. Fügen Sie die generierte URL in Ihr Azure Databricks Benachrichtigungsziel ein. Um stattdessen die Databricks Genie App zu verwenden, siehe Slack und Microsoft Teams Genie App Destinations.

Slack- und Microsoft-Teams-Zielorte der Genie-App

Verwenden Sie die Databricks Genie-App, um Ihren Slack-Arbeitsbereich oder Microsoft Teams-Tenant mit Ihrem Azure Databricks-Arbeitsbereich zu verbinden. Wählen Sie dann einen verfügbaren Kanal als Benachrichtigungsziel aus.

Sie können Genie-App-Ziele mit folgenden Funktionen nutzen:

• SQL-Warnungen: Slack und Microsoft Teams.
• Unity-Katalogzugriffsanfragen: Slack und Microsoft Teams.
• Benachrichtigungen für Model-Serving-Endpunkte: Slack.

Erstelle ein Ziel für eine Genie-App

Bevor Sie ein Ziel für eine Genie-App erstellen, müssen Sie die Databricks Genie-App für Slack oder Microsoft Teams installieren, sie mit Ihrem Azure Databricks-Arbeitsbereich verbinden und sie dem Kanal hinzufügen, der Benachrichtigungen erhält. Details zur App-Installation und Verbindungsschritten finden Sie unter Slack oder Microsoft Teams.

Um ein Genie-App-Ziel zu erstellen:

1. InEinstellungsbenachrichtigungen> klicke auf Verwalten und dann +Ziel hinzufügen.

2. Für Typ wählen Sie Slack oder Microsoft Teams aus und wählen dann Databricks-App verwenden aus.

3. Geben Sie einen Namen für das Ziel ein.

4. Wählen Sie den Arbeitsbereich oder Tenant und den Kanal aus:

   • Für Slack wähle den Slack-Arbeitsbereich und den Kanal aus.
   • Für Microsoft Teams wählen Sie den Tenant und den Kanal aus. Der Mieterselektor identifiziert jeden Mieter anhand der letzten sechs Zeichen seiner Mieter-ID.

   Wenn keine Slack-Arbeitsbereiche oder Microsoft Teams-Tenants verbunden sind, klicken Sie auf "Einen Slack-Arbeitsbereich verbinden" oder "Einen Teams-Tenant verbinden" und schließen Sie die Genie-App-Einrichtung ab. Gehen Sie zum Zielformular zurück und klicken Sie auf Aktualisieren. Wenn du gerade die Genie-App zu einem Kanal hinzugefügt hast, klicke auf Kanäle neu laden , um die Kanalliste zu aktualisieren.

5. Klicken Sie auf Erstellen.

PagerDuty-Ziel

Um ein PagerDuty-Ziel einzurichten:

1. Füge in PagerDuty eine Integration zu deinem Service hinzu und wähle den Events API V2-Integrationstyp aus.
2. Kopiere den Integrationsschlüssel, den PagerDuty für die Integration generiert.
3. In Azure Databricks fügen Sie den Integrationsschlüssel in das PagerDuty-Benachrichtigungsziel ein.

Hinzufügen eines Webhooks zu einem Auftrag

Nachdem Sie Ziele konfiguriert haben, können Sie in den Benachrichtigungseinstellungen eines Auftrags darauf zugreifen. Weitere Informationen finden Sie unter Hinzufügen von Benachrichtigungen zu einem Auftrag.

Jeder Auftrag unterstützt bis zu drei Systemziele pro Ereignistyp. Beim Konfigurieren von Auftragsbenachrichtigungen müssen E-Mail-Adressen manuell eingegeben werden.

Einschränkungen

Für Benachrichtigungsziele gelten derzeit folgende Einschränkungen:

• Bei E-Mail-Benachrichtigungen ist die Länge der Empfängeradresse auf 1.300 Zeichen begrenzt.
• Für benutzerdefinierte Benachrichtigungsinhalte unterstützen Nicht-E-Mail-Ziele wie Slack und Microsoft Teams keine HTML-Formatierung. Einige Benachrichtigungsziele unterstützen Markdown.
• Für Aufträge müssen E-Mail-Ziele manuell in den Einstellungen des Auftrags festgelegt werden.