連携が失敗したときにsolvethreeのリクエストログを確認する

1. 1.

   リクエストログを開く

   コンソールで/request-logsを開いてください。検索フィールドの目印は「リクエストID、サイト、アクション、またはエラー」というプレースホルダーです。記録したタスクまたはリクエストの識別子で検索し、サイトやアクションを使って関連する試行を探してください。

2. 2.

   「すべて」から始める

   リクエストを探している間は「すべて」フィルターを選択したままにしてください。その後、「成功」「失敗」「キュー待ち」「拒否」で結果を絞り込みます。最初から絞り込むと、調査対象の試行が表示されなくなる場合があります。

3. 3.

   タイムスタンプを照合する

   列は「リクエストID」「サイト」「アクション」「課金」「レイテンシ」「時刻」「結果」です。同じ対象への別の試行を調査しないよう、「時刻」「サイト」「アクション」をアプリケーションの記録と照合してください。

関連する行の「レイテンシ」を比較して、遅い試行を特定してください。アプリケーション側のHTTP所要時間も併せて確認し、コンソールの1つの値だけで、クライアントが観測した遅延全体を説明できるとは考えないでください。

「CSVをエクスポート」は、絞り込み後の行をエクスポートします。エクスポートする前に、検索条件とフィルターを関連する試行に合わせて設定し、共有する前にファイルを確認してください。

コンソールのフィルターは、サービスのリクエストまたは解決処理の結果を表します。「成功」は、後続のWebサイトがトークンを受け入れたことを示すものではありません。HTTPレスポンスとタスクのペイロードを使い、どの部分で失敗したかを特定してください。

APIが成功以外のHTTPステータスを返した。

クライアントが記録したステータスとエラーレスポンスを確認してください。成功したタスクのペイロードとして扱わないでください。

試してみましょう： まずHTTPエラーに対処し、報告された問題を修正してから再試行してください。すべての失敗がクレジット不足を意味すると考えないでください。APIエラー処理を参照してください。

タスクが待機中または解決中になっている。

これらは処理途中のタスクステータスであり、利用可能な解決結果ではありません。

試してみましょう： 準備完了または失敗になるまで、そのタスクのポーリングを続けてください。まだ解決結果がないという理由だけで、代わりのタスクを作成しないでください。

タスクが失敗している。

errorCodeとerrorの両方を確認してください。たとえば、site-unreachableはタスクのエラーコードです。

試してみましょう： そのタスクのポーリングを停止し、報告された原因に対処してから次の試行を行ってください。解決に失敗した場合は返金されます。無効な入力を変更せずに再試行しても、問題は解消しません。

タスクの作成がタイムアウトし、成功したかどうかわからない。

タスクIDがあれば、その試行に使ったrequestIdとともに保持してください。接続のタイムアウトだけでは、作成が失敗したとは断定できません。

試してみましょう： タスクIDがある場合は、そのタスクを取得してください。IDがなく、requestIdを指定していた場合は、同じIDで同じタスクリクエストを再送信し、既存のタスクを取得します。入力を変更して同じIDを再利用しないでください。競合が発生します。

タスクは準備完了だが、Webサイトが送信を拒否する。

Webサイトへの送信リクエストを確認してください。タスクIDや古いトークンではなく、solution.tokenが含まれていることを確認してください。

試してみましょう： 返されたuserAgentとsecChUaを、成功したプロキシおよび意図した対象サイトと組み合わせて使ってください。解決から送信までの間に、識別情報を混在させたり、プロキシを切り替えたりしないでください。対象サイトのHTTP 403だけでは、どの保護機能がリクエストを拒否したかは特定できません。

原因がまだ不明な場合は、試行を特定し、サービスの障害とWebサイトへの送信の拒否を区別できる情報を添えて、[email protected]にお問い合わせください。

• タスクIDおよび／またはrequestId、製品、タイムゾーン付きのタイムスタンプ。
• APIのHTTPステータス、または終了したタスクのerrorCodeとerror。
• 対象ホスト名とアクション。
• 機密情報を除去したレスポンスの説明と、そのレスポンスがsolvethreeと対象Webサイトのどちらから返されたか。
• 役立つ場合は、関連するログ行を絞り込み、確認して機密情報を除去したもの。

レポートと添付ファイルから、APIキー、プロキシのパスワード、トークン、Cookie、顧客データを削除してください。サポートでは、機密情報を除去したタスク／リクエストIDとタイムスタンプを受け付けています。試行の特定にトークンの生データは必要ありません。