SCAPI ログの表示とリクエストの追跡

Log Center は、B2C Commerce API (SCAPI) 操作のための包括的なロギング記録とモニタリング機能を提供します。Log Center を使用すると、B2C Commerce インスタンス全体にわたって、問題のトラブルシューティング、パフォーマンスのモニタリング、API の動作の分析を行うことができます。

1. Business Manager にログインします。
2. アプリケーションランチャー をクリックし、管理 > サイトの開発 > 開発セットアップを選択します。Progressive Web App (PWA) Kit を使用してサイトを構築した場合は、まず Log Center を使用したデバッグに記載されている前提条件を完了してください。

Log Center に関する一般的な情報については、一元管理 Log Center を参照してください。

Log Center で、Logs (ログ) > Search (検索) に移動します。

相関 ID を使用して特定のリクエストと特定のレスポンスを照合することで、内部サーバーエラーなど予期せぬ問題のトラブルシューティングを簡単に行えるようになります。

SCAPI エンドポイントへのリクエストで correlation-id ヘッダーが渡された場合、レスポンスには correlation-id の値を含む correlation-id ヘッダーが含められます。また、API によって、各レスポンスのための独自の相関 ID が生成されます。この生成された ID は、sfdc_correlation_id レスポンスヘッダーで提供されます。

ヘッダーの例:

correlation-id の値には、単語文字、ハイフン (-)、およびコンマ (,) のみを含める必要があります。これ以外の文字が含まれていると、Log Center でその相関 ID 文字列を検索できなくなる場合があります。

大部分の Commerce API エンドポイントで、correlation-id はフックとともにログメッセージに自動的に追加されます。これらのメッセージは、Log Center で、externalID フィールドに基いてメッセージをフィルターする LCQL (Log Center Query Language) 式でクエリできます。externalID フィールドには correlation-id レスポンスヘッダーの値が含まれているため、ユーザーが指定した相関 ID、SCAPI によって生成された相関 ID、または組み合わせ文字列をクエリできます。

問題を再現できる場合は、独自の相関 ID を付加するか、レスポンス内で自動生成された相関 ID を確認することで、問題を特定できる可能性があります。

この相関 ID を使用して、特定のリクエストを追跡できます。

1. Log Center の検索で、検索フィールドに相関 ID を入力するか、externalID フィールドに対して Log Center Query Language (LCQL) 式を使用します。例: externalID:(9527f1869f95a32d)
2. より絞り込んだ結果を得るために、関連するサービスタイプでフィルタリングできます。ただし、これは結果セットが非常に大きい場合にのみ推奨されます。

Log Center の SCAPI ログを使用して、頻繁に発生するエラーのパターンを調査することもできます。

1. ドロップダウンメニューから、SCAPI カテゴリを選択します。
   • 特定のエラーレスポンスコードを含むリクエストを特定するには、scapi-http を選択します。
   • SCAPI リクエストの処理方法に関するエラーメッセージを見つけるには、scapi を選択します。たとえば、不正なリクエスト、認証の失敗、ルーティングの問題などです。
2. 検索を実行して、発生しているエラーステータスタイプを特定します。
3. 特定のエラーをさらに詳しく調査するには、結果から 1 つまたは複数の相関 ID を取得し、同じ相関 ID を持つエントリを検索します。詳細については、相関 ID による調査を参照してください。

B2C Commerce バージョン 24.7 では、リクエストに関する包括的な情報を含む JSON ドキュメントを生成できます。この JSON ドキュメントは、リクエストの認可、フックの実行、リクエストクエリパラメーター、ヘッダー、ボディなど、標準のログ記録には含まれていない詳細情報を提供するため、トラブルシューティングに役立ちます。

この機能を有効にするには、リクエストに次のヘッダーを含めます。

• ヘッダー: sfdc_verbose: true

リクエストが完了すると、JSON ドキュメントが作成され、そのリクエストの相関 ID に関連付けられた INFO ログに記録されます。

sfdc_verbose ヘッダーを correlation-id と組み合わせて使用すると、Log Center で詳細ログ出力を生成および検索できます。

1. Log Center の開始の説明に従って Log Center にログインします。
2. 相関 ID またはカテゴリ scapi.verbose を Log Center 検索と組み合わせて使用して、対応するログエントリを検索します。

次の例は、詳細ログエントリに存在できるオブジェクト (auth、request、response、customApi、hooks) を示しています。

SCAPI と SCAPI フックのメトリクスは、Metrics (メトリクス) ダッシュボードで確認できます。メトリクスを表示するには、Log Center で Metrics をクリックし、次に SCAPI または SCAPI Hooks をクリックします。詳細は、Metrics ダッシュボードを参照してください。

追加の SCAPI メトリクスは、CCAC SCAPI ダッシュボードで提供されます

詳細については、Log Center メトリクスのドキュメントを参照してください。

• Log Center 検索のドキュメント
• CCAC SCAPI ダッシュボード
• SCAPI API のパフォーマンスの監視
• レスポンスボディを分析してメンテナンスの問題を特定
• エラーレスポンスコードの確認