Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Den här artikeln innehåller allmänna felsökningsvägledning för Azure DevOps tjänstkrokar. Den ger också svar på vanliga frågor (FAQ).
Visa aktivitets- och felsökningsproblem
Sidan Service Hooks i webbåtkomstadministratören sammanfattar aktiviteten från de senaste sju dagarna för varje prenumeration. Sidan visar också om varje prenumeration är aktiverad, inaktiverad eller begränsad.
För varje prenumeration kan du komma åt en detaljerad historik som innehåller fullständiga begärande- och svarsdata för varje händelse. Den här informationen kan hjälpa dig att felsöka en problematisk tjänst eller prenumeration.
Om du vill visa aktivitet och status för dina prenumerationer går du till sidan Service Hooks.
Om du vill visa detaljerad aktivitet för en prenumeration, inklusive fullständiga data om begäran, svar och händelsenyttolast, väljer du en prenumeration i tabellen och väljer sedan Historik.
Prenumerationsfel och prövotid (begränsad)
Om HTTP-svaret på en meddelandebegäran indikerar ett fel avgör felets allvarlighetsgrad hur Azure DevOps svarar. Vissa typer av fel kan inaktivera prenumerationer eller sätta dem på prövotid.
Feltyper
Fel från service hook-meddelanden grupperas i följande kategorier:
- Terminalfel
- Tillfälliga fel
- Bestående fel
Felkoden från HTTP-svaret avgör hur Azure DevOps kategoriserar felet.
Terminalfel
Den enda HTTP-statuskoden som kategoriseras som ett terminalfel är 410 (Borta).
När ett terminalfel inträffar i en prenumeration inaktiveras prenumerationen automatiskt oavsett dess tidigare tillstånd.
Tillfälliga fel
HTTP-svar med följande statuskoder kategoriseras som tillfälliga fel:
- 408 (tidsgräns för begäran)
- 502 (felaktig gateway)
- 503 (tjänsten är inte tillgänglig)
- 504 (Gateway timeout)
När ett tillfälligt fel inträffar i en prenumeration försöker Azure DevOps skicka meddelandet igen upp till åtta gånger, med en ökande fördröjning mellan varje försök.
I följande tabell visas information om återförsök efter ett tillfälligt fel. Inkluderat är den ungefärliga backoff-tiden , eller tiden att vänta innan du försöker skicka ett meddelande igen. Den maximala backoff-tiden är 60 sekunder. Tabellen visar också den totala fördröjningen för varje nytt försök.
| Återförsöksnummer | Backoff-tid i sekunder | Total fördröjning i sekunder |
|---|---|---|
| 1 | 1 | 1 |
| 2 | 2 | 3 |
| 3 | 4 | 7 |
| 4 | 8 | 15 |
| 5 | 16 | 31 |
| 6 | 32 | 63 |
| 7 | 60 | 123 |
| 8 | 60 | 183 |
Om alla återförsök för ett meddelande är uttömda och varje försök resulterar i ett tillfälligt fel skickas inte längre meddelandet. I stället kategoriseras den som ett bestående misslyckande.
Bestående fel
Alla andra HTTP-felkoder, till exempel 404 (hittades inte) och 500 (internt serverfel), resulterar i bestående fel.
När ett varaktigt fel inträffar i en prenumeration placeras prenumerationen på prövotid.
Skyddstillsyn
När en prenumeration är i prövotid går den miste om alla nya händelser. Systemet gör ett begränsat antal försök att skicka det misslyckade meddelandet igen.
Följande tabell listar ungefärliga backoff-tider och totala prövotider för återförsök som systemet gör under prövotiden. Systemet gör högst sju återförsök, och den maximala backofftiden för ett återförsök under prövotiden är 15 timmar.
| Återförsöksnummer | Backoff-tid | Total prövotid i timmar |
|---|---|---|
| 1 | 20 minuter | 0,33 |
| 2 | 40 minuter | 1 |
| 3 | 1 timme och 20 minuter | 2.33 |
| 4 | 2 timmar och 40 minuter | 5 |
| 5 | 5 timmar och 20 minuter | 10,33 |
| 6 | 10 timmar och 40 minuter | 21 |
| 7 | 15 timmar | 36 |
Om prenumerationen får ett lyckat svar under prövotiden återställer systemet det till ett fullständigt aktiverat tillstånd och publicerar händelser igen. Om alla sju återförsöken misslyckas anger systemet prenumerationstillståndet till DisabledBySystem.
Prenumerationer inaktiverade på grund av inaktivitet
Azure DevOps inaktiverar automatiskt en prenumeration när den senaste lyckade meddelandeleveransen var för mer än sex månader sedan. Prenumerationen slutar ta emot händelser tills en användare aktiverar den igen.
Den här inaktivitetskontrollen tar endast hänsyn till den senaste lyckade leveransen. Det tar inte hänsyn till när prenumerationen skapades eller senast redigerades, eller hur många händelser som matchade prenumerationen. En prenumeration som fortsätter att leverera meddelanden är inte inaktiverad på grund av inaktivitet, oavsett ålder. En prenumeration utan registrerade lyckade leveranser påverkas inte av inaktivitetskontrollen.
Använd AI för att felsöka en serviceanslutning
Följande exempeluppmaning för Copilot Chat hjälper Copilot att felsöka din felkod och meddelande. Kopiera och klistra in den här uppmaningen i Copilot Chat och ersätt platshållaren med ditt specifika felmeddelande.
I'm getting this Azure DevOps service hook error: [PASTE YOUR ERROR MESSAGE HERE]
Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause
2. Fix the issue
3. Verify the solution works
Context: This is for a service hook in Azure DevOps.
Vanliga frågor och svar
F: Vad är gränsen för nyttolasten i en tjänstekrok?
A: Nyttolastgränsen är 2 MB. Större nyttolaster orsakar försämrade prestanda och tillförlitlighet. Som en bästa praxis bör servicekrokar begränsa nyttolasten till 2 MB.
F: Vad betyder tillståndet Aktiverat (begränsat)?
A: En prenumeration begränsas om för många fel inträffar. Att vara i tillståndet Aktiverad (begränsad) är detsamma som att vara under skyddstillsyn.
F: Varför kan en prenumeration inaktiveras?
S: En prenumeration inaktiveras automatiskt i följande fall:
- Ett terminalfel påträffas.
- En serie efterföljande fel inträffar under en längre period.
- Den senaste lyckade meddelandeleveransen var för mer än sex månader sedan.
- Användaren som skapade prenumerationen är inte längre medlem i teamet.
F: Vad betyder tillståndet Inaktiverad (på grund av fel)?
S: Aviseringar som leder till tillfälliga fel försöks igen flera gånger innan de klassas som bestående fel. Varaktiga felmeddelanden prövas på nytt ett begränsat antal gånger under granskningsperioden. Om alla återförsök av skyddstillsyn misslyckas inaktiveras prenumerationen.
Följande statuskoder innehåller exempel på varje typ av fel:
- Tillfälligt: 408 (tidsgräns för begäran), 502 (felaktig gateway), 503 (tjänsten är inte tillgänglig), 504 (tidsgräns för gateway)
- Terminal: 410 (Borta)
- Bestående: Alla fel som inte är tillfälliga eller slutgiltiga
F: Vad betyder tillståndet Inaktiverad (på grund av inaktivitet)?
A: Prenumerationens senaste lyckade leverans av meddelanden ägde rum för mer än sex månader sedan, så Azure DevOps har inaktiverat den. Det här tillståndet skiljer sig från Inaktiverad (på grund av fel), vilket innebär att Azure DevOps försök till leverans och att leveransen misslyckades upprepade gånger. Återaktivera prenumerationen om integreringen fortfarande behövs.
F: Varför är inaktiva prenumerationer inaktiverade?
S: Azure DevOps utvärderar varje prenumeration när en matchande händelse publiceras, även när den mottagande integreringen inte längre är aktiv. Med tiden kan organisationer ackumulera inaktiva prenumerationer när pipelines dras tillbaka och integreringar avbryts. Vissa organisationer har tiotusentals prenumerationer som inte har leverera meddelanden på flera år. Om du inaktiverar inaktiva prenumerationer kan du hålla tjänstkrokar snabba och tillförlitliga för prenumerationer som fortfarande används.
F: Vad betyder tillståndet Inaktiverat (användaren lämnade projektet)?
A: Användaren som skapade prenumerationen är inte längre medlem i teamet.
F: Vad kan jag göra om en service hook inte fungerar?
A: Kontrollera följande objekt:
- Kontrollera att prenumerationen är aktiverad.
- Bekräfta att prenumerationsinställningarna är korrekta. Kontrollera händelsefilter och åtgärder.
- Titta på historiken, särskilt om det finns fel.
F: Kan jag ge en vanlig projektanvändare möjlighet att visa och hantera service hook-prenumerationer för ett projekt?
A: Som standard har endast projektadministratörer dessa behörigheter. Om du vill bevilja dem till andra användare direkt använder du kommandoradsverktyget eller REST-API:et för säkerhet .
F: Kan jag programmatiskt skapa prenumerationer?
A: Ja, använd REST API:er.