HTTP-triggers in Azure SRE-agent

HTTP-triggers in Azure SRE Agent zijn webhookeindpunten die externe systemen gebruiken om uw agent op aanvraag aan te roepen. Wanneer een CI/CD-pijplijn (continue integratie en continue levering) mislukt, detecteert een waarschuwingsprogramma een anomalie of verzendt een HTTP-client een POST aanvraag, ontvangt de agent de gebeurteniscontext en werkt deze onmiddellijk.

Het probleem: waarschuwingen en pijplijnfouten hebben handmatige sortering nodig

Uw team heeft al hulpprogramma's voor waarschuwingen, waarneembaarheid en werkstroom, zoals Datadog, Dynatrace, Jira, Splunk en Grafana, en CI/CD-pijplijnen die breken. Wanneer er iets misgaat, is het antwoord elke keer hetzelfde:

• Een technicus wordt gepaginad: De technicus opent het bewakingsprogramma, leest de waarschuwing en opent vervolgens handmatig logboeken, metrische gegevens en implementatiegeschiedenis op meerdere dashboards om erachter te komen wat er is gebeurd.
• Een pijplijn mislukt: Iemand moet stoppen wat ze doen, de build-uitvoer controleren, correleren met recente wijzigingen en beslissen of ze terugdraaien of vooruit moeten herstellen.
• Context is verspreid: De Datadog-waarschuwing zegt: 'CPU-piek op prod-api'. De hoofdoorzaak vereist het correleren van logboeken van drie services, het controleren van recente implementaties en het controleren van Dynatrace-traceringen.

Hoe HTTP-triggers werken

Met HTTP-triggers kunt u elk hulpprogramma dat webhooks ondersteunt rechtstreeks verbinden met uw exemplaar van SRE Agent. In plaats van dat een engineer handmatige triage uitvoert, vertelt het systeem dat het probleem heeft gedetecteerd, of het nu gaat om een Datadog-waarschuwing, een Dynatrace-anomalie, een Jira-werkstroomovergang of een pijplijnfout, de agent om het te onderzoeken. De context wordt automatisch doorgegeven.

Elke trigger is een benoemd webhook-eindpunt op uw agent met een unieke URL. Wanneer een extern systeem die URL aanroept via HTTP POST, voert de agent de geconfigureerde prompt van de trigger uit, die is verrijkt met JSON-gegevens in de aanvraagbody.

belangrijke concepten

Een trigger aanroepen

Roep de trigger-URL aan met een HTTP-aanvraag POST :

curl -X POST \
  https://your-agent.sre.azure.com/api/v1/httptriggers/trigger/<TRIGGER_ID> \
  -H "Authorization: Bearer <ARM_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "datadog",
    "alert_title": "High error rate on checkout-api",
    "severity": "critical",
    "service": "checkout-api",
    "region": "eastus2",
    "metric": "error_rate",
    "value": "8.2%",
    "threshold": "5%"
  }'

De JSON-hoofdtekst is optioneel. Als u gebruikmaakt van de trigger zonder hoofdtekst, draait de agent met alleen de geconfigureerde prompt van de trigger. Met een overzicht ziet de agent zowel de prompt als de gegevens die u verzonden heeft.

Authenticatie voor trigger-aanroep

Voor het triggereindpunt is een Azure Resource Manager Bearer-token in de Authorization: Bearer <TOKEN> header vereist. De aanroeper heeft Microsoft.App/agents/threads/write toestemming nodig voor de agentresource.

Manieren om een token te verkrijgen

Verbinding maken met externe hulpprogramma's die geen ondersteuning bieden voor Azure-verificatie

Tools zoals Datadog, Dynatrace, Jira en Splunk verzenden webhooks met hun eigen authenticatieformaten, niet met Azure Resource Manager-tokens. Gebruik een van de volgende tussenpersonen om de kloof te overbruggen.

Antwoord

{
  "message": "HTTP trigger execution initiated",
  "executionTime": "2026-03-13T10:30:00Z",
  "threadId": "thread-abc123",
  "success": true
}

De trigger retourneert ONMIDDELLIJK HTTP 202 (Geaccepteerd). De agent verwerkt de aanvraag asynchroon.

Wat maakt deze benadering anders

HTTP-triggers verbinden uw bestaande waarschuwings- en CI/CD-hulpprogramma's rechtstreeks met uw agent zonder technicus in de lus. Het systeem dat het probleem heeft gedetecteerd, vertelt de agent te onderzoeken en geeft automatisch de volledige context door. Er is geen paging, geen dashboardwisseling en geen handmatige contextverzameling.

Voor en na

Geplande taken versus HTTP-triggers

Gebruik beide samen. Gebruik geplande taken voor proactieve bewaking en HTTP-triggers voor reactieve gebeurtenisafhandeling.

Gebruikssituaties

Integratie van CI/CD-pijplijn

Wanneer een implementatiepijplijn mislukt, roept u de agent aan om de fout te analyseren:

# In your pipeline's failure handler
curl -X POST "$AGENT_TRIGGER_URL" \
  -H "Authorization: Bearer $ARM_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"pipeline\": \"$PIPELINE_NAME\", \"run_id\": \"$RUN_ID\", \"error\": \"$ERROR_MESSAGE\"}"

Waarschuwingsgestuurd onderzoek

Verbind uw waarschuwingssysteem om automatisch onderzoek te starten wanneer kritieke waarschuwingen afgaan.

{
  "alert_name": "Error rate > 5%",
  "severity": "P1",
  "service": "checkout-api",
  "region": "eastus2",
  "start_time": "2026-03-13T10:15:00Z"
}

Controles voor uitrolnaleving

Nadat een implementatie is voltooid, activeert u een nalevingsbeoordeling:

curl -X POST "$AGENT_TRIGGER_URL" \
  -H "Authorization: Bearer $ARM_TOKEN" \
  -d '{"deployment_id": "deploy-456", "environment": "production", "changes": ["config update", "image bump"]}'

API-referentie

Troubleshooting

Trigger geeft 404-fout

• Controleer of de trigger is ingesteld op ingeschakeld. Uitgeschakelde triggers retourneren 404.
• Controleer of de trigger-id in de URL juist is.

401 Niet geautoriseerd

• De tokendoelgroep moet overeenkomen met de app-ID van de SRE Agent, niet https://management.azure.com.
• Als u een token wilt ophalen voor testen, gebruikt u az account get-access-token --resource 59f0a04a-b322-4310-adc9-39ac41e9631e --query accessToken -o tsv.

Trigger wordt uitgevoerd, maar de software-agent reageert niet

• Controleer de agentprompt. Een lege prompt produceert mogelijk geen nuttige uitvoer.
• Controleer of de gekozen subagent beschikt over de hulpprogramma's die nodig zijn voor de taak.
• Controleer de uitvoeringsgeschiedenis op foutdetails.

Limieten

Verwante inhoud

• Geplande taken
• Werkstroomautomatisering
• Een HTTP-trigger maken en testen