サービスフックのトラブルシューティング

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022

この記事では、Azure DevOps サービスフックの一般的なトラブルシューティングガイダンスを提供します。また、よく寄せられる質問 (FAQ) に対する回答も提供されます。

アクティビティの表示と問題のデバッグ

Web アクセス管理者 の [サービスフック ] ページには、サブスクリプションごとの過去 7 日間のアクティビティがまとめられます。このページには、各サブスクリプションが有効か、無効か、または制限されているかも表示されます。

サブスクリプションごとに、各イベントの要求と応答の完全なデータを含む詳細な履歴にアクセスできます。この情報は、問題のあるサービスまたはサブスクリプションをデバッグするのに役立ちます。

サブスクリプションのアクティビティと状態を表示するには、[ サービスフック ] ページに移動します。
完全な要求、応答、イベントペイロードデータなど、サブスクリプションの詳細なアクティビティを表示するには、テーブルでサブスクリプションを選択し、[ 履歴] を選択します。

サブスクリプションの失敗と保護観察 (制限付き)

通知要求に対する HTTP 応答がエラーを示している場合、エラーの重大度によって Azure DevOps の応答方法が決まります。特定の種類の障害では、サブスクリプションを無効にしたり、保護観察に入れたりすることができます。

エラーの種類

サービスフック通知からのエラーは、次のカテゴリにグループ化されます。

ターミナルの障害
一時的な障害
継続的な障害

HTTP 応答のエラーコードによって、Azure DevOps でエラーがどのように分類されるかが決まります。

ターミナルの障害

ターミナルエラーとして分類される HTTP 状態コードは 410 (Gone) のみです。

サブスクリプションでターミナルエラーが発生すると、その前の状態に関係なく、サブスクリプションは自動的に無効になります。

一時的な障害

次の状態コードを含む HTTP 応答は、一時的なエラーとして分類されます。

408 (要求がタイムアウトしました)
502 (無効なゲートウェイ)
503 (サービスを利用できません)
504 (ゲートウェイタイムアウト)

サブスクリプションで一時的なエラーが発生すると、Azure DevOps は通知の再送信を最大 8 回試行し、各試行の間に遅延が増加します。

次の表に、一時的な障害が発生した後に試行される再試行に関する情報を示します。含まれるのは、おおよその バックオフ 時間、または通知の再送信を試みるまでの待機時間です。バックオフの最大時間は 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 (内部サーバーエラー) など)、永続的なエラーが発生します。

サブスクリプションで永続的なエラーが発生すると、サブスクリプションは保護観察中になります。

保護観察

サブスクリプションが保護観察中の場合、新しいイベントはすべて失われます。システムは、失敗した通知の再送信を制限された回数だけ試行します。

次の表は、試用中に試行された再試行のおおよそのバックオフ時間と保護観察時間の合計を示しています。最大 7 回の再試行が試行され、保護観察再試行の最大バックオフ時間は 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

保護観察中にサブスクリプションが正常な応答を受信すると、完全に有効な状態に復元され、イベントが再び発行されます。 7 回の再試行がすべて失敗した場合、サブスクリプションの状態は DisabledBySystem に設定されます。

AI を使用してサービスフックのトラブルシューティングを行う

次の例では、Copilot Chat のプロンプトを使用して、エラーコードとメッセージのトラブルシューティングを行います。このプロンプトをコピーして 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.

よく寄せられる質問

Q: サービスフックのペイロード制限は何ですか?

ある： ペイロードの制限は 2 MB です。ペイロードが大きくなると、パフォーマンスと信頼性は低下します。ベストプラクティスとして、サービスフックはペイロードを 2 MB に制限する必要があります。

Q: 有効 (制限あり) 状態とはどういう意味ですか?

ある： エラーが多すぎると、サブスクリプションが制限されます。 有効 (制限付き) 状態であることは、保護観察中の状態と同じです。

Q: 無効化されている状態 (障害のため) とはどういう意味ですか?

ある： サブスクリプションは、次の場合に自動的に無効になります。

ターミナルエラーが発生しました。
一連の連続した障害は、長期間にわたって発生します。

一時的なエラーが発生した通知は、永続的なエラーとして宣言される前に複数回再試行されます。永続的なエラー通知は、保護観察中に限られた回数だけ再試行されます。すべての試用再試行が失敗した場合、サブスクリプションは無効になります。

次の状態コードは、各種類のエラーの例を示しています。

一時的: 408 (要求タイムアウト)、502 (無効なゲートウェイ)、503 (サービス利用不可)、504 (ゲートウェイタイムアウト)
ターミナル: 410 (Gone)
永続的: 一時的またはターミナルではないすべての障害

Q: 無効 (ユーザーがプロジェクトを離れた) の状態はどういう意味ですか?

ある： サブスクリプションを作成したユーザーは、チームのメンバーではなくなりました。

Q: サービスフックが機能しない場合はどうすればよいですか?

注意： 次の項目を確認します。

サブスクリプションが有効であることを確認します。
サブスクリプションの設定が正しいことを確認します。イベントフィルターとアクションを確認します。
特にエラーがある場合は、履歴を確認します。

Q: 通常のプロジェクトユーザーに、プロジェクトのサービスフックサブスクリプションを表示および管理する権限を付与できますか。

ある： 既定では、これらのアクセス許可を持つのはプロジェクト管理者だけです。他のユーザーに直接付与するには、コマンドラインツールまたは Security REST API を使用します。

Q: プログラムでサブスクリプションを作成できますか?

ある： はい。 REST API を使用します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-17