Lägga till meddelanden i ett jobb

Artikel
01/22/2025

Du kan set upp meddelanden som ska skickas vid körningar av ett jobb och enskilda jobbaktiviteter för följande händelser:

Starta
Framgångsrikt slutförande
Misslyckande
Varaktigheten överskrider ett konfigurerat tröskelvärde

Du kan skicka meddelanden till en eller flera e-postadresser eller mål från tredje part, till exempel Slack, Microsoft Teams, PagerDuty eller någon webhook-baserad tjänst. I den här artikeln beskrivs olika sätt att set meddelanden på jobbnivå.

Lägg till systemdestinationer från tredje part

Du kan set upp meddelanden som ska levereras till system från tredje part. Systemdestinationer från tredje part integreras med populära meddelandeverktyg som inkluderar Slack, PagerDuty, Microsoft Teams och HTTP-webhooks. En administratör måste konfigurera systemmål.

Om du vill konfigurera systemmål går du till sidan administratörsinställningar, klickar på Redigera systemmeddelanden och klickar sedan på Skapa nytt mål. För varje jobb eller uppgift kan du konfigurera högst tre systemmål för varje meddelandehändelsetyp. Se sidan administratörsinställningar.

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 en specifik schema eller formatering för meddelanden rekommenderar Databricks att du konfigurerar en användardefinierad webhook.

Konfigurera meddelanden för ett jobb

Innan du börjar bör du tänka på följande:

Meddelanden på jobbnivå skickas inte när misslyckade uppgifter görs på nytt. Om du vill få ett felmeddelande efter varje misslyckad uppgift använder du aktivitetsaviseringar i stället. Om du vill lägga till meddelanden för aktivitetskörningar klickar du på Lägg till bredvid Meddelanden i aktivitetspanelen när du lägger till eller redigerar en jobbaktivitet.
För varje jobb eller uppgift kan du konfigurera högst tre systemmål för varje meddelandehändelsetyp.
Ett jobb som har slutförts i ett Lyckades med fel anses vara i ett lyckat tillstånd. Om du vill meddelas när jobb har slutförts i det här tillståndet måste du select Lyckades när du konfigurerar meddelanden.
Om du vill få ett meddelande när ditt jobb överskrider limiti varaktighet, måste du setlimit.

Om du vill lägga till en eller flera meddelanden när en jobbkörning börjar, slutförs eller misslyckas gör du följande:

I panelen för jobbinformation för ditt jobb, scrollar du ner till avsnittet Jobbmeddelanden, och klickar sedan på Redigera meddelanden.
I det nedre vänstra hörnet klickar du på Lägg till meddelande.
I Destination, selecte-postadress eller ett systemmål.
Select kryssrutorna för varje typ av händelse som du vill få ett meddelande om: Start, Lyckad, Fel, Varning om varaktighet, eller Direktuppspelning backlog.
Om du vill konfigurera ett annat mål klickar du på Lägg till meddelande igen och följer föregående steg.
När du har konfigurerat alla meddelanden klickar du på Spara.

Konfigurera meddelanden för långsamma jobb

Om du har konfigurerat en förväntad varaktighet för för en uppgiftkan du lägga till ett e-postmeddelande eller ett systemmeddelande om uppgiften eller jobbet överskrider det konfigurerade tröskelvärdet. Att få ett meddelande för ett jobb eller en uppgift som överstiger en tidsgräns, selectDuration Warning när du lägger till eller redigerar ett meddelande. Om du vill ta emot ett meddelande för ett jobb eller en aktivitet som överskrider ett mått för kvarvarande strömningsuppgifter selectkvarvarande 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 selectAvstänga meddelanden för överhoppade körningar eller Avstänga meddelanden för avbrutna körningar när du lägger till eller ändrar e-postmeddelanden eller systemaviseringar.

Som standard görs ett nytt försök med aktiviteter tre gånger innan de misslyckas helt. När du konfigurerar aktivitetsmeddelanden kan du selectStänga av meddelanden tills det senaste återförsöket att filtrera bort alla meddelanden tills det sista återförsöket.

Kommentar

När du selectStänger av meddelanden för överhoppade körningar eller stänger av meddelanden för avbrutna körningar för ett jobb, filtrerar det inte bort meddelanden som är konfigurerade för aktiviteter i jobbet. 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

Du kan konfigurera HTTP-webhooks så att de skickas på de händelser som anges i följande table.

Händelsetypkod	När skickas den?
`jobs.on_start`	Skickas när en körning startar.
`jobs.on_success`	Skickas när en körning stoppas och slutförs i ett lyckat tillstånd eller slutfördes med vissa fel.
`jobs.on_failure`	Skickas när en process stoppas i ett misslyckat tillstånd.
`jobs.on_duration_warning_threshold_exceeded`	Skickas när en körning har körts under mer än den konfigurerade förväntade varaktigheten.

Följande är exempel på nyttolaster som skickas av Azure Databricks till din konfigurerade slutpunkt. Dessa webhooks kan tillämpas på antingen jobb eller uppgifter.

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"
  }
}

Meddelande om fel vid jobbkörning

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

Meddelande om att en uppgift har körts framgångsrikt.

{
  "event_type": "jobs.on_success",
  "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"
  }
}

Dela via