Řešení potíží s háky služby

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

V tomto článku najdete obecné pokyny k řešení potíží a odpovědi na nejčastější dotazy.

Zobrazení problémů s aktivitou a laděním

Na stránce Hooks služby ve správci webového přístupu se zobrazuje vaše nedávná aktivita (posledních 14 dnů) pro každé předplatné a informace o tom, jestli je předplatné povolené, zakázané nebo omezené.

Můžete získat přístup k podrobné historii předplatného, včetně podrobných dat požadavků a odpovědí, což je užitečné pro ladění problematické služby nebo předplatného.

1. Pokud chcete zobrazit aktivitu a stav vašich předplatných, přejděte na stránku Hooks služby.

   

2. Pokud chcete zobrazit podrobnou aktivitu pro předplatné, včetně úplných dat žádosti, odpovědi a datové části události, vyberte odběr v tabulce a pak vyberte Historie.

   

Selhání předplatného a zkušební verze (omezené)

Typy selhání

Selhání oznámení služby Hooks jsou seskupené do následujících kategorií:

• Selhání terminálu
• Přechodná selhání
• Trvalá selhání

Selhání terminálu

Jediným selháním terminálu je stavový kód HTTP 410 (pryč). Když se u předplatného zobrazí chyba terminálu, automaticky se zakáže bez ohledu na předchozí stav.

Přechodná selhání

Když se u předplatného zobrazí přechodné selhání, pokusí se oznámení znovu odeslat až osmkrát a mezi jednotlivými pokusy se zpožďuje. Mezi přechodné selhání patří následující kódy:

• 408 (vypršení časového limitu požadavku)
• 502 (chybná brána)
• 503 (Služba není k dispozici)
• 504 (vypršení časového limitu brány)

Posloupnost opakovaných pokusů o přechodné selhání

Opakovat #	Doba čekání
Před opakováním 1	čekání ~1 sekunda
Před opakováním 2	čekání ~2 sekundy (celkové zpoždění 3 sekundy)
Před opakováním 3	čekání ~4 sekundy (celkové zpoždění 7 sekund)
Před opakováním 4	čekání ~8 sekund (celkové zpoždění 15 sekund)
Před opakováním 5	čekání ~16 sekund (celkové zpoždění 31 sekund)
Před opakováním 6	čekání ~32 sekund (celkové zpoždění 63 sekund)
Před opakováním 7	čekání ~60 sekund (maximální doba obnovení, celková prodleva 123 sekund)
Před opakováním 8	čekání ~60 sekund (maximální doba zpomalování, celková prodleva 183 sekund)

Pokud oznámení vyčerpá všechny svoje opakované pokusy a při každém pokusu se zobrazí přechodné selhání, předplatné se přestane pokoušet oznámení odeslat a považuje oznámení za neúspěšné.

Trvalá selhání

Trvalé selhání zahrnují všechny ostatní kódy selhání HTTP, například: 404 (Nenalezena), 500 (vnitřní chyba serveru) atd.

Když se u předplatného zobrazí trvalé selhání, umístí se na probaci.

Probační

Při probaci je předplatné omezené v počtu oznámení, která může odeslat. Pokud se předplatné bude dál používat k trvalým selháním, bude stále omezenější a nakonec zakázané. Pokud předplatné obdrží úspěšnou odpověď při probaci, obnoví se do plně povoleného stavu.

Posloupnost sedmi maximálních opakování v době, kdy je předplatné na zkušební verzi

Když je odběr ve zkušební verzi, všechny nové události se ztratí. Po úspěšném opakování se předplatné povolí a události se publikují znovu.

Opakovat #	Doba čekání
Před opakováním 1	počkejte ~20 minut
Před opakováním 2	čekání ~40 minut (celková doba probace 1 hodiny)
Před opakováním 3	čekání ~1 hodina 20 minut (celková doba probace 2,33 hodin)
Před opakováním 4	čekání ~2 hodiny 40 minut (celková doba probace 5 hodin)
Před opakováním 5	čekání ~5 hodin 20 minut (celková doba probace 10,33 hodin)
Před opakováním 6	čekání ~10 hodin 40 minut (celková doba probace 21 hodin)
Před opakováním 7	čekání ~15 hodin (max backoff time, total probation time of 36 hours)

Po sedmi opakováních se stav předplatného nastaví na DisabledBySystem , pokud příjemce oznámí selhání.

Nejčastější dotazy

Otázka: Jaký je limit datové části připojení služby?

A: Limit datové části je 2 MB. Větší datové části způsobují snížení výkonu a spolehlivosti. Osvědčeným postupem je nastavit limit datové části volaných služeb na 2 MB nebo méně.

Otázka: Co znamená stav Povoleno (omezeno)?

A: Předplatné se omezí, pokud dojde k příliš velkému počtu selhání. Povoleno (omezeno) je stejné jako při probaci.

Otázka: Co znamená stav Zakázáno (kvůli selháním)?

A: Předplatné se po delším období automaticky zakáže po řadě po sobě jdoucích selhání nebo dojde k selhání terminálu. Přechodné typy selhání se několikrát opakuje před deklarací selhání. Trvalé typy selhání se neopakují. Následují příklady jednotlivých typů selhání.

• Přechodné: 408 (vypršení časového limitu požadavku), 502 (chybná brána), 503 (nedostupná služba), 504 (vypršení časového limitu brány)
• Terminál: 410 (pryč)
• Trvalá: Všechna selhání, která nejsou přechodná nebo terminálová

Otázka: Co znamená stav Zakázáno (projekt ponecháný uživatelem)?

A: Uživatel, který vytvořil předplatné, už není členem týmu.

Otázka: Co mám zkusit, když nefunguje připojení služby?

A: Zkontrolujte následující položky:

• Ověřte, že je předplatné povolené.

• Ověřte správnost nastavení odběru (filtry událostí i akce).

• Podívejte se na historii, zejména v případě selhání.

Otázka: Můžu uživateli běžného projektu udělit možnost zobrazit a spravovat předplatná háku služby pro projekt?

A: Ve výchozím nastavení mají tato oprávnění jenom správci projektu. Pokud je chcete udělit přímo jiným uživatelům, můžete použít nástroj příkazového řádku nebo rozhraní REST API pro zabezpečení.

Otázka: Můžu programově vytvářet předplatná?

A: Ano, použijte rozhraní REST API.