受信 Web サービス - トラブルシューティングガイドIssue <!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } コンテンツ 問題 — この記事の内容症状の迅速なトリアージ受信要求ライフサイクルユニバーサル診断チェックリスト一般的な問題のカテゴリ 5.1 ネットワークと接続の障害5.2 認証、承認、ACL5.3 レート制限、セマフォ、スロットリング5.4 タイムアウト、応答の遅さ、サーバーエラー5.5 空の本文と間違ったレコード数 HTTP ステータスコード:クイックリファレンス関連する記事 1.問題 — この記事の内容 受信 Web サービスの問題 (REST、SOAP、GraphQL、またはスクリプト化された REST API を介して ServiceNow インスタンスに着信する呼び出し) のトラブルシューティングの開始点。 対象となる症状: 応答なし、タイムアウト、または接続失敗。401/403 認証エラー。429 スロットリング。応答が遅いか、トランザクションが 5 分でキャンセルされました。本文が空であるか、返されたレコードが予想よりも少なくなっています。500 / 502 / 503 サーバーエラー。 この記事の使い方: ハブ記事です。適切な詳細記事へ誘導します。以下の「症状の迅速なトリアージ」から始めてください。 ↑ トップに戻る 2.症状の迅速なトリアージ 左側の症状と一致し、右側のリンクに従ってください。 表示されている内容最も可能性の高い原因こちらを読むブラウザーコンソールで応答なし、接続が拒否された、TLS ハンドシェイクエラー、または CORS エラーが発生するネットワーク、ファイアウォール、証明書、または CORS 構成受信 Web サービス:応答なし、接続エラー401 権限なしまたは 403 禁止認証、API キー、トークン、ロール、または ACL の問題受信 Web サービス:認証および認可の失敗SOAP 要求が「Insert Aborted」を返します挿入をブロックするビジネスルール、必須フィールド、または書き込み ACL受信 Web サービス:認証および認可の失敗GraphQL から「ACL を処理できませんでした」が返されますユーザーには、クエリで参照されるフィールドまたはレコードへのアクセス権がありません受信 Web サービス:認証および認可の失敗操作が成功したにもかかわらず 403 が返されましたPOST での既知の ACL 応答パターンKB2697679429 要求が多すぎる、スロットリング、または「ノードを追加しても役に立たなかった」レート制限ルール、セマフォ枯渇、またはテーブルごとのクォータ受信 Web サービス:レート制限とスロットリングコールがちょうど 5 分でタイムアウトするテーブルごとのトランザクションクォータ (デフォルトは 300 秒)受信 Web サービス — レート制限とスロットリング、セクション 7遅いが最終的に成功する、断続的 500 / 502 / 503クエリパフォーマンス、インデックス作成、または一時的なプラットフォームイベント受信 Web サービス:タイムアウトと遅い応答応答本文が空であるか、返されたレコード数が要求sysparm_limit数よりも少なくなっていますクエリ後の行をフィルタリングする ACL受信 Web サービス:結果が空または不完全テーブル API 応答が予想とは異なる方法でソートされましたテーブル API のデフォルトのソート動作KB2628639Web サービスのエクスポートサイズまたはスロットリングの問題エクスポートサイズ制限KB0547836 ↑ トップに戻る 3.受信要求ライフサイクル すべての受信要求は 5 つのステージを通過します。ほとんどの失敗はちょうど 1 つに存在します。ステージを特定すると、診断パスが絞り込まれます。 ネットワークと配信 - 要求はクライアントからインスタンスに移動します。ここで失敗すると、要求が届かないことを意味します。症状:応答なし、TLS エラー、接続拒否、CORS エラー。認証と許可 :インスタンスは発信者の ID を確認し、ロールと ACL をチェックします。ここで失敗すると、HTTP 401 または 403 が返されます。スロットリングとキャパシティ - インスタンスは、レート制限ルール、セマフォの可用性、およびテーブルごとのクォータをチェックします。ここで失敗すると、HTTP 429 が返されるか、トランザクションがキャンセルされます。実行と処理 - インスタンスはクエリまたは操作を実行します。ここで失敗すると、応答の遅さ、500/502/503 エラー、またはトランザクションのキャンセルが発生します。応答とデータ返却 - インスタンスは応答をアセンブルし、ACL 行フィルタリングを適用します。ここで失敗すると、空の本文または要求されたレコード数よりも少ないレコードが生成されます。 ↑ トップに戻る 4.ユニバーサル診断チェックリスト 詳細記事を開く前に、これらのアイテムをキャプチャします。ほとんどの場合、最初の接触で解決します。 完全な HTTP 応答ヘッダー 特にステータスコードと、 X-RateLimit- または Retry-After で始まるヘッダー。それらの存在または不在自体が診断的です。タイムゾーン (UTC を強く推奨 ) を使用した、秒単位の障害時刻。エンドポイントとターゲットテーブル (例: POST /api/now/table/incident)。コールを実行したクライアント IP と統合ユーザー最近の変更コンテキスト :過去 30 日間のプラットフォームのアップグレード、レート制限ルールの編集、ACL の変更、またはクライアント側の展開。https://<instance>.service-now.com/stats.do のスナップショットを、できるだけ障害発生時刻に近いタイミングでキャプチャしてください。 要求が到着しないように見える場合は、デバッグログを有効にします。 デバッグをオンにしてもログに要求が表示されない場合は、コールがインスタンスに到達していません。 応答なしおよび接続エラー に移動してください。利用可能なデバッグプロパティ: REST: glide.rest.debugSOAP: glide.processor.debug.SOAPProcessorJSONv2 (Fuji 以降): 専用のデバッグプロパティはありません。Transaction ログおよび All ログを使用してください。 ↑ トップに戻る 5.一般的な問題のカテゴリ 以下に簡単な要約を示します。詳細記事は、実際の診断が行われる場所です。 5.1 ネットワークと接続の障害 次の場合: 要求がインスタンスに到達しない、TLS ハンドシェイクエラー、接続拒否、またはブラウザコンソールの CORS エラー。 一般的な原因: 顧客側のファイアウォールまたはプロキシブロック、TLS トラストチェーンの欠落または期限切れ、DNS またはルーティングの失敗、CORS ルールの欠落。 Next: 受信 Web サービス - 応答なしおよび接続障害インスタンスの IP 範囲を KB0538621で確認します。 5.2 認証、承認、ACL 次の場合: 401、403、SOAP 挿入が中断された、または GraphQL ACL エラー。 次の 2 つの ACL レベルが適用されます。 プロセッサーレベル - エンドポイントをゲートします。SOAP には SOAP ロールが必要です。REST には rest_serviceロールが必要です。必要です。テーブル/レコードレベル :ユーザーに表示される行をゲートします。空の本文または短い結果セットは通常、これらを意味します。 クイックチェック: アドミンとして機能しても統合ユーザーとして失敗した場合は、認証ではなく ACL です。 次へ: 受信 Web サービス - 認証および認可の失敗 5.3 レート制限、セマフォ、スロットリング 次の場合: HTTP 429、または負荷時の障害。 3 つの層 — それらを混乱させることは、誤診の最も一般的な原因です。 インスタンスごとのレート制限ルール (sys_rate_limit_rules)。ユーザーまたはロールごとの時間上限。ノードによる拡張は行いません。ノードごとのセマフォ (API_INT、 stats.doに表示)。ノードごとにスケールします。テーブルごとのトランザクションクォータ。特定のテーブルの期間と同時実行を制限します。ノードによる拡張は行いません。 クイックチェック:X-RateLimit-* ヘッダーを持つ 429 = レイヤー 1。ヘッダーがない 429 = レイヤー 2。ちょうど 5 分でキャンセル = レイヤ 3。 次へ: 受信 Web サービス — レート制限とスロットリング 5.4 タイムアウト、応答の遅さ、サーバーエラー 次の場合: 呼び出しに予想よりも時間がかかるか、クリーンな 429 なしでタイムアウトするか、HTTP 500 / 502 / 503 を返します。 一般的な原因: 大規模なテーブル API クエリまたはフィルター処理されていないテーブル API クエリ、統合フィルターフィールドのインデックスの欠落、メンテナンス期間中の一時的な 5xx、システムログのサーバー例外。 次へ: 受信 Web サービス — タイムアウトと遅い応答 5.5 空の本文と間違ったレコード数 次の場合: コールは成功しても (200 または 201)、応答本文が空であるか、返されるレコード数が要求 sysparm_limit よりも少ない場合。 一般的な原因: クエリの実行後に ACL で行がフィルタリングされます。プラットフォームは最初に sysparm_limit を適用し、次にユーザーが読み取れない行を削除します。結果:要求された行数よりも少なく、エラーはありません。 クイックチェック:アドミンとして再実行 。行数がジャンプした場合は、ACL フィルタリングが原因です。 次へ: 受信 Web サービス — 空または不完全な結果 ↑ トップに戻る 6.HTTP ステータスコード:クイックリファレンス コード意味実行すべきこと400要求が正しくありませんJSON の形式が正しくないか、必須フィールドがないか、エンドポイントが無効です。要求の本文または URL を修正します。401権限なし認証情報がないか、無効であるか、期限が切れています。セクション 5.2 を参照してください。403禁止認証情報は有効ですが、必要なロールまたは ACL がユーザーにありません。セクション 5.2 を参照してください。success-but-403 パターンについては、「 KB2697679」を参照してください。429要求が多すぎますレート制限ルール、セマフォプール、またはテーブルクォータによって抑制されます。セクション 5.3 を参照してください。499クライアントクローズ済み要求インスタンスが応答する前にクライアントが切断されました。クライアントタイムアウトを延長するか、遅い処理を調査します。セクション4.4の 応答なしおよび接続エラーを参照してください。500内部サーバー エラー処理中に例外が発生しました。システムログでスタックトレースを確認します。セクション5.4を参照してください。502無効なゲートウェイノードが応答しない、または負荷が高い、または顧客側のプロキシまたはロードバランサーの問題。セクション5.4を参照してください。503サービス利用不可通常は一時的:インスタンスのメンテナンス期間または短期的なキャパシティイベント。待機時間を設けて再試行してください。持続する場合は、 セクション 5.4 を参照してください。 ↑ トップに戻る 7.関連する記事 KB3064934 - 受信 Web サービス - 応答なしおよび接続障害KB3064952 - 受信 Web サービス - 認証および認可の失敗KB3046852 - 受信 Web サービス - レート制限とスロットリングKB3047080 - 受信 Web サービス - タイムアウトと遅い応答KB3047115 - 受信 Web サービス - 空または不完全な結果KB0538621 - インスタンスの IP アドレスとデータセンター情報を検索する方法KB2628639 - テーブル API 応答ソート動作KB2697679 — 操作は成功しましたが、POST は 403 を返しますKB0547836 — Web サービスエクスポートのサイジングとスロットリング ↑ トップに戻る Symptoms<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Web サービスが機能していない。Web サービス要求の呼び出し時に応答がない。Web サービス要求のタイムアウトする。Web サービス要求時に応答が空となる。 Release<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } . Resolution<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } . Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } }