ヘルプ Google Cloud Google Cloud Apigee監視連携

Google Cloud Apigee監視連携

本ページは機械翻訳をもとに提供しています。正確かつ最新の情報は英語版の内容をご参照ください。

Google Cloud Apigeeリソースの監視、APIプロキシのトラフィックとレイテンシの追跡、ターゲットおよびアップストリームバックエンドの正常性の監視、セキュリティスコアと異常の確認ができます。Google Cloud Apigee監視を使用すると、信頼性が高く安全なAPI管理プラットフォームを維持できます。

主なメリット

Apigeeの監視により、APIゲートウェイを信頼性が高く、安全で、高性能な状態を維持できます。主なメリットは以下の通りです:

  • エンドユーザーに影響を与える前に、レイテンシの急増、エラーの急上昇、トラフィックの異常を特定します。
  • 応答時間、スループット、バックエンドの依存関係を追跡して、APIの配信を微調整します。
  • 自動アラートとITオートメーションにより、SLAコンプライアンスを維持し、ダウンタイムを削減します。
  • Apigeeメトリクスを他のGoogle Cloud Platform(GCP)サービスと統合し、シングルペインオブグラスで表示します。
  • 一括設定とエージェントのアップグレードにより、複数のAPIプロキシにわたるスムーズな監視を実現します。

ユースケース

Google Cloud Apigee監視が役立つユースケースは以下の通りです。

  • プロキシ全体の平均およびパーセンタイル応答時間を監視し、ボトルネックをリアルタイムで検出します。
  • 4xx/5xxエラーのトレンドをキャプチャし、失敗しているエンドポイントまたは誤設定されたポリシーをすばやく特定します。
  • リクエストボリュームとピーク使用量期間を可視化し、キャパシティプランニングとスケーリングの最適化を行います。
  • 可用性とパフォーマンスのしきい値を設定し、契約上の義務を確実に履行します。
  • 認証失敗、クォータ違反、ポリシー適用メトリクスを追跡し、APIガバナンスを強化します。
  • Apigee監視を他のGCPサービス(Compute Engine、Cloud SQL、Kubernetes)と統合し、全体像を把握できるようにします。

セットアップと設定

  • 新しいGoogle Cloud監視を設定する際にGoogle Cloud Apigeeを追加する

    Google Cloud監視をまだ設定していない場合は、以下の手順に従って追加します:

    1. 左側ナビゲーションペインの[Cloud]→[GCP]→[GCP監視の追加]、または[管理]→[クラウド監視]→[GCP]に移動します。
    2. 識別用に一意の[表示名]を入力します。
    3. サービスアカウントの秘密鍵を含むJSONファイルをアップロードし、認証とリソースディスカバリーを実行します。
    4. [サービス・リソースタイプ]リストから[GCP Apigee]を選択します。
    5. 既存の通知プロファイル、ユーザーアラートグループ、タグ、IT自動化テンプレートを選択するか、新規に追加します。アラートを任意のサードパーティサービスと連携することもできます。
    6. [GCP監視を起動]をクリックします。
  • 既存のGoogle Cloud監視にGoogle Cloud Apigeeを追加する

    サービスアカウント用にGoogle Cloud監視を既に設定済みの場合、以下の手順でGoogle Cloud Apigeeを追加できます。

    1. [Cloud]→[GCP]に移動し、GCP監視を選択します。
    2. サービスビューの隣にあるハンバーガーアイコンHamburger iconをクリックし、[編集]を選択すると、GCP監視の編集ページが表示されます。
    3. GCP監視の編集ページで、[サービス・リソースタイプ]リストから[GCP Apigee]を選択し、[保存]をクリックします。
    4. 設定が成功したら、[Cloud]→[GCP]→[GCP Apigee]に移動します。これで、ディスカバーされたGoogle Cloud Apigeeリソースを表示できます。
新しいGCPリソースをディスカバリーするには約5分かかります。

ライセンス

Google Cloud Apigee監視は、ベーシック監視ライセンスを1つ消費します。

ポーリング頻度

Google Cloud Apigee監視は1分ごとのメトリクスデータを収集し、Google Apigeeリソースのステータスは5分ごとに報告されます。

収集できるメトリクス

メトリクス名 説明 統計値 単位
API Hub Security Score APIハブに登録されたAPIのセキュリティ態勢スコアです。 平均 カウント
Security Score 検出されたリスクに基づいてApigee組織のセキュリティスコアを計算します。 平均 カウント
Proxy Request Count APIプロキシが受信したリクエスト数です。 合計 カウント
Proxy Response Count APIプロキシが送信したレスポンス数(レスポンスコード別にグループ化)です。 合計 カウント
Proxy Latencies APIプロキシが処理したリクエストのレイテンシ分布です。 平均 ミリ秒
Proxy Latencies Percentile APIプロキシが処理したリクエストのレイテンシ分布のパーセンタイルです。 平均 ミリ秒
Target Request Count APIプロキシからターゲットバックエンドに送信されたリクエスト数です。 合計 カウント
Target Response Count ターゲットバックエンドから受信したレスポンス数(レスポンスコード別にグループ化)です。 合計 カウント
Target Latencies ターゲットバックエンドに送信されたリクエストのレイテンシ分布です。 平均 ミリ秒
Target Latencies Percentile ターゲットバックエンドに送信されたリクエストのレイテンシ分布のパーセンタイルです。 平均 ミリ秒
Policy Latencies Percentile APIプロキシ内のポリシー実行のレイテンシ分布のパーセンタイルです。 平均 ミリ秒
Server Request Count Apigeeメッセージプロセッサが受信したリクエスト数です。 合計 カウント
Server Response Count Apigeeメッセージプロセッサが送信したレスポンス数です。 合計 カウント
Server Fault Count Apigeeメッセージプロセッサがリクエスト処理中に遭遇した障害数です。 合計 カウント
Server Latencies Apigeeメッセージプロセッサが処理したリクエストのレイテンシ分布です。 平均 ミリ秒
Server Thread Count Apigeeメッセージプロセッサで現在使用されているスレッド数です。 平均 カウント
Environment Active Apigee環境が現在アクティブかどうかを示します。 平均 カウント
Environment API Call Count Apigee環境内で処理されたAPI呼び出しの総数です。 合計 カウント
Environment Anomaly Count Apigee環境内で検出された異常の数です。 合計 カウント
Environment Gateway Node Count Apigee環境にプロビジョニングされたゲートウェイノードの数です。 平均 カウント
Security Request Count Apigeeの高度なAPIセキュリティによって評価されたリクエスト数です。 合計 カウント
Security Detected Request Count Apigeeの高度なAPIセキュリティによってセキュリティ検出がフラグ付けされたリクエスト数です。 合計 カウント
Security Incident Request Count 確認されたセキュリティインシデントに関連付けられたリクエスト数です。 合計 カウント
Security Environment Score Apigee環境に対して計算されたセキュリティスコアです。 平均 カウント
Security Proxy Score 個別のAPIプロキシに対して計算されたセキュリティスコアです。 平均 カウント
Upstream Request Count Apigeeメッセージプロセッサからアップストリームターゲットに送信されたリクエスト数です。 合計 カウント
Upstream Response Count アップストリームターゲットから受信したレスポンス数です。 合計 カウント
Upstream Latencies アップストリームターゲットに送信されたリクエストのレイテンシ分布です。 平均 ミリ秒
UDCA Disk Used Bytes Universal Data Collection Agent(UDCA)が使用するディスク容量です。 平均 バイト
UDCA Upstream HTTP Error Count UDCAがアップストリームエンドポイントと通信中に遭遇したHTTPエラー数です。 合計 カウント
UDCA Local File Count UDCAが管理するアップロード待ちのローカルファイル数です。 平均 カウント
Monetization Request Count Apigeeの課金モジュールが処理したリクエスト数です。 合計 カウント
Monetization Latencies Percentile Apigeeの課金モジュールが処理したリクエストのレイテンシ分布のパーセンタイルです。 平均 ミリ秒
Cassandra Client Request Latency 基盤となるCassandraデータストアに対するクライアントリクエストのレイテンシです。 平均 ミリ秒
Cassandra Compaction Pending Tasks 基盤となるCassandraデータストアでの保留中のコンパクションタスク数です。 平均 カウント

しきい値設定

  • グローバルでの設定
    1. Webクライアントで、左側ナビゲーションペインの[管理]セクションに移動します。
    2. 左側ペインから[設定プロファイル]を選択し、ドロップダウンメニューから[しきい値と可用性]を選択します。
    3. 右上隅の[しきい値プロファイルの追加]をクリックします。
    4. 監視タイプとして[GCP Apigee]を選択します。
    5. 必要なメトリクスのしきい値を指定し、[保存]をクリックします。
  • 監視レベルでの設定
    1. Webクライアントで、[Cloud]→[GCP]→[GCP Apigee]に移動します。
    2. しきい値を設定したいリソースを選択し、ハンバーガーアイコンHamburger iconをクリックします。
    3. [編集]を選択すると、Apigee監視の編集ページが表示されます。
    4. 必要なメトリクスのしきい値を指定し、[保存]をクリックします。

IT自動化

IT自動化ツールは、パフォーマンス低下の問題を自動的に解決します。これらのツールは、手動での介入を待つのではなく、イベントに対して事前に反応します。しきい値違反の修正など、繰り返しタスクを自動化します。アラートエンジンは、しきい値が設定されているシステムイベントを継続的に評価し、違反が発生したときにマッピングされた自動化を実行します。

監視にIT自動化を設定する方法

設定ルール

複数の監視を編集して異なる監視グループを関連付けたり、異なるタグを追加したりする作業は面倒なプロセスです。設定ルールを使用すると、監視リソースの設定を自動化できます。カスタムルールを作成し、設定の変更を継続的に追跡して、理想的な設定を実現します。

設定ルールの追加方法

サマリー

サマリタブでは、上記のメトリクスについて時間順に整理されたパフォーマンスデータを表示します。サマリーを表示する方法は以下の通りです。

  1. [Cloud]→[GCP]→[GCP Apigee]に移動します。
  2. リソースを選択します。
  3. [サマリー]タブをクリックします。

設定の詳細

設定の詳細タブでは、アプリケーションインスタンスの設定に関する詳細情報を提供します。設定の詳細を表示する方法は以下の通りです。

  1. [Cloud]→[GCP]→[Apigee]に移動します。
  2. リソースを選択します。
  3. [設定詳細]タブをクリックします。

レポート

監視対象リソースのさまざまなパラメータに関する詳細データを取得し、洞察に満ちたレポートを使用してサービスパフォーマンスを強化します。

Google Apigeeリソースのレポートを表示する方法は以下の通りです。

  1. 左側ナビゲーションペインの[レポート]セクションに移動します。
  2. 左側メニューから[GCP Apigee]を選択します。
  3. 選択した監視の可用性サマリレポート、パフォーマンスレポート、インベントリレポートを確認できます。または、すべてのGoogle Apigee監視のサマリレポート、可用性サマリレポート、正常性トレンドレポート、パフォーマンスレポートを取得できます。

Google Apigee監視のサマリタブからレポートを取得することもできます:

  1. [サマリー]タブをクリックします。
  2. [可用性]をクリックして監視の可用性サマリレポートを取得します。
  3. 任意のグラフタイトルをクリックして、監視のパフォーマンスレポートも確認できます。

関連情報