Check: Achtergrondverwerking (`background-jobs`)

Deze check verschijnt in het Health Check Overzicht onder de naam background-jobs.

Wat controleert deze check?

Serverbeschikbaarheid – Is er minimaal één Hangfire-server actief?
Gefaalde jobs – Ligt het aantal gefaalde jobs onder de drempel van 5?

Achtergrondprocessen

Als Hangfire uitvalt, stoppen de volgende geautomatiseerde processen:

Proces	Frequentie	Impact
IAM medewerker-synchronisatie	Elke 15 minuten	HR-systeem → Microsoft 365 koppeling valt weg; nieuwe of gewijzigde medewerkers worden niet gesynchroniseerd
IAM-metrics	Dagelijks / maandelijks	Statistieken over gebruikers per tenant worden niet bijgewerkt
Gedeelde mailbox-synchronisatie	Elke 4 uur	Wijzigingen aan gedeelde mailboxen worden niet doorgevoerd
Tenant-info synchronisatie	Elk uur	Tenant-configuraties worden niet bijgewerkt
Autopilot apparaat-synchronisatie	Elk uur	Nieuwe apparaten worden niet geregistreerd in Autopilot
Workflow-automatisering	Event-gedreven	Triggers voor medewerker in-dienst/uit-dienst flows worden niet uitgevoerd
Audit log opruiming	Dagelijks	Verlopen audit logs worden niet verwijderd; dit heeft geen directe gebruikersimpact

Respons-interpretatie

Healthy

{
  "status": "Healthy",
  "description": "Achtergrondverwerking is operationeel. Alle geplande taken draaien: IAM-synchronisatie, workflow-automatisering, tenant-sync, Autopilot-synchronisatie en mailbox-sync zijn actief.",
  "data": {
    "FailedJobs": 0,
    "AvailableServers": 1,
    "MinRequiredServers": 1
  }
}

Geen actie vereist.

Unhealthy – Te veel gefaalde jobs

{
  "status": "Unhealthy",
  "description": "Achtergrondverwerking verstoord: 6 gefaalde jobs (drempel: 5). Mogelijk getroffen processen: IAM medewerker-synchronisatie, workflow-automatisering, mailbox- en apparaatsynchronisatie.",
  "data": {
    "FailedJobs": 6
  }
}

De achtergrondverwerking loopt, maar meerdere jobs zijn mislukt. Controleer het Hangfire-dashboard in de AutoMate API (/hangfire) voor details over welke jobs zijn gefaald en waarom.

Unhealthy – Geen server beschikbaar

{
  "status": "Unhealthy",
  "description": "Geen Hangfire-server beschikbaar. Alle achtergrondtaken zijn gestopt: IAM medewerker-synchronisatie, workflow-triggers, Autopilot-synchronisatie, gedeelde mailbox-sync en audit log opruiming worden niet uitgevoerd.",
  "data": {
    "AvailableServers": 0,
    "MinRequiredServers": 1
  }
}

Er draait geen Hangfire-server. Alle achtergrondtaken staan stil. Dit is een kritieke situatie die directe actie vereist.

Escalatie-richtlijn

Eerste lijn

Situatie	Actie
Healthy	Geen actie vereist
Unhealthy – gefaalde jobs	Log het incident, controleer of het probleem zich herhaalt bij de volgende check. Bij aanhoudende meldingen: escaleer naar tweede lijn
Unhealthy – geen server	Escaleer direct naar tweede lijn

Tweede lijn

Bij te veel gefaalde jobs:

Open het Hangfire-dashboard via /hangfire op de AutoMate API
Bekijk de gefaalde jobs en de foutmelding
Herstart mislukte jobs handmatig als de oorzaak bekend en verholpen is
Als jobs structureel falen: onderzoek de onderliggende oorzaak (configuratie, externe afhankelijkheden, database)

Bij geen server beschikbaar:

Controleer of de AutoMate API-instantie draait en bereikbaar is
Controleer de applicatielogboeken in Application Insights op opstartfouten
Herstart de API-instantie indien nodig
Verifieer na herstart of de health check terugkeert naar Healthy

Last modified: 23 March 2026