Meldingsbestemmingen beheren

Op deze pagina leert u hoe u meldingsbestemmingen voor uw werkruimte maakt en configureert.

Systeemmeldingen zijn berichten die u vertellen wanneer uw werkstroom een uitvoeringsevenement ondervindt (starten, slagen en mislukken). Standaard worden meldingen naar gebruikersadressen gestuurd, maar beheerders kunnen alternatieve notificatiebestemmingen instellen met webhooks of de Databricks Genie-app voor Slack en Microsoft Teams (Beta). Hiermee kunt u gebeurtenisgestuurde integraties bouwen met Azure Databricks.

Beheerders kunnen ook meldingsbestemmingen configureren voor het ontvangen van toegangsaanvragen van werkruimtegebruikers, zoals aanvragen voor bevoegdheden voor Unity Catalog-objecten.

U moet een Azure Databricks werkruimtebeheerder zijn om meldingsbestemmingen te beheren. Nadat een bestemming is geconfigureerd, is deze beschikbaar voor alle gebruikers.

Netwerkvereisten

Voor webhook-gebaseerde bestemmingen moet het ontvangende eindpunt aan de volgende eisen voldoen:

• Azure Databricks dwingt het gebruik van HTTPS af voor beveiliging. De meldingsbestemming moet ssl-certificaten (Secure Sockets Layer) gebruiken die zijn ondertekend door een vertrouwde certificeringsinstantie.
• De meldingsbestemming moet zowel het besturingsvlak van de werkruimte als het uitgaande IP-adres van het gegevensvlak toevoegen aan de acceptatielijst:

  • Zie IP-adressen en -domeinen voor Azure Databricks services en assets voor de IP-adressen van de control plane-webapplicatie.

  • Zie het ip-ranges.json-bestand dat Azure Databricks publiceert voor uitgaande IP-adressen van het datavlak. Zoek in het bestand naar de data plane-regio van uw werkruimte en laat de bijbehorende uitgaande IP-adressen toe in uw netwerkstack.

    Azure Databricks kan de uitgaande IP-adressen zo vaak als elke 30 dagen bijwerken. Bijgewerkte IP-adressen worden 60 dagen na publicatie actief, dus controleer het bestand regelmatig en werk de toegestane lijst bij voordat het activeringsvenster sluit.

    Als u wijzigingen tussen releases wilt bijhouden, slaat u opeenvolgende versies van het JSON-bestand op en vergelijkt u de timestampSeconds waarde. Filtervermeldingen waarbij:

    • Het service veld is Databricks
    • Het platform veld is azure
    • Het type veld is outbound

Een nieuwe meldingsbestemming maken

Een nieuwe meldingsbestemming configureren

1. Klik op uw gebruikersnaam in de bovenste balk van de werkruimte en selecteer Instellingen in de vervolgkeuzelijst.
2. Klik in de sectie Werkruimtebeheerder op het tabblad Meldingen .
3. Klik op de knop Beheren .
4. Klik op +Bestemming toevoegen.
5. Selecteer een doeltype. De volgende bestemmingen worden momenteel ondersteund:
   • E-mailen
   • Slack
   • Webhook, met optionele OAuth-authenticatie (Beta)
   • Microsoft Teams
   • PagerDuty
6. Configureer de bestemming op basis van het type.
7. Klik op Create.

webhookpayloads

De dienst die een melding stuurt, definieert de webhook-payload. Voor de payloads die jobs versturen, zie HTTP webhook payloads. Voor de payload die Databricks SQL-alerts sturen na een statuswijziging, zie SQL alert webhook payload.

Verschillende referenties gebruiken voor elke bestemming

De configuratie van een bestemming wordt veilig opgeslagen in uw Azure Databricks werkruimte. Voor bestemmingen waarbij je een URL of inloggegevens moet opgeven, raadt Azure Databricks aan om voor elke geconfigureerde bestemming verschillende inloggegevens te gebruiken. Dit beperkt de impact als een endpoint van een derde partij wordt gecompromitteerd. Deze omvatten:

• Slack met een webhook: de URL waarnaar de melding wordt gestuurd.
• Microsoft Teams met een webhook: de URL waarnaar de melding wordt gestuurd.
• PagerDuty: integratiesleutel die wordt gebruikt om meldingen uniek te routeren naar een PagerDuty-service.
• Webhook: een gebruikersnaam en wachtwoord voor HTTP Basic-authenticatie, of een client ID en client secret voor OAuth-authenticatie (Beta).

Met verschillende geheimen voor elke geconfigureerde bestemming kunt u de toegang van afzonderlijke meldingsbestemmingen afzonderlijk intrekken zonder dat dit van invloed is op de werking van alle andere bestemmingen in uw Azure Databricks werkruimte.

OAuth-authenticatie voor webhook-bestemmingen

Gebruik de clientgegevens van OAuth 2.0 om meldingen te sturen naar een endpoint dat een toegangstoken vereist. Azure Databricks verkrijgt het token van uw identiteitsprovider en gebruikt het om het meldingsverzoek te authenticeren.

Je identiteitsprovider moet de goedkeuring van klantgegevens ondersteunen. Zowel het ontvangende eindpunt als het token-eindpunt moeten HTTPS gebruiken.

Om een OAuth webhook-bestemming te creëren:

1. Klik inInstellingenmeldingen> op Beheren en +Voeg bestemming toe.
2. Voer een naam in en selecteer Webhook voor Type.
3. Voor Authenticatiemodus, selecteer OAuth.
4. Voer de volgende waarden in:
   • URL: Het eindpunt dat meldingen ontvangt.
   • Client ID en Client Secret: De inloggegevens die door je identiteitsprovider zijn verstrekt.
   • Token endpoint URL: Het endpoint waarvan Azure Databricks een toegangstoken verkrijgt.
   • Scopes en Doelgroep: Voer deze optionele waarden in indien vereist door uw identiteitsprovider. Scheid meerdere scopes met komma's.
5. Klik op Create.

De client ID, client secret en token endpoint URL zijn samen vereist. OAuth kan niet worden gecombineerd met HTTP Basic-authenticatie.

Om de configuratie te verifiëren, open je het driepuntenmenu van de bestemming en klik je op Test. Azure Databricks verkrijgt een toegangstoken en stuurt een voorbeeldmelding. Als de test faalt, controleer dan de inloggegevens, scopes, audience, ontvangerrechten en netwerktoegang tot beide eindpunten.

bestemming voor Slack

Om een webhook-gebaseerde Slack-bestemming op te zetten, volg je de instructies in Incoming webhooks voor Slack. Plak de gegenereerde URL in uw Azure Databricks meldingsbestemming. Om in plaats daarvan de Databricks Genie-app te gebruiken, zie Slack en Microsoft Teams Genie app-bestemmingen.

Bestemmingen voor de Slack- en Microsoft Teams-Genie-app

Gebruik de Databricks Genie-app om je Slack-werkruimte of Microsoft Teams-tenant te verbinden met je Azure Databricks-werkruimte. Selecteer vervolgens een beschikbaar kanaal als meldingsbestemming.

Je kunt Genie-app-bestemmingen gebruiken met de volgende functies:

• SQL-waarschuwingen: Slack en Microsoft Teams.
• Toegangsverzoeken voor de Unity-catalogus: Slack en Microsoft Teams.
• Model Serving-meldingen voor eindpunten: Slack.

Maak een bestemming voor Genie-apps aan

Voordat je een Genie-app bestemming aanmaakt, moet je de Databricks Genie-app installeren voor Slack of Microsoft Teams, deze verbinden met je Azure Databricks werkruimte en toevoegen aan het kanaal dat meldingen ontvangt. Voor details over app-installatie en verbindingsstappen, zie Slack of Microsoft Teams.

Om een Genie-app bestemming te creëren:

1. Klik inInstellingenmeldingen> op Beheren en +Voeg bestemming toe.

2. Voor Typen, selecteer Slack of Microsoft Teams, en selecteer vervolgens 'Gebruik van de Databricks-app'.

3. Voer een naam in voor de bestemming.

4. Selecteer de werkruimte of tenant en het kanaal:

   • Selecteer voor Slack de Slack Werkruimte en het kanaal.
   • Selecteer voor Microsoft Teams het Tenant en het kanaal. De tenant selector identificeert elke tenant aan de hand van de laatste zes tekens van zijn tenant-ID.

   Als er geen Slack-werkruimtes of Microsoft Teams-tenants verbonden zijn, klik dan respectievelijk op Connect a Slack workspace of Connect a Teams-tenant en voltooi de Genie-app setup. Ga terug naar het bestemmingsformulier en klik op Verversen. Als je net de Genie-app aan een kanaal hebt toegevoegd, klik dan op Kanalen herladen om de kanaallijst bij te werken.

5. Klik op Create.

PagerDuty-bestemming

Om een PagerDuty-bestemming in te stellen:

1. Voeg in PagerDuty een integratie toe aan je service en selecteer het Events API V2-integratietype .
2. Kopieer de integratiesleutel die PagerDuty genereert voor de integratie.
3. In Azure Databricks plakt u de integratiesleutel in de PagerDuty-notificatiebestemming.

Een webhook toevoegen aan een taak

Nadat u bestemmingen hebt geconfigureerd, kunt u deze openen in de instellingen voor taakmeldingen van een taak. Zie Meldingen toevoegen aan een taakvoor meer informatie.

Elke taak ondersteunt maximaal drie systeembestemmingen per gebeurtenistype. Bij het configureren van taakmeldingen moeten e-mailadressen handmatig worden ingevoerd.

Beperkingen

Meldingsbestemmingen hebben momenteel de volgende beperkingen:

• E-mailmeldingsbestemmingen hebben een limiet van 1300 tekens voor de adreslengte van de geadresseerde.
• Voor aangepaste meldingsbodies ondersteunen niet-e-mailbestemmingen zoals Slack en Microsoft Teams geen HTML-opmaak. Sommige meldingsbestemmingen bieden ondersteuning voor Markdown.
• Voor taken moeten e-mailbestemmingen handmatig worden ingesteld in de instellingen van de taak.