Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022
本文提供 Azure DevOps 服務勾點的一般疑難解答指引。 它也提供常見問題解答（FAQ）。
檢視活動和偵錯問題
Web 存取管理員中的 服務掛勾 頁面摘要列出每個訂閱在過去七天的活動。 此頁面也會顯示每個訂用帳戶都已啟用、停用或限制。
針對每個訂用帳戶，您可以存取詳細記錄，其中包含每個事件的完整要求和響應數據。 這項資訊可協助您偵錯有問題的服務或訂用帳戶。
若要檢視訂閱的活動和狀態，請前往 Service Hooks 頁面。
若要檢視訂用帳戶的詳細活動，包括完整要求、回應和事件承載數據，請選取數據表中的訂用帳戶，然後選取 [ 歷程記錄]。
訂閱失敗和試用期（受限）
如果通知要求的 HTTP 回應指出錯誤，失敗的嚴重性會決定 Azure DevOps 的回應方式。 某些類型的故障可能會停用訂閱，或將其置於暫停狀態。
失敗類型
服務攔截通知失敗會分組為下列類別：
- 終端機失敗
- 暫時性失敗
- 持久失敗
HTTP 回應的錯誤碼會決定 Azure DevOps 如何分類失敗。
終端機失敗
分類為終端機失敗的唯一 HTTP 狀態代碼是 410 （已消失）。
當訂用帳戶中發生終端機失敗時，無論其先前的狀態為何，訂閱都會自動停用。
暫時性失敗
具有下列狀態代碼的 HTTP 回應會分類為暫時性失敗：
- 408 (要求逾時)
- 502 （不正確的閘道）
- 503 （服務無法使用）
- 504 （閘道逾時）
當訂用帳戶中發生暫時性失敗時，Azure DevOps 會嘗試重新傳送通知最多八次，每次嘗試之間都會增加延遲。
下表列出發生暫時性失敗后所嘗試重試的相關信息。 包含的是大約的退避時間，或是嘗試重新傳送通知之前等待的時間。 最大退避時間為 60 秒。 數據表也會顯示每次重試的總延遲。
| 重試數目 | 退避時間以秒為單位 | 以秒為單位的總延遲 |
|---|---|---|
| 1 | 1 | 1 |
| 2 | 2 | 3 |
| 3 | 4 | 7 |
| 4 | 8 | 15 |
| 5 | 16 | 31 |
| 6 | 32 | 63 |
| 7 | 六十 | 123 |
| 8 | 六十 | 183 |
如果通知的所有重試都用盡，而且每次嘗試都會導致暫時性失敗，就不會再傳送通知。 相反地，它會分類為持續性故障。
持久失敗
所有其他 HTTP 失敗碼，例如 404（找不到）和 500 （內部伺服器錯誤），會導致持久的失敗。
當訂閱服務中發生持久失敗時，訂閱服務會進入 觀察期。
緩刑
當訂用帳戶處於緩刑狀態時，任何新事件都會遺失。 系統嘗試重新傳送失敗的通知次數有限。
下表列出在試用期內嘗試的重試的大約退避時間和總試用時間。 最多會嘗試七次重試，緩刑重試的最大輪詢時間為15小時。
| 重試數目 | 退避時間 | 以小時為單位的總緩刑時間 |
|---|---|---|
| 1 | 20 分鐘 | 0.33 |
| 2 | 40 分鐘 | 1 |
| 3 | 1 小時 20 分鐘 | 2.33 |
| 4 | 2 小時 40 分鐘 | 5 |
| 5 | 5 小時 20 分鐘 | 10.33 |
| 6 | 10 小時 40 分鐘 | 21 |
| 7 | 15 小時 | 36 |
如果訂閱在試用期內收到成功的回應，則會還原為功能完整啟用的狀態，並事件會重新發布。 如果所有七次重試失敗，訂用帳戶狀態就會設定為 DisabledBySystem。
使用 AI 來排除服務鉤子的問題
以下 Copilot 聊天的範例提示幫助 Copilot 排除錯誤代碼和訊息。 將此提示複製並貼到 Copilot Chat 中，將佔位符替換為您的特定錯誤訊息。
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.
常見問題
問：服務鉤子的承載限制為何？
一個： 承載限制為 2 MB。 較大的承載會導致效能及可靠性降低。 最佳實踐是，服務鉤子應將負載限制為 2 MB。
問：已啟用狀態（受限制）是什麼意思？
一個： 如果發生太多失敗，訂用帳戶就會受到限制。 處於 啟用（受限制） 狀態，與處於試用或限制階段相同。
問：狀態為已停用（因為失敗）是什麼意思？
A： 在下列情況下，訂閱會自動停用：
- 發生終端機失敗。
- 一連串的連續失敗會在很長的期間內發生。
在宣告持久失敗之前，導致暫時性失敗的通知會被重試多次。 在 試用期期間，對於持續失敗的通知，重試的次數是有限的。 如果所有緩刑重試失敗，訂用帳戶就會停用。
下列狀態代碼提供每種失敗類型的範例：
- 暫時性：408（要求逾時）、502（錯誤的網關）、503（服務無法使用）、504（網關逾時）
- 終端機：410（消失）
- 持續性：非短暫或非致命的所有失敗
問：狀態為 Disabled （使用者已離開專案）代表什麼意思？
A：建立訂閱的使用者不再是團隊的成員。
問：如果服務掛鉤無法運作，應該嘗試什麼？
A： 檢查下列項目：
- 確認訂用帳戶已啟用。
- 確認訂用帳戶設定正確。 檢查事件篩選和動作。
- 查看歷程記錄，特別是在發生失敗時。
問：我可以授與一般專案用戶檢視及管理專案的服務掛勾訂閱能力嗎？
一個： 根據預設，只有專案管理員具有這些許可權。 若要直接將他們授與其他使用者，您可以使用 命令行工具 或 安全性 REST API。
問：我是否可以以程序設計方式建立訂用帳戶？
甲： 是，請使用 REST APIs。