トレース、分析、デプロイのステータス データの収集

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

データについて

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

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

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

次の図は、トレース、分析、デプロイのステータス データの収集プロセスを示しています。

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

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

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

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

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

詳細については、Edge ドキュメントの Analytics 指標、ディメンション、フィルタのリファレンスをご覧ください。

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

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

 即時 Deployments API
トレース trace

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

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

詳細については、トレースの概要をご覧ください。

 即時 Debug Sessions API
Debug Session Data API

ハイブリッド UI でのデータの表示

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

トレース

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

分析

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

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

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

データ収集の構成

データ収集ポッドでトレース、分析、デプロイのステータス データを収集する方法と場所を設定するには、構成プロパティを使用して 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 -c udca

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