Skip to Content

Monitoringalerts omzetten in taken

Laat je monitoringtool alerts naar CodeLynq sturen, zodat productieproblemen bugtaken worden - en desgewenst automatisch een bewaakte fix krijgen.

Als er iets misgaat in productie, weet je monitoringtool het meestal als eerste. Een alertbron geeft die tool een URL om alerts naartoe te sturen. Elke nieuwe alert wordt een bugtaak in het project, met de details van de alert erin. Herhalingen van dezelfde alert worden samengevoegd in die taak, in plaats van steeds een nieuwe taak te maken.

Alertbronnen toevoegen en verwijderen is voor beheerders van de organisatie en de eigenaar van het project.

Een alertbron toevoegen

  1. Open het project, ga naar Instellingen en kies Alerts (onder Beheer).
  2. Klik op Alertbron toevoegen.
  3. Vul in:
    • Naam: bijvoorbeeld de tool en de omgeving, zoals Sentry (prod).
    • Repository (optioneel): de repository waar de alerts over gaan, of Elke repository (standaard van het project).
    • Ontdubbelvenster (minuten): herhalingen van dezelfde alert binnen dit venster worden samengevoegd in de bestaande taak. Standaard is dat een dag (1440 minuten).
    • Auto-run (bewaakt herstel) en Max. auto-runs per uur: zie hieronder.
  4. Klik op Aanmaken.
  5. Kopieer de Ingest-URL met URL kopiëren. Hij wordt maar één keer getoond; ben je hem kwijt, verwijder dan de bron en maak een nieuwe aan.

Alerts versturen

Stel je monitoringtool zo in dat hij een POST-verzoek met een JSON-body naar de ingest-URL stuurt. CodeLynq leest deze velden als ze er zijn:

VeldGebruikt voor
title, message of errorDe titel van de taak en het werkelijke gedrag
stack, stacktrace of stack_traceDe stack trace op de taak
severity, level, priority of labels.severityDe prioriteit: critical/fatal worden Kritiek, error/high Hoog, warning Gemiddeld, info/low Laag. Zonder herkenbare severity wordt de taak Gemiddeld
service of environmentVergelijkbare alerts uit elkaar houden
fingerprintWelke alerts als dezelfde tellen

De volledige alert komt ook in de beschrijving van de taak, zodat er niets verloren gaat.

Zonder fingerprint leidt CodeLynq er zelf een af uit de titel, de service en de eerste regel van de stack trace. Stuur je eigen fingerprint mee als je tool alerts al groepeert.

Wat je krijgt

Elke nieuwe alert maakt een taak van het type Bug aan met de titel [alert] …, met de alert in de beschrijving en de stack trace en foutmelding in de bugmelding. Daarna is het een gewone taak: bekijk hem, keur het plan goed en start een run - zie Taken.

Auto-run: een bewaakte automatische fix

Staat Auto-run (bewaakt herstel) aan, dan kan een alert meteen een fix starten. Dat gebeurt alleen als aan alles hieronder is voldaan:

  • de alert heeft prioriteit hoog of kritiek,
  • het project heeft een verificatiecommando, zodat een fix die de tests breekt niet kan slagen - zie Kwaliteitscontroles,
  • deze bron heeft zijn Max. auto-runs per uur nog niet bereikt (0 zet auto-run uit),
  • de limieten van je abonnement en je uitgavenlimieten laten de run toe zonder dat iemand hem hoeft goed te keuren.

Klopt een van deze niet, dan blijft de taak gewoon liggen tot iemand hem oppakt. Een automatische fix eindigt altijd in een pull request voor review. CodeLynq merget die nooit zelf.

Bronnen beheren

De lijst toont elke bron met zijn ontdubbelvenster en of auto-run aanstaat. Verwijderen haalt een bron weg; de ingest-URL werkt dan meteen niet meer.

Test het op een taak uit je eigen backlog

Stuur ons één echte taak. Wij draaien CodeLynq op jouw repository en jij reviewt de pull request. Gratis, binnen 5 werkdagen nadat je de spec hebt goedgekeurd.