Hantera aviseringsmål

Den här sidan visar hur du skapar och konfigurerar meddelandedestinationer för din arbetsyta.

Systemaviseringar är meddelanden som talar om för dig när arbetsflödet upplever en körningshändelse (start, lyckad och misslyckad). Som standard skickas notiser till användarnas e-postadresser, men administratörer kan konfigurera alternativa notifikationsdestinationer med webhooks eller Databricks Genie-appen för Slack och Microsoft Teams (Beta). På så sätt kan du skapa händelsedrivna integreringar med Azure Databricks.

Administratörer kan också konfigurera meddelandemål för att ta emot åtkomstbegäranden från arbetsyteanvändare, till exempel behörighetsbegäranden på Unity Catalog-objekt.

Du måste vara administratör för Azure Databricks arbetsyta för att kunna hantera aviseringsmål. När ett mål har konfigurerats är det tillgängligt för alla användare.

Nätverkskrav

För webhook-baserade destinationer måste mottagarändpunkten uppfylla följande krav:

• Azure Databricks framtvingar användningen av HTTPS för säkerhet. Meddelandemålet måste använda SSL-certifikat (Secure Sockets Layer) som signerats av en betrodd certifikatutfärdare.
• Meddelandemålet måste lägga till både arbetsytans kontrollplan och utgående IP-adresser för dataplanet i listan över tillåtna:

  • Information om IP-adresser för kontrollplanswebbapp finns i IP-adresser och domäner för Azure Databricks tjänster och tillgångar.

  • Information om utgående IP-adresser för dataplanet finns i ip-ranges.json filen som Azure Databricks publicerar. Sök i filen efter arbetsytans dataplansregion och tillåtlista motsvarande utgående IP-adresser i nätverksstacken.

    Azure Databricks kan uppdatera de utgående IP-adresserna så ofta som en gång var 30:e dag. Uppdaterade IP-adresser blir aktiva så snart som 60 dagar efter publiceringen, så granska filen regelbundet och uppdatera listan över tillåtna innan aktiveringsfönstret stängs.

    Om du vill spåra ändringar mellan versioner sparar du efterföljande versioner av JSON-filen och jämför timestampSeconds värdet. Filtrera poster där:

    • Fältet service är Databricks
    • Fältet platform är azure
    • Fältet type är outbound

Skapa ett nytt meddelandemål

Så här konfigurerar du ett nytt meddelandemål

1. Klicka på ditt användarnamn i arbetsytans övre stapel och välj Inställningar i listrutan.
2. I avsnittet Arbetsyteadministratör klickar du på fliken Meddelanden.
3. Klicka på knappen Hantera .
4. Klicka på +Lägg till mål.
5. Välj en måltyp. Följande mål stöds för närvarande:
   • E-postmeddelande
   • Slak
   • Webhook, med valfri OAuth-autentisering (Beta)
   • Microsoft Teams
   • PagerDuty
6. Konfigurera målet baserat på typen.
7. Klicka på Skapa.

Webhook-nyttolaster

Tjänsten som skickar en notifikation definierar webhook-payloaden. För de payloads som jobb skickar, se HTTP webhook payloads. För den payload som Databricks SQL-varningar skickar efter en tillståndsändring, se SQL alert webhook payload.

Använd olika autentiseringsuppgifter för varje mål

Konfigurationen av ett mål lagras säkert krypterat i din Azure Databricks arbetsyta. För destinationer som kräver att du anger en URL eller inloggningsuppgifter rekommenderar Azure Databricks att använda olika uppgifter för varje konfigurerad destination. Detta begränsar effekten om en tredjeparts endpoint komprometteras. Dessa kan vara:

• Slack med hjälp av en webhook: URL:en som notisen skickas till.
• Microsoft Teams använder en webhook: URL:en som notisen skickas till.
• PagerDuty: integrationsnyckel som används för att dirigera meddelanden till en PagerDuty-tjänst unikt.
• Webhook: ett användarnamn och lösenord för HTTP Basic-autentisering, eller ett klient-ID och klienthemlighet för OAuth-autentisering (Beta).

Genom att använda olika hemligheter för varje konfigurerat mål kan du individuellt återkalla åtkomsten för enskilda aviseringsmål utan att påverka driften av alla andra mål i din Azure Databricks arbetsyta.

OAuth-autentisering för webhook-destinationer

Använd OAuth 2.0-klientuppgifter för att skicka notiser till en endpoint som kräver en åtkomsttoken. Azure Databricks hämtar token från din identitetsleverantör och använder den för att autentisera notifikationsförfrågan.

Din identitetsgivare måste stödja klientens inloggningsuppgifter. Både mottagaren och token-ändpunkten måste använda HTTPS.

För att skapa en OAuth-webhook-destination:

1. I Inställningar>Aviseringar klickar du på Hantera och sedan på +Lägg till mål.
2. Skriv in ett namn och välj Webhook för Typ.
3. För autentiseringsläge, välj OAuth.
4. Ange följande värden:
   • URL: Slutpunkten som tar emot notiser.
   • Klient-ID och klienthemlighet: De uppgifter som utfärdas av din identitetsleverantör.
   • Token endpoint URL: Den endpoint från vilken Azure Databricks får en åtkomsttoken.
   • Omfattning och målgrupp: Ange dessa valfria värden om det krävs av din identitetsleverantör. Separera flera teleskop med kommatecken.
5. Klicka på Skapa.

Klient-ID, klienthemlighet och token endpoint-URL krävs tillsammans. OAuth kan inte kombineras med HTTP Basic-autentisering.

För att verifiera konfigurationen, öppna destinationens trepunktsmeny och klicka på Test. Azure Databricks erhåller en åtkomsttoken och skickar en exempelnotis. Om testet misslyckas, kontrollera inloggningsuppgifter, scopes, målgrupp, mottagarbehörigheter och nätverksåtkomst till båda ändpunkterna.

Slack-destination

För att skapa en webhook-baserad Slack-destination, följ instruktionerna i Incoming webhooks för Slack. Klistra in den genererade URL:en i ditt Azure Databricks meddelandemål. För att använda Databricks Genie-appen istället, se Slack och Microsoft Teams Genie-appdestinationer.

Destinationer för appar för Slack och Microsoft Teams Genie

Använd Databricks Genie-appen för att koppla din Slack-arbetsyta eller Microsoft Teams-hyresgäst till din Azure Databricks-arbetsyta. Välj sedan en tillgänglig kanal som notifikationsdestination.

Du kan använda Genie-appens destinationer med följande funktioner:

• SQL-varningar: Slack och Microsoft Teams.
• Unity Catalog-åtkomstförfrågningar: Slack och Microsoft Teams.
• Model Servings slutpunktsaviseringar: Slack.

Skapa en Genie-app-destination

Innan du skapar en Genie-app-destination måste du installera Databricks Genie-appen för Slack eller Microsoft Teams, koppla den till din Azure Databricks-arbetsyta och lägga till den i kanalen som tar emot notiser. För detaljer om appinstallation och anslutningssteg, se Slack eller Microsoft Teams.

För att skapa en Genie-app-destination:

1. I Inställningar>Aviseringar klickar du på Hantera och sedan på +Lägg till mål.

2. För Typ, välj Slack eller Microsoft Teams, välj sedan Använda Databricks-appen.

3. Ange ett namn för destinationen.

4. Välj arbetsytan eller hyresgästen och kanalen:

   • För Slack, välj Slack Workspace och Channel.
   • För Microsoft Teams, välj hyresgäst och kanal. Hyresgästväljaren identifierar varje hyresgäst med de sista sex tecknen i dess hyresgäst-ID.

   Om inga Slack-arbetsytor eller Microsoft Teams-tenants är anslutna, klicka på Koppla en Slack-arbetsyta eller Koppla en Teams-tenant, respektive, och slutför Genie-appens installation. Gå tillbaka till destinationsformuläret och klicka på Uppdatera. Om du precis har lagt till Genie-appen i en kanal, klicka på Ladda kanaler för att uppdatera kanallistan.

5. Klicka på Skapa.

PagerDuty-destination

För att ställa in en PagerDuty-destination:

1. I PagerDuty, lägg till en integration i din tjänst och välj Events API V2-integrationstypen .
2. Kopiera integrationsnyckeln som PagerDuty genererar för integrationen.
3. I Azure Databricks klistrar du in integrationsnyckeln i aviseringsdestinationen i PagerDuty.

Lägga till en webhook i ett jobb

När du har konfigurerat mål kan du komma åt dem i ett jobbs jobbmeddelandeinställningar. Mer information finns i Lägg till meddelanden på ett jobb.

Varje jobb stöder upp till tre systemmål per händelsetyp. När du konfigurerar jobbaviseringar måste e-postadresser anges manuellt.

Begränsningar

Meddelandedestinationer har för närvarande följande begränsningar:

• Mål för e-postaviseringar har en gräns på 1 300 tecken för mottagarens adresslängd.
• För anpassade notifikationskroppar stöder icke-e-postdestinationer som Slack och Microsoft Teams inte HTML-formatering. Vissa aviseringsmål stöder markdown.
• För jobb måste e-postadressmål anges manuellt i jobbets inställningar.