このページでは、Cloud Load Balancing の Service Extensions コールアウトで Cloud Logging と Cloud Monitoring を構成して使用する方法について説明します。
ロギング
このセクションでは、アプリケーション ロードバランサのコールアウトのロギングについて説明します。
バックエンド サービスでロギングを有効にする
サービスを作成するときに、アプリケーション ロードバランサのコールアウトのロギングを有効にするには、リクエストのターゲットであるバックエンド サービスでロギングを有効にします（拡張機能に関連付けられたバックエンド サービスではありません）。
ターゲット バックエンド サービスのロギングを有効にするには、gcloud compute backend-services update コマンドを使用します。
gcloud compute backend-services update BACKEND_SERVICE \
--enable-logging \
--logging-sample-rate=RATE \
--region=REGION \
--logging-optional=LOGGING_OPTIONAL_MODE \
--logging-optional-fields=OPTIONAL_FIELDS
次のように置き換えます。
BACKEND_SERVICE: バックエンド サービスの名前。RATE:0.0～1.0の値。0.0はリクエストがログに記録されないことを意味し、1.0はリクエストの 100% がログに記録されることを意味します。デフォルト値は1.0です。この設定は、enable-loggingパラメータと組み合わせて使用する場合にのみ有効です。enable-loggingを省略すると、ロギングは無効になります。REGION: バックエンドのリージョンLOGGING_OPTIONAL_MODE: 次のいずれかのモードでオプション フィールドのロギングを有効にします。INCLUDE_ALL_OPTIONALには、すべてのオプション フィールドが含まれます。EXCLUDE_ALL_OPTIONAL（デフォルト）: すべてのオプション フィールドを除外します。CUSTOMには、オプション フィールドのカスタムリストが含まれます。
OPTIONAL_FIELDS:CUSTOMモードを選択した場合のオプション フィールドのカンマ区切りのリスト。
バックエンド サービスでロギングを有効にすると、Cloud Logging を使用して HTTP または HTTPS リクエストがロギングされます。
ログを表示するには、 Google Cloud コンソールで [ログ エクスプローラ] ページに移動します。
詳細については、アプリケーション ロードバランサのドキュメントの「モニタリングとトラブルシューティング」ページ（内部アプリケーション ロードバランサのロギングとモニタリングなど）をご覧ください。
バックエンド サービスのログ メッセージ
一般に、アプリケーション ロードバランサのログエントリには、HTTP または HTTPS トラフィックのモニタリングとデバッグに役立つ情報が含まれています。ログエントリには次のタイプの情報が含まれています。
- 重大度、プロジェクト ID、プロジェクト番号、タイムスタンプなど、ほとんどの Google Cloud ログに表示される情報（LogEntry ログの説明を参照）。
- HttpRequest ログフィールド。
HTTP ロードバランサと HTTPS ロードバランサのリクエストログには、ロードバランサのログエントリ JSON ペイロードに service_extension_info オブジェクトが含まれています。このオブジェクトには、次の情報が含まれています。
| フィールド | タイプ | 説明 |
|---|---|---|
backend_target_name |
文字列 | 拡張機能のバックエンド ターゲットの名前。 |
backend_target_type |
文字列 | バックエンド ターゲットのタイプ。 |
chain |
文字列 | リクエストに一致するサービス拡張機能リソース内の拡張機能チェーンの名前。 |
extension |
文字列 | 拡張機能チェーン内の拡張機能の名前。 |
failed_open |
ブール値 | 拡張機能の構成で failOpen が true に設定されている場合、この指標の値 true は、拡張機能がタイムアウトまたは失敗したときに処理が続行されたことを示します。リージョン外部アプリケーション ロードバランサ、リージョン内部アプリケーション ロードバランサ、クロスリージョン内部アプリケーション ロードバランサにのみ適用されます。 |
grpc_status |
enum | gRPC ストリームの最新のステータス。詳細については、 gRPC ステータス コードをご覧ください。 |
per_processing_request_info |
配列 | gRPC ストリームで発生する ext_proc 拡張機能の ProcessingRequest 統計情報、または ext_authz 拡張機能の CheckRequest 統計情報のリスト。 |
per_processing_request_info[].event_type |
enum | ProcessingRequest のイベントタイプ。REQUEST_HEADERS、REQUEST_BODY、RESPONSE_HEADERS、RESPONSE_BODY のいずれかになります。 |
per_processing_request_info[].latency |
期間 | ProcessingRequest メッセージの最初のバイトが拡張機能に送信されてから、ProcessingResponse メッセージの最後のバイトが受信されるまでの時間。 |
per_processing_request_info[].processing_effect |
enum | 処理リクエスト内の各イベントの処理結果。リージョン外部アプリケーション ロードバランサ、リージョン内部アプリケーション ロードバランサ、クロスリージョン内部アプリケーション ロードバランサにのみ適用されます。
次のいずれかの値です。
|
per_processing_request_info[].processing_effect_details |
文字列 | processing_effect が MUTATION_REJECTED の場合、ミューテーションが拒否された理由の詳細。リージョン外部アプリケーション ロードバランサ、リージョン内部アプリケーション ロードバランサ、クロスリージョン内部アプリケーション ロードバランサにのみ適用されます。 |
resource |
文字列 | 拡張機能リソースの名前 |
モニタリング
このセクションでは、Cloud Load Balancing の Service Extensions を使用して構成されたコールアウトをモニタリングする方法について説明します。
Monitoring ダッシュボードを表示する
アプリケーション ロードバランサは、モニタリング データを Cloud Monitoring にエクスポートします。
Monitoring 指標は、次の目的で使用します。
- ロードバランサの構成、使用状況、パフォーマンスの評価
- 問題のトラブルシューティング
- リソースの使用率とユーザー エクスペリエンスの改善
事前定義のダッシュボードを表示する手順は次のとおりです。
- Google Cloud コンソールで、[ダッシュボードの概要] ページに移動します。
- [カテゴリ] セクションで [GCP] をクリックします。
- すべてのロードバランサのダッシュボードのリストを表示するには、[GCP ダッシュボード] リストで、[Google Cloud ロードバランサ] というダッシュボードをクリックします。特定のロードバランサのダッシュボードを表示するには、リストでロードバランサを見つけて、その名前をクリックします。
- ロードバランサ専用の事前定義ダッシュボードを表示するには、適切なダッシュボードを選択します。
Monitoring の事前定義のダッシュボードに加えて、カスタム ダッシュボードを作成して、アラートをセットアップし、Cloud Monitoring API を使用して指標をクエリできます。
詳細については、アプリケーション ロードバランサのドキュメントの「モニタリングとトラブルシューティング」ページ（内部アプリケーション ロードバランサのロギングとモニタリングなど）をご覧ください。
コールアウトの指標をモニタリングする
コールアウト バックエンド サービスの次の指標をモニタリングできます。
プレビューでは、すべてのタイプのアプリケーション ロードバランサの拡張機能について、次の指標をモニタリングできます。これらの指標には接頭辞 networkservices.googleapis.com が付けられます。この接頭辞は、次の表のエントリでは省略されています。
次の表に、各指標の指標タイプ、表示名、種類、タイプ、単位、説明を示します。
| 指標のタイプ | 表示名
種類、タイプ、単位 説明 |
|---|---|
extension/invocation_count
|
拡張機能の呼び出し回数
DELTA、INT64、1
拡張機能に送信された呼び出しの数。 |
extension/invocation_latencies
|
拡張機能呼び出しのレイテンシ
DELTA、DISTRIBUTION、ms
各拡張機能呼び出しのレイテンシから計算された分布。 コールアウト拡張機能にのみ適用されます。プラグインではサポートされていません。 |
extension/sent_chunks_count
|
拡張機能が送信したチャンク数
DELTA、INT64、1
request_body イベントと response_body イベントにのみ適用されます。
拡張機能に送信されたデータ チャンクの数。 |
extension/received_chunks_count
|
拡張機能が受信したチャンク数
DELTA、INT64、1
request_body イベントと response_body イベントにのみ適用されます。
拡張機能から受信したチャンクの数。 |
extension/failed_open_count
|
フェイルオープンでの拡張機能の呼び出し失敗
DELTA、INT64、1
システムがフェイルオープンに構成され、リクエストの続行が許可されたときに、呼び出しが失敗した回数。 |
extension/mutation_rejections_count
|
拡張機能のミューテーション拒否数
DELTA、INT64、1
リクエスト ヘッダー、本文、トレーラーのミューテーションをリクエストしたが拒否された呼び出しの数。拒否は、ミューテーションが無効な場合やサイズ制限を超えた場合など、さまざまな理由で発生する可能性があります。 |
extension/sent_bytes_count
|
拡張機能の送信バイト数
DELTA、INT64、By
拡張機能に送信されたバイト数。 |
extension/received_bytes_count
|
拡張機能の受信バイト数
DELTA、INT64、By
拡張機能から受信したバイト数。 |
次の指標をモニタリングすることもできます。これらの指標には接頭辞 loadbalancing.googleapis.com/ が付けられます。この接頭辞は、表中の項目では省略されています。
| 指標のタイプ | 表示名
種類、タイプ、単位 説明 |
|---|---|
https/backend_request_count、https/external/regional/backend_request_count、https/internal/backend_request_count |
バックエンドのリクエスト数
DELTA、INT64、1
アプリケーション ロードバランサからコールアウト バックエンド サービスが呼び出された回数。 |
https/backend_request_bytes_count、https/external/regional/backend_request_bytes_count、https/internal/backend_request_bytes_count |
バックエンド リクエストのバイト数
DELTA、INT64、By
ロードバランサからコールアウト バックエンド サービスに送信されたバイト数。 |
https/backend_response_bytes_count、https/external/regional/backend_response_bytes_count、https/internal/backend_response_bytes_count |
バックエンド レスポンスのバイト数
DELTA、INT64、By
ロードバランサが拡張機能のバックエンドから受信したバイト数。 |
https/backend_latencies、https/external/regional/backend_latencies、https/internal/backend_latencies |
バックエンド レイテンシ
DELTA、DISTRIBUTION、ms
ロードバランサとコールアウト バックエンド サービス間の各拡張機能呼び出しのレイテンシの合計から計算された分布。60 秒ごとにサンプリングされます。 |