Dela via

Lägga till e-post och systemaviseringar för jobbhändelser

  • Artikel

Du kan övervaka körningarna av ett jobb och de uppgifter som ingår i jobbet genom att konfigurera meddelanden när en körning startar, slutförs, misslyckas eller dess varaktighet överskrider ett konfigurerat tröskelvärde. Meddelanden kan skickas till en eller flera e-postadresser eller systemmål som Slack, Microsoft Teams, PagerDuty eller någon webhook-baserad tjänst.

Konfigurera systemmeddelanden

Kommentar

  • För varje jobb eller uppgift kan du konfigurera högst tre systemmål för varje meddelandehändelsetyp.
  • En administratör måste konfigurera systemmål. Systemmål konfigureras genom att välja Skapa nytt mål i dialogrutan Redigera systemaviseringar eller på sidan administratörsinställningar.
  • Meddelanden som du anger på jobbnivå skickas inte när misslyckade uppgifter görs på nytt. Om du vill få ett felmeddelande efter varje misslyckad uppgift (inklusive varje misslyckat nytt försök) använder du i stället uppgiftsmeddelanden. Om du vill lägga till systemmeddelanden för aktivitetskörningar klickar du på + Lägg tillbredvid Meddelanden i aktivitetspanelen när du lägger till eller redigerar en jobbaktivitet.
  • Ett jobb som har slutförts i ett Succeeded with failures tillstånd anses vara i ett lyckat tillstånd. Om du vill ta emot aviseringar för jobb som har slutförts i det här tillståndet måste du välja Lyckades när du konfigurerar aviseringar.

Systemaviseringar integreras med populära meddelandeverktyg, inklusive:

Om du vill lägga till en eller flera systemmeddelanden när körningar av det här jobbet har en notifierbar händelse, till exempel en jobbstart, slutförande eller ett fel:

  1. I panelen Jobbinformation för ditt jobb klickar du på Redigera meddelanden.
  2. Klicka på Lägg till meddelande och välj ett systemmål i Mål.
  3. I Välj ett systemmål väljer du ett mål och klickar på kryssrutan för varje meddelandetyp som ska skickas till målet.
  4. Om du vill lägga till ett annat mål klickar du på Lägg till meddelande igen.
  5. Klicka på Bekräfta.

Viktigt!

Innehållet i Slack- och Microsoft Teams-meddelanden kan ändras i framtida versioner. Du bör inte implementera klienter eller bearbetning som är beroende av det specifika innehållet eller formateringen av dessa meddelanden. Om du behöver ett specifikt schema eller formatering för meddelanden rekommenderar Azure Databricks att du konfigurerar en användardefinierad webhook.

Konfigurera e-postaviseringar

Kommentar

  • Meddelanden som du anger på jobbnivå skickas inte när misslyckade uppgifter görs på nytt. Om du vill få ett felmeddelande efter varje misslyckad uppgift (inklusive varje misslyckat nytt försök) använder du i stället uppgiftsmeddelanden. Om du vill lägga till e-postaviseringar för aktivitetskörningar klickar du på + Lägg tillbredvid Meddelanden i aktivitetspanelen när du lägger till eller redigerar en jobbaktivitet.
  • Ett jobb som har slutförts i ett Succeeded with failures tillstånd anses vara i ett lyckat tillstånd. Om du vill ta emot aviseringar för jobb som har slutförts i det här tillståndet måste du välja Lyckades när du konfigurerar aviseringar.

Så här lägger du till en eller flera e-postadresser för att meddela när körningar av det här jobbet börjar, slutförs eller misslyckas:

  1. I panelen Jobbinformation för ditt jobb klickar du på Redigera meddelanden.
  2. Klicka på Lägg till meddelande och välj E-postadress i Mål.
  3. Ange en e-postadress och klicka på kryssrutan för varje meddelandetyp som ska skickas till den adressen.
  4. Om du vill ange en annan e-postadress för avisering klickar du på Lägg till avisering igen.
  5. Klicka på Bekräfta.

Du kan använda e-postaviseringar för att integrera med verktyg som Amazon SES och SNS.

Konfigurera meddelanden när ett tröskelvärde överskrids

Om du har konfigurerat ett tröskelvärde för ett jobb eller en uppgift, till exempel mått för varaktighet eller strömmande eftersläpning, kan du lägga till ett e-postmeddelande eller ett systemmeddelande om jobbet eller uppgiften överskrider det konfigurerade tröskelvärdet. Om du vill få ett meddelande för ett jobb eller en aktivitet som överskrider ett tröskelvärde för varaktighet klickar du på kryssrutan för Varaktighetsvarning när du lägger till eller redigerar ett meddelande. Om du vill få ett meddelande om ett jobb eller en aktivitet som överskrider ett mått för kvarvarande uppgifter för direktuppspelning klickar du på kryssrutan för kvarvarande uppgifter för direktuppspelning när du lägger till eller redigerar ett meddelande.

Följande gäller för mått för strömningseftersläpning:

  • Meddelanden skickas när den genomsnittliga kvarvarande informationen under en period på 10 minuter överskrider det definierade tröskelvärdet.
  • För att förhindra överdrivna meddelanden väntar Azure Databricks 30 minuter innan du avgör om ett annat meddelande ska skickas. Även om eftersläpningen fortsätter vara hög får du uppdateringar med 30 minuters intervall.

Filtrera bort meddelanden för överhoppade eller avbrutna körningar

Du kan minska antalet aviseringar som skickas genom att filtrera bort meddelanden när en körning hoppas över eller annulleras. Om du vill filtrera meddelanden kontrollerar du Stänga av meddelanden för överhoppade körningar eller Stänga av aviseringar för avbrutna körningar när du lägger till eller ändrar e-postaviseringar eller systemaviseringar.

Kommentar

Om du väljer Stäng av aviseringar för överhoppade körningar eller Stänga av aviseringar för avbrutna körningar för ett jobb filtreras inte meddelanden som konfigurerats för jobbaktiviteter bort. Om du vill filtrera alla meddelanden för överhoppade eller avbrutna körningar måste du också filtrera bort alla meddelanden på aktivitetsnivå som du har konfigurerat.

HTTP webhook nyttolaster

Om du använder en HTTP-webhook för att skicka meddelanden är följande exempel på nyttolaster som skickas av Azure Databricks till din konfigurerade slutpunkt.

Meddelande för en starthändelse för jobbkörning:

{
  "event_type": "jobs.on_start",
  "workspace_id": "your_workspace_id",
  "run": {
    "run_id": "run_id"
  },
  "job": {
    "job_id": "job_id",
    "name": "job_name"
  }
}

Meddelande för en starthändelse för aktivitetskörning:

{
  "event_type": "jobs.on_start",
  "workspace_id": "your_workspace_id",
  "task": {
    "task_key": "task_name"
  },
  "run": {
    "run_id": "run_id_of_task"
    "parent_run_id": "run_id_of_parent_job_run"
  },
  "job": {
    "job_id": "job_id",
    "name": "job_name"
  }
}

När du konfigurerar mål kan webhooks konfigureras för följande händelsetyper:

Händelsekod När skickas den?
jobs.on_start En körning startar.
jobs.on_success En körning stoppas och slutförs i ett lyckat eller lyckat tillstånd med feltillstånd.
jobs.on_failure En körning stoppas i ett misslyckat tillstånd.
jobs.on_duration_warning_threshold_exceeded En körning har körts under mer än den konfigurerade förväntade varaktigheten.