Handleiding
Een event-trigger maken
Maak een event-trigger, zodat een extern event zoals een alert of een script een agent-run start met het event erbij.
Een event-trigger start een agent-run vanuit een extern event. Richt een webhook, zoals een Sentry-alertregel, een GitHub Action of elk script, op de trigger-URL. De gekozen agent pakt het op met de event-payload erbij.
Voordat je begint
- Nodig
- Een project en een agent die de run uitvoert
- Duur
- Ongeveer 5 minuten
Open het tabblad Event-triggers
Kies Automatiseringen in het menu en open het tabblad Event-triggers. Je kunt ook het tabblad Automatiseringen van een project openen.
Maak de trigger
Klik op Nieuwe event-trigger. Vul een Naam in, bijvoorbeeld "Sentry foutpercentage-alert". Beschrijf bij Instructies wat de agent moet doen als de trigger afgaat. Kies de Agent en het Project. Stel de Afkoelperiode (seconden) in: nadat een run start, worden verdere events zo lang genegeerd. De standaard is 300 seconden. Sla de trigger op. Hij toont nu een URL en een Secret.
Stuur een event
Stuur een POST met een JSON-body naar de URL. Zet het secret in een Authorization: Bearer-header.
curl -X POST "$TRIGGER_URL" \
-H "Authorization: Bearer $TRIGGER_SECRET" \
-H "Content-Type: application/json" \
-d '{"alert": "foutpercentage boven 5%"}'Het antwoord is 202 met featureRequestId. De run verschijnt onder Recente uitvoeringen van de trigger. De payload wordt als JSON aan je instructies toegevoegd, afgekapt na 8 KB.
Overgeslagen events
Start een trigger geen run, dan is het antwoord 200 met een veld skipped: inactive voor een gepauzeerde trigger, in_flight zolang er nog een run actief is en cooldown tijdens de afkoelperiode. Het volledige contract, inclusief de X-DXV-Event-Key-header die dit per sleutel afbakent, staat in Run hooks API.
Een trigger beheren
Je kunt een trigger Pauzeren en Hervatten. Met Secret vernieuwen werkt het oude secret direct niet meer. De URL blijft hetzelfde, dus pas het secret alleen aan waar je de events vandaan stuurt. Alleen als je de trigger verwijdert, werkt zijn URL niet meer. Bestaande verzoeken blijven zoals ze zijn.
Gerelateerd
Laatst bijgewerkt op