このページでは、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 |
duration | ProcessingRequest メッセージの最初のバイトが拡張機能に送信された時点から、ProcessingResponse メッセージの最後のバイトが受信された時点までの時間。 |
per_processing_request_info[].processing_effect |
enum | 処理リクエスト内の各イベントの処理結果。リージョン外部アプリケーション ロードバランサ、リージョン内部アプリケーション ロードバランサ、クロスリージョン内部アプリケーション ロードバランサにのみ適用されます。
次のいずれかの値です。
|
per_processing_request_info[].processing_effect_details |
文字列 | processing_effect が MUTATION_REJECTED の場合、ミューテーションが拒否された理由の詳細。リージョン外部アプリケーション ロードバランサ、リージョン内部アプリケーション ロードバランサ、クロスリージョン内部アプリケーション ロードバランサにのみ適用されます。 |
resource |
文字列 | 拡張機能リソースの名前 |
モニタリング
このセクションでは、Cloud Load Balancing 用にサービス拡張機能を使用して構成されたコールアウトをモニタリングする方法について説明します。
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 秒ごとにサンプリングされます。 |