記錄及監控 Secure Web Proxy 呼叫

預覽

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

本頁面說明如何搭配 Secure Web Proxy 的 Service Extensions 呼叫，設定及使用 Cloud Logging 和 Cloud Monitoring。

記錄

Secure Web Proxy 會使用 Logging 擷取及儲存多種記錄，包括與擴充功能相關的記錄。如要瞭解 Secure Web Proxy 記錄，請參閱「記錄」。

一般來說，應用程式負載平衡器記錄項目包含實用資訊，有助監控 HTTP 或 HTTPS 流量及偵錯。記錄項目包含下列資訊類型：

• 大部分 Google Cloud 記錄檔中顯示的資訊，例如嚴重性、專案 ID、專案編號和時間戳記，如 LogEntry 記錄檔所述。
• HttpRequest 記錄欄位。

HTTP 和 HTTPS 負載平衡器的要求記錄，在負載平衡器記錄項目 JSON 酬載中包含 service_extension_info 物件，其中含有下列資訊：

欄位	類型	說明
backend_target_name	字串	擴充功能後端目標的名稱。
backend_target_type	字串	後端目標的類型。
chain	字串	服務擴充功能資源中，符合要求的擴充功能鏈結名稱。
extension	字串	擴充功能鏈結中的擴充功能名稱。
failed_open	布林值	如果擴充功能設定將 failOpen 設為 true，這項指標的值為 true，表示擴充功能逾時或失敗時，處理作業仍會繼續。 僅適用於區域性外部應用程式負載平衡器、區域性內部應用程式負載平衡器，以及跨區域內部應用程式負載平衡器。
grpc_status	列舉	gRPC 串流的最新狀態。詳情請參閱 gRPC 狀態碼。
per_processing_request_info	陣列	ext_proc 擴充功能的 ProcessingRequest 統計資料清單，或 gRPC 串流中 ext_authz 擴充功能的 CheckRequest 統計資料清單。
per_processing_request_info[].event_type	列舉	ProcessingRequest 的事件類型。可以是下列其中一項：REQUEST_HEADERS、REQUEST_BODY、RESPONSE_HEADERS 或 RESPONSE_BODY。
per_processing_request_info[].latency	持續時間	從 ProcessingRequest 訊息的第一個位元組傳送至擴充功能，到收到 ProcessingResponse 訊息的最後一個位元組，這段時間的長度。
per_processing_request_info[].processing_effect	列舉	處理要求中每個事件的處理結果。 僅適用於區域性外部應用程式負載平衡器、區域性內部應用程式負載平衡器，以及跨區域內部應用程式負載平衡器。 可以是下列其中一個值： NONE：表示內容未變更。 NONE_FAILED_OPEN：表示未執行任何變異，因為擴充功能無法開啟。 CONTENT_MODIFIED：表示內容已因成功套用變更要求而變更。 IMMEDIATE_RESPONSE：表示擴充功能已立即傳送回應，停止所有後續處理作業。 MUTATION_REJECTED：表示擴充功能要求至少一項不允許的變更，且已停止進一步處理。系統會記錄適當的錯誤訊息。 UNSPECIFIED：表示處理效果不明。
per_processing_request_info[].processing_effect_details	字串	當 processing_effect 為 MUTATION_REJECTED 時，系統會顯示變動遭拒的詳細原因。 僅適用於區域性外部應用程式負載平衡器、區域性內部應用程式負載平衡器，以及跨區域內部應用程式負載平衡器。
resource	字串	擴充功能資源名稱

監控

如要瞭解 Secure Web Proxy 的 Monitoring 指標，請參閱「可用指標」。

在預先發布版中，您可以監控所有類型應用程式負載平衡器的擴充功能指標。這些指標的前置字元為 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 從擴充功能接收的位元組數。