Naar hoofdinhoud gaan
Het AppSignal voor Elixir-pakket instrumenteert jobs die worden uitgevoerd door Oban-workers en verzamelt metrics over de performance van uw jobs. Oban is een systeem voor job-queueing en -verwerking voor Elixir, gebaseerd op PostgreSQL en Ecto. U kunt Oban gebruiken om jobs in te plannen om in de achtergrond te draaien.

​
Automatische instrumentatie

Oban-ondersteuning wordt automatisch geïnstrumenteerd, zonder dat er configuratie nodig is. Om de Oban-instrumentatie uit te schakelen, stelt u de configuratieoptie instrument_oban in op false.
🔎 De configuratieoptie instrument_oban is toegevoegd in versie 2.5.1 van de AppSignal voor Elixir-integratie.

​
Foutrapportage

Standaard creëert de Oban-instrumentatie een foutsample wanneer een van uw workers er niet in slaagt een job te verwerken, hetzij door een {:error, _}-tuple te retourneren, hetzij door een uitzondering op te werpen. Als u alleen fouten naar AppSignal wilt sturen wanneer de fout ertoe leidt dat de job wordt weggegooid, dat wil zeggen zodra het maximum aantal opnieuw-proberen is bereikt, stel dan de configuratieoptie report_oban_errors in op "discard". Stel deze in op "none" om nooit Oban-jobfouten naar AppSignal te sturen.
De configuratieoptie report_oban_errors is toegevoegd in versie 2.5.1 van de AppSignal voor Elixir-integratie.Bij gebruik van Oban-versie 2.3.1 of lager is de informatie over de status van de job niet beschikbaar en gedraagt de optie "discard" zich als "all".

​
Performance- en error samples

AppSignal creëert performance samples van jobs die door uw Oban-workers worden uitgevoerd: Performance sample van een Oban-jobuitvoering Het rapporteert ook fouten die ervoor zorgen dat uw workers falen tijdens het verwerken van een job: Error sample van een Oban-jobuitvoering Binnen de performance- en error samples bevatten de tags informatie over de job:
  • Job-ID, queue, worker en priority
  • Aantal eerdere pogingen
  • Jobstatus en resultaat na uitvoering
Eventuele tags of metadata-waarden die aan de job worden toegevoegd, zullen ook als tags in de sample aanwezig zijn, zodat u de samples voor een specifieke tag kunt filteren. U kunt ook zien wanneer een Oban-job wordt ingevoegd in de event timeline van de performance samples van uw applicatie: Event timeline met een Oban-jobinvoeging
🔎 Sommige functies zijn alleen beschikbaar in bepaalde Oban-versies:
  • 2.1.0+: Tags
  • 2.3.1+: Metadata-waarden en job priority
  • 2.4.0+: Jobstatus na uitvoering
  • 2.5.0+: Jobresultaat na uitvoering
  • 2.11.0+: Job-invoegingsevent
Om gebruik te maken van alle hierboven beschreven functies, upgrade naar de nieuwste Oban-versie.

​
Metrics

Naast de performance- en error samples verzamelt AppSignal voor Elixir metrics over de performance van uw Oban-jobs:
  • oban_job_duration: de duur van de verwerkte jobs, getagd met de worker, queue en status van de job.
  • oban_job_queue_time: de tijd die jobs in de queue hebben doorgebracht, getagd met queue.
  • oban_job_count: het aantal verwerkte jobs, getagd met de worker, queue en status van de job.
Met behulp van deze metrics maakt AppSignal automatisch het Oban magic dashboard aan, dat belangrijke inzichten biedt in de performance van uw Oban-systeem: Magic dashboard met belangrijke Oban-metrics