Alibaba Cloud Service Mesh：自訂資料面訪問日誌

ASM執行個體版本為1.17.2.35以下

1. 登入ASM控制台，在左側導覽列，選擇服務網格 > 網格管理。

2. 在網格管理頁面，單擊目標執行個體名稱，然後在左側導覽列，選擇網格執行個體 > 基本資料。

3. 在基本資料頁面右上方，單擊功能設定。

4. 在功能設定更新面板，選中開啟訪問日誌並將其列印到容器標準輸出，然後單擊確定。

   istio-proxy容器預設輸出包含以下欄位的日誌。如果關閉訪問日誌，istio-proxy容器將不會產生JSON格式的訪問日誌。

   展開查看日誌詳情

   
       "authority_for":"%REQ(:AUTHORITY)%",
       "bytes_received":"%BYTES_RECEIVED%",
       "bytes_sent":"%BYTES_SENT%",
       "downstream_local_address":"%DOWNSTREAM_LOCAL_ADDRESS%",
       "downstream_remote_address":"%DOWNSTREAM_REMOTE_ADDRESS%",
       "duration":"%DURATION%",
       "istio_policy_status":"%DYNAMIC_METADATA(istio.mixer:status)%",
       "method":"%REQ(:METHOD)%",
       "path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%",
       "protocol":"%PROTOCOL%",
       "request_id":"%REQ(X-REQUEST-ID)%",
       "requested_server_name":"%REQUESTED_SERVER_NAME%",
       "response_code":"%RESPONSE_CODE%",
       "response_flags":"%RESPONSE_FLAGS%",
       "route_name":"%ROUTE_NAME%",
       "start_time":"%START_TIME%",
       "trace_id":"%REQ(X-B3-TRACEID)%",
       "upstream_cluster":"%UPSTREAM_CLUSTER%",
       "upstream_host":"%UPSTREAM_HOST%",
       "upstream_local_address":"%UPSTREAM_LOCAL_ADDRESS%",
       "upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%",
       "upstream_transport_failure_reason":"%UPSTREAM_TRANSPORT_FAILURE_REASON%",
       "user_agent":"%REQ(USER-AGENT)%",
       "x_forwarded_for":"%REQ(X-FORWARDED-FOR)%"

ASM執行個體版本為1.17.2.35及以上

1. 登入ASM控制台，在左側導覽列，選擇服務網格 > 網格管理。

2. 在網格管理頁面，單擊目標執行個體名稱，然後在左側導覽列，選擇可觀測管理中心 > 可觀測配置。

3. 在可觀測配置頁面，按需單擊全域、命名空間或自訂頁簽。

   • 若您選擇命名空間頁簽，請單擊建立，按需選擇命名空間。

   • 若您選擇自訂頁簽，請單擊建立，按需選擇命名空間，輸入名稱和匹配標籤。

4. 在日誌設定地區，開啟啟用日誌輸出開關，然後單擊提交。

   開啟開關後，服務網格資料平面Sidecar或網關會將訪問日誌輸出至容器標準輸出。ASM還支援日誌過濾功能，詳情請參見日誌過濾。

5. 在資料平面Sidecar容器的標準輸出查看日誌。

   下文以使用kubectl查看訪問日誌為例進行說明。

   1. 執行以下命令，查看Sidecar日誌。

      kubectl logs httpbin-5c5944c58c-w**** -c istio-proxy --tail 1

      展開查看樣本輸出

      {
          "authority_for":"47.110.XX.XXX",
          "bytes_received":"0",
          "bytes_sent":"22382",
          "downstream_local_address":"192.168.0.29:80",
          "downstream_remote_address":"221.220.XXX.XXX:0",
          "duration":"80",
          "istio_policy_status":"-",
          "method":"GET",
          "path":"/static/favicon.ico",
          "protocol":"HTTP/1.1",
          "request_id":"0f2cf829-3da5-4810-a618-08d9745d****",
          "requested_server_name":"outbound_.8000_._.httpbin.default.svc.cluster.local",
          "response_code":"200",
          "response_flags":"-",
          "route_name":"default",
          "start_time":"2023-06-30T04:00:36.841Z",
          "trace_id":"-",
          "upstream_cluster":"inbound|80||",
          "upstream_host":"192.168.0.29:80",
          "upstream_local_address":"127.0.X.X:55879",
          "upstream_response_time":"79",
          "upstream_service_time":"79",
          "upstream_transport_failure_reason":"-",
          "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.X.X Safari/537.36",
          "x_forwarded_for":"221.220.XXX.XXX"
      }

   2. 執行以下命令，查看入口網關日誌。

      kubectl -n istio-system logs istio-ingressgateway-6cff9b6b58-r**** --tail 1

      展開查看樣本輸出

      {
          "authority_for":"47.110.XX.XXX",
          "bytes_received":"0",
          "bytes_sent":"22382",
          "downstream_local_address":"192.168.0.63:80",
          "downstream_remote_address":"221.220.XXX.XXX:64284",
          "duration":"81",
          "istio_policy_status":"-",
          "method":"GET",
          "path":"/static/favicon.ico",
          "protocol":"HTTP/1.1",
          "request_id":"0f2cf829-3da5-4810-a618-08d9745d****",
          "requested_server_name":"-",
          "response_code":"200",
          "response_flags":"-",
          "route_name":"httpbin",
          "start_time":"2023-06-30T04:00:36.841Z",
          "trace_id":"-",
          "upstream_cluster":"outbound|8000||httpbin.default.svc.cluster.local",
          "upstream_host":"192.168.0.29:80",
          "upstream_local_address":"192.168.0.63:36140",
          "upstream_response_time":"81",
          "upstream_service_time":"81",
          "upstream_transport_failure_reason":"-",
          "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.X.X Safari/537.36",
          "x_forwarded_for":"221.220.XXX.XXX"
      }

6. （可選）通過Container Service控制台查看訪問日誌。

   如果您使用阿里雲Container Service叢集，還可以通過Container Service控制台查看訪問日誌。

   1. 登入Container Service管理主控台，在左側導覽列選擇叢集列表。

   2. 在叢集列表頁面，單擊目的地組群名稱，然後在左側導覽列，選擇工作負載 > 容器組。

   3. 在容器組頁面，單擊目標Pod名稱，然後在頁面下方單擊日誌頁簽，查看訪問日誌。

關於日誌的更多資訊，請參見可觀測配置和啟用控制平面日誌採集和日誌警示（新版）。

ASM執行個體版本為1.17.2.35以下

1. 登入ASM控制台，在左側導覽列，選擇服務網格 > 網格管理。

2. 在網格管理頁面，單擊目標執行個體名稱，然後在左側導覽列，選擇網格執行個體 > 基本資料。

3. 在基本資料頁面的配置資訊地區，單擊開啟訪問日誌並將其列印到容器標準輸出右側的自定義訪問日誌格式。

4. 在自定義訪問日誌格式對話方塊下方，新增自訂訪問日誌格式，設定變數名稱為my_custom_key，變數值為%REQ(end-user)%，然後單擊確認。

   本文以擷取Bookinfo樣本中HTTP請求的Header欄位end-user為例。自訂訪問日誌格式時，您可以選擇ASM提供的可選欄位，也可以新增自訂欄位。選中目標欄位後，將按照自訂的訪問日誌格式輸出訪問日誌。其中，request_duration（%REQUEST_DURATION%）、request_tx_duration（%REQUEST_TX_DURATION%）、response_duration（%RESPONSE_DURATION%）、response_tx_duration（%RESPONSE_TX_DURATION%）四個欄位無需勾選。

ASM執行個體版本為1.17.2.35及以上

1. 登入ASM控制台，在左側導覽列，選擇服務網格 > 網格管理。

2. 在網格管理頁面，單擊目標執行個體名稱，然後在左側導覽列，選擇可觀測管理中心 > 可觀測配置。

3. 在可觀測配置頁面，按需單擊全域、命名空間或自訂頁簽。

   • 若您選擇命名空間頁簽，請單擊建立，按需選擇命名空間。

   • 若您選擇自訂頁簽，請單擊建立，按需選擇命名空間，輸入名稱和匹配標籤。

4. 在日誌設定地區，按需選中欄位、修改目標欄位資訊或在最下方日誌指標右側單擊表徵圖，新增日誌欄位，然後單擊提交。

   只有開啟啟用日誌輸出開關，才能自訂日誌格式。在日誌格式地區，預設選中的日誌欄位為預設必選欄位，不支援修改。日誌欄位支援從請求Header、響應Header、Envoy內建值中取值。

   下文以列印請求中的accept-encoding Header為例，配置變數名稱為accept-encoding，類型為請求屬性，變數值為Accept-Encoding。例如，請求屬性欄位 authority_for 的格式運算式為 %REQ(:AUTHORITY)%，響應屬性欄位 upstream_response_time 的格式運算式為 %RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%，Envoy 內建屬性包括 request_duration、response_duration 等欄位。

5. 執行以下命令，查看服務網格資料平面組件日誌。

   kubectl logs httpbin-5c5944c58c-w**** -c istio-proxy --tail 1|grep accept-encoding --color=auto

   展開查看樣本輸出

   {
       "bytes_received":"0",
       "bytes_sent":"9593",
       "downstream_local_address":"192.168.0.29:80",
       "downstream_remote_address":"69.164.XXX.XX:0",
       "duration":"2",
       "istio_policy_status":"-",
       "method":"GET",
       "path":"/",
       "protocol":"HTTP/1.1",
       "request_id":"29939dc9-62be-4ddf-acf6-32cb098d****",
       "requested_server_name":"outbound_.8000_._.httpbin.default.svc.cluster.local",
       "response_code":"200",
       "response_flags":"-",
       "route_name":"default",
       "start_time":"2023-06-30T04:18:19.734Z",
       "trace_id":"-",
       "upstream_cluster":"inbound|80||",
       "upstream_host":"192.168.0.29:80",
       "upstream_local_address":"127.0.X.X:34723",
       "upstream_service_time":"2",
       "upstream_transport_failure_reason":"-",
       "user_agent":"Mozilla/5.0 zgrab/0.x",
       "x_forwarded_for":"69.164.XXX.XX",
       "authority_for":"47.110.XX.XXX",
       "upstream_response_time":"2",
       "accept-encoding":"gzip"
   }

   可以看到步驟4新增的Accept-Encoding Header的值，已被輸出至訪問日誌。關於日誌的更多資訊，請參見可觀測配置和啟用控制平面日誌採集和日誌警示（新版）。