Debug の概要

このページは ApigeeApigee ハイブリッドに適用されます。

Apigee Edge のドキュメントを表示する。

Debug は、Apigee で動作している API プロキシのトラブルシューティングとモニタリングを行うためのツールです。Debug ツールを使用すると、API プロキシのフローの各ステップの詳細を調べることができます。Apigee を使用すると、API プロキシのリクエストとレスポンスのフロー全体のデバッグデータを収集できます。これには、ポリシー実行時に適用されるすべてのリクエストとレスポンスのパラメータが含まれます。この情報は、API プロキシの開発とデプロイでデバッグやトラブルシューティングを行う際に重要になります。

データの収集と送信をデバッグする

Apigee ゲートウェイ ノードは、デバッグ セッション データを収集して、内部でキャッシュに保存してから、そのデータを Cloud のコントロール プレーンに送信します。そこから、オペレーターが分析できるように、デバッグ セッション UI と共有されます。

デバッグ マスキングを使用する場合、Apigee はデバッグデータをコントロール プレーンに送信する前に、ゲートウェイ ノードでマスキングを実行します。

Debug の使用

Debug の使用で説明されているように、UI または API から Debug ツールを使用して、デバッグ セッションの作成と管理を行います。また、Offline Debug の使用で説明されているように、デバッグ セッションをダウンロードして、オフラインで表示と分析を行うこともできます。

Apigee サポートでの Debug の使用

Only customers can trigger a debug session, but Apigee Support can access non-deleted past debug sessions during the course of a support case to help troubleshoot proxy-specific issues.

Note the following:

  • Apigee Support has read-only permission to Debug data.
  • Apigee Support may request that you run a debug to capture information about an issue, and that you provide the debug session ID or a link to the debug session so that Support may review the captured debug. Since saved debug sessions are valid for only 24 hours, we recommend that you download the debug session and attach it to the case opened with Support to enable offline viewing.

Apigee ハイブリッド ユーザーの場合

Apigee ハイブリッドを使用している場合は、以降のセクションをご覧ください。

Debug のアーキテクチャ

新しいデバッグ セッションを作成するプロセスを次に示します。

デバッグ セッションの開始リクエストの概要図:
    1.UI または API を使用して、デバッグ セッションの開始リクエストを送信します。2. 管理プレーンが、Pub/Sub モデルを使用してランタイム プレーンにデバッグ セッション作成リクエストを発行します。3. Synchronizer がデバッグ セッション通知に登録され、作成リクエストを Message Processor に送信します。4. MP がデバッグデータを収集し、データ収集 Pod にストリーミングします。5. fluentd が直ちに Pod のファイル システムにデバッグデータを書き込みます。6. UDCA が Pod のファイル システムで新しいデータファイルをポーリングします。7. 新しいデータファイルが検出されると、UDCA が UAP サービスにファイルをアップロードします。8. その後、Apigee ハイブリッド UI や Apigee API などの Apigee サービスを介してデータにアクセスできます。

デバッグデータは管理プレーンに最大で 24 時間保持されます。

Apigee ハイブリッドの要件

このセクションでは、Apigee ハイブリッド ユーザー向けの重要な情報を示します。

データ所在地のサポート

以前のバージョンの Apigee ハイブリッドでは、データ所在地がサポートされていません。

その他の要件

  • apigee-udca サービス アカウントが構成されている必要があります。構成のオーバーライドを指定するをご覧ください。
  • すべての Synchronizer ノードの時計が UTC に設定されて同期されている必要があります。