Értesítési célhelyek kezelése

Ez a lap bemutatja, hogyan hozhat létre és konfigurálhat értesítési célhelyeket a munkaterülethez.

A rendszerértesítések olyan üzenetek, amelyek arról tájékoztatnak, hogy a munkafolyamat mikor tapasztal futási eseményt (indítás, siker és hiba). Alapértelmezés szerint az értesítések a felhasználói e-mail címekre kerülnek, de az adminok alternatív értesítési célpontokat konfigurálhatnak webhooks vagy a Databricks Genie alkalmazás segítségével a Slack és a Microsoft Teams (Beta) számára. Ez lehetővé teszi, hogy eseményvezérelt integrációkat hozzon létre Azure Databricks.

A rendszergazdák úgy is konfigurálhatják az értesítési célhelyeket, hogy hozzáférési kéréseket kapjanak a munkaterület felhasználóitól, például a Unity Catalog-objektumokra vonatkozó jogosultsági kéréseket.

Az értesítési célhelyek kezeléséhez Azure Databricks munkaterület-rendszergazdának kell lennie. A célhely konfigurálása után az összes felhasználó számára elérhetővé válik.

Hálózati követelmények

Webhook-alapú célpontok esetén a fogadó végpontnak az alábbi követelményeknek kell megfelelnie:

  • Azure Databricks kényszeríti a HTTPS használatát a biztonság érdekében. Az értesítési célhelynek megbízható hitelesítésszolgáltató által aláírt Secure Sockets Layer (SSL) tanúsítványokat kell használnia.
  • Az értesítési célhelynek hozzá kell adnia a munkaterület vezérlősíkját és az adatsík kimenő IP-címét az engedélyezési listához:

    • A vezérlősík-webalkalmazás IP-címeivel kapcsolatban lásd: IP-címek és tartományok Azure Databricks szolgáltatásokhoz és objektumokhoz.

    • Az adatsík kimenő IP-címeit a ip-ranges.json Azure Databricks közzétett fájlban tekintheti meg. Keresse meg a munkaterület adatsík-régióját a fájlban, és engedélyezze a megfelelő kimenő IP-címeket a hálózati veremben.

      Azure Databricks 30 naponta egyszer frissítheti a kimenő IP-címeket. A frissített IP-címek a közzétételt követő 60 napon belül aktiválódnak, ezért tekintse át rendszeresen a fájlt, és frissítse az engedélyezési listát az aktiválási ablak bezárása előtt.

      A kiadások közötti változások nyomon követéséhez mentse a JSON-fájl egymást követő verzióit, és hasonlítsa össze az timestampSeconds értéket. Olyan bejegyzések szűrése, ahol:

      • A service mező a következő: Databricks
      • A platform mező a következő: azure
      • A type mező a következő: outbound

Új értesítési cél létrehozása

Új értesítési célhely konfigurálása

  1. Kattintson a felhasználónevére a munkaterület felső sávjában, és válassza Beállítások lehetőséget a legördülő menüből.
  2. A Munkaterület rendszergazdája szakaszban kattintson az Értesítések fülre.
  3. Kattintson a Kezelés gombra.
  4. Kattintson a +Cél hozzáadása elemre.
  5. Válasszon egy céltípust. Jelenleg a következő célhelyek támogatottak:
  6. Konfigurálja a célhelyet a típus alapján.
  7. Kattintson a Létrehozás.

Webhook payloadok

Az értesítést küldő szolgáltatás határozza meg a webhook payloadját. A feladatok által küldött payloadokról lásd: HTTP webhook payloads. A Databricks SQL értesítései által az állapotváltozás után küldött payloadról lásd: SQL alert webhook payload.

Különböző hitelesítő adatok használata minden célhelyhez

A célhely konfigurációját a rendszer biztonságosan titkosítva tárolja a Azure Databricks munkaterületen. Olyan célpontoknál, amelyekhez URL-t vagy credential-et kell megadni, az Azure Databricks azt javasolja, hogy minden konfigurált célhoz külön hitelesítést használjunk. Ez korlátozza a hatást, ha egy harmadik féltől származó végpont sérül. Ezek közé tartoznak:

  • Slack webhook használatával: az URL, amelyre az értesítés érkezik.
  • Microsoft Teams-webhook használatával: az URL, amelyre az értesítést küldik.
  • PagerDuty: az értesítések PagerDuty szolgáltatásba való egyedi átirányításához használt integrációs kulcs.
  • Webhook: felhasználónév és jelszó HTTP Basic hitelesítéshez, vagy ügyfélazonosító és ügyfél titok az OAuth hitelesítéshez (Beta).

Az egyes konfigurált célhelyek különböző titkos kulcsainak használatával egyenként visszavonhatja az egyes értesítési célhelyek elérését anélkül, hogy ez hatással lenne a Azure Databricks-munkaterület többi célhelyének működésére.

OAuth hitelesítés webhook célpontokhoz

Important

Ez a funkció bétaverzióban érhető el. A használatához a munkaterület egyik rendszergazdájának engedélyeznie kell a Destination Type Generic Webhook Oauth lehetőséget a Previews oldalon. Lásd: Munkaterületszintű előzetes verziók kezelése.

Használd az OAuth 2.0 kliensazonosítókat, hogy értesítéseket küldj egy olyan végpontnak, amelyhez hozzáférési tokent kell írni. Az Azure Databricks megszerzi a tokent az identitásszolgáltatójától, és azt használja az értesítési kérés hitelesítésére.

Az identitásszolgáltatójának támogatnia kell az ügyfél hitelesítési engedélyét. Mind a fogadó végpontnak, mind a token végpontnak HTTPS-t kell használnia.

OAuth webhook célpont létrehozásához:

  1. A Beállítások>értesítésekbenkattints a Kezelésre, majd +Cél hozzáadására.
  2. Írj be egy nevet, és válaszd a Webhooktípust.
  3. Az Authentication módhoz válassza az OAuth-t.
  4. Adja meg a következő értékeket:
    • URL: Az a végpont, amely értesítéseket kap.
    • Ügyfélazonosító és ügyfél titkos: Az identitásszolgáltatód által kiadott hitelesítések.
    • Token endpoint URL: Az a végpont, ahonnan az Azure Databricks hozzáférési tokent szerz.
    • Hatótávolságok és közönség: Adja meg ezeket az opcionális értékeket, ha az identitásszolgáltatód megkéri. A több hatókört vesszővel válaszd el.
  5. Kattintson a Létrehozás.

Az ügyfélazonosítót, az ügyféltitkot és a tokenvégpont URL-jét együtt kötelező megadni. Az OAuth nem kombinálható HTTP Basic hitelesítéssel.

A konfiguráció ellenőrzéséhez nyisd meg a célállomás hárompontos menüjét, és kattints a Teszt gombra. Azure Databricks hozzáférési tokent szerz és mintaértesítést küld. Ha a teszt megbukik, ellenőrizd a hitelesítéseket, hatókkört, közönséget, vevői jogosultságokat és mindkét végponthoz való hálózati hozzáférést.

Slack célpont

Webhook-alapú Slack célpont beállításához kövesse az Incoming webhooks for Slack utasításait. Illessze be a létrehozott URL-címet a Azure Databricks értesítési célhelyére. A Databricks Genie alkalmazás használatához lásd a Slack és a Microsoft Teams Genie alkalmazás helyszíneit.

Slack és Microsoft Teams Genie alkalmazáscélok

Important

Ez a funkció bétaverzióban érhető el. A használatához a munkaterület adminisztrátorának be kell kapcsolnia a Destination Type Databricks App Slack vagy a Destination Type Databricks App Teams opciókat az Előzetes oldalon . Lásd: Munkaterületszintű előzetes verziók kezelése.

Használja a Databricks Genie alkalmazást, hogy a Slack munkaterületét vagy Microsoft Teams bérlőjét összekapcsolja az Azure Databricks munkaterületével. Ezután válassz egy elérhető csatornát értesítési célpontként.

A Genie alkalmazáscélokat a következő funkciókkal használhatod:

Létrehozz egy Genie alkalmazás célpontot

Mielőtt létrehoznád a Genie alkalmazás célpontját, telepítened kell a Databricks Genie alkalmazást a Slack vagy Microsoft Teams számára, csatlakoztatnod az Azure Databricks munkaterületedhez, és hozzá kell adnod arra a csatornára, amely értesítéseket kap. Az alkalmazás telepítéséről és a csatlakozási lépésekről a részletekért lásd a Slack vagy a Microsoft Teams oldalt.

Genie alkalmazás célpontjának létrehozásához:

  1. A Beállítások>értesítésekbenkattints a Kezelésre, majd +Cél hozzáadására.

  2. A Típus mellett válaszd a Slack vagy a Microsoft Teams menüpontot, majd a Databricks alkalmazással való használatot.

  3. Írj be egy nevet a célállomásra.

  4. Válaszd ki a munkaterületet vagy bérlőt és a csatornát:

    • A Slackhoz válaszd ki a Slack-munkaterületet és a csatornát.
    • Microsoft Teams esetén válassza ki a Bérlő és a Csatorna elemet. A bérlőválasztó minden bérlőt a bérlőazonosító utolsó hat karakter alapján azonosítja.

    Ha nincs Slack munkaterület vagy Microsoft Teams bérlő csatlakoztatva, kattintson a Slack munkaterület vagya Teams bérlő csatlakoztatására, és fejezze be a Genie alkalmazás beállítását. Térj vissza a cél űrlaphoz, és kattints a Frissítés gombra. Ha csak hozzáadtad a Genie alkalmazást egy csatornához, kattints a Reload csatornákra , hogy frissítsd a csatornalistát.

  5. Kattintson a Létrehozás.

PagerDuty célállomás

PagerDuty célpont beállításához:

  1. A PagerDuty-ban adj hozzá egy integrációt a szolgáltatásodhoz, és válaszd ki az Events API V2 integrációs típust.
  2. Másold le az integrációs kulcsot, amelyet PagerDuty generál az integrációhoz.
  3. Az Azure Databricks-ben beillesztsd az integrációs kulcsot a PagerDuty értesítési célállomásba.

Webhook hozzáadása feladathoz

A célhelyek konfigurálása után elérheti őket a feladatok feladatértesítési beállításaiban. További információ: Értesítések hozzáadása feladathoz.

Minden feladat eseménytípusonként legfeljebb három rendszercélt támogat. Feladatértesítések konfigurálásakor manuálisan kell megadni az e-mail-címeket.

Korlátozások

Az értesítési célhelyekre jelenleg a következő korlátozások vonatkoznak:

  • Az e-mail-értesítések célhelyei 1300 karakteres korlátot szabnak a címzett címhosszára.
  • Egyéni értesítéstörzsek esetén az e-mailen kívüli célhelyek, például a Slack és a Microsoft Teams, nem támogatják a HTML-formázást. Egyes értesítési célhelyek támogatják a markdownt.
  • Feladatok esetén az e-mail-célhelyeket manuálisan kell beállítani a feladat beállításai között.
  • Utolsó frissítés időpontja: