デバッグ、分析、デプロイのステータス データの収集

Apigee ハイブリッドでは、デバッグ、分析、デプロイのステータス データを利用できます。このデータは、データ収集 Pod によって収集され、管理プレーンに送信されます。これらのデータを表示、分析し、モニタリングやアラートを設定できます。

データについて

ハイブリッドのすべての Message Processor(MP)サービスは、デバッグ(開始時)、分析、デプロイのステータス データを TCP を介してクラスタのデータ収集 Pod に送信します。データ収集 Pod は、fluentd サービスを使用して、送信されたデータを Pod のファイル システムに保存します。

UDCA(Universal Data Collection Agent)は、保存されたデータを定期的に抽出し、管理プレーンの UAP(Unified Analytics Platform)サービスに送信します。UAP は、受信した分析とデプロイのステータス データを処理し、ハイブリッド UI または Apigee API に公開します。

Apigee ハイブリッドは、少なくとも 2 つのレプリカを使用してデータ収集 Pod を ReplicaSet として実装します。

次の図に、デバッグ、分析、デプロイのステータス データの収集プロセスを示します。

Message Processor で始まり、UDCP によって保存され、最終的に Apigee API または Apigee ハイブリッド UI で処理されるデータのフローを示すアーキテクチャ図。

デバッグ、分析、デプロイのステータス データは、ロギングや指標データと同じ場所に保存されることはありません。また、同じ方法でアクセスされることもありません。

  • ロギングと指標のデータは GCP プロジェクトに保存され、Cloud Operations などのツールやユーザーが選択した任意の方法でアクセスできます。
  • 一方、デバッグ、分析、デプロイのステータス データは、ハイブリッド管理プレーンに保存され、ハイブリッド UI や Apigee API などの Apigee サービスを介してアクセスします。

次の表に、データ収集 Pod によって収集されるデータの概要を示します。

データの種類 データセット名 説明 更新の頻度 API
分析 api 1 秒あたりのトランザクション、キャッシュ使用量、エラー、レイテンシ、リクエストとレスポンスのサイズ、トラフィック数などの API の使用状況に関するデータ。

詳細については、Apigee Analytics の概要をご覧ください。

最大 30 秒の遅延 Analytics Admin API
デプロイ ステータス event API プロキシの現在のデプロイ ステータス。

この情報の表示方法の詳細については、デプロイ ステータスの表示をご覧ください。

今すぐ Deployments API
デバッグ debug

API プロキシのセッション データをデバッグします。このデータには、ポリシー実行時に適用された変換とともにリクエストとレスポンスのパラメータが含まれます。

デバッグデータはサイズが大きくなるため、分析とデプロイのステータス データとは異なり、常に収集されるわけではありません。デバッグデータは、デバッグ セッションを開始すると収集されます。

詳細については、Debug の概要をご覧ください。

今すぐ Debug Session API
Debug Session Data API

ハイブリッド UI でデータを表示する

このセクションでは、Apigee ハイブリッド UI のデバッグ、分析、デプロイのステータス データを表示する方法について説明します。

デバッグ

ハイブリッド サービスの Debug データは Edge デバッグデータと同じ方法でアクセスできますが、フィルタ サポートの強化など異なる点もあります。詳細については、Debug の概要をご覧ください。

分析

ハイブリッド サービスの Analytics データには、Edge Analytics データと同じ方法でアクセスできます。詳細については、Edge ドキュメントの Analytics ダッシュボードの使用をご覧ください。

プロキシ デプロイのステータス

デプロイ ステータスの表示については、デプロイ ステータスの表示をご覧ください。

データ収集を構成する

データ収集 Pod でデバッグ、分析、デプロイのステータス データを収集する方法と場所を設定するには、構成プロパティを使用して UDCA サービスを構成します。UDCA プロパティには、UDCA 全般で使用されるプロパティと、各データセットに固有のプロパティがあります。

UDCA を構成するには:

  1. ランタイム プレーン コンポーネントの管理の説明に従って、Kubernetes 管理マシンで、overrides.yaml ファイルを編集用に開きます。
  2. UDCA 構成設定の値を設定します。UDCA では、次のようなプロパティにカスタム値を設定できます。
    • ポーリング間隔
    • レプリカ数(最小および最大)
    • ターゲット CPU の割合(追加のレプリカをトリガー)

    カスタマイズ可能な UDCA プロパティの完全なリストについては、udca をご覧ください。

  3. overrides.yaml ファイルに変更を保存します。
  4. 次の例のように apigeectl apply コマンドを実行して、クラスタに変更を適用します。
    apigeectl apply -f my-overrides.yaml --org --env env-name

    apply コマンドの詳細については、クラスタにハイブリッドを適用するをご覧ください。