Alibaba Cloud Service Mesh:ASM の可観測性設定

アクセスログ出力

1. Log Settings セクションで、必要に応じて Enable Log Output スイッチをオンまたはオフに切り替えます。

   • このオプションを有効にすると、データプレーン上のサイドカーまたはゲートウェイは、コンテナの標準出力 (stdout) にアクセスログを出力します。

   • このオプションを無効にすると、データプレーン上のサイドカーまたはゲートウェイは、コンテナの stdout へのログ出力を停止します。

2. データプレーンのサイドカーコンテナの stdout でログを表示します。

   以下の例は、kubectl を使用してアクセスログを表示する方法を示しています。

   1. 次のコマンドを実行して、サイドカーのログを表示します。

      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"
      }

3. (オプション) Container Service for Kubernetes コンソールでアクセスログを表示します。

   Alibaba Cloud Container Service for Kubernetes (ACK) クラスターを使用している場合は、ACK コンソールでアクセスログを表示することもできます。

   1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。

   2. クラスターリスト ページで、クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ワークロード > ポッド をクリックします。

   3. ポッド ページで、目的の Pod の名前をクリックし、次にページの下部にある ログ タブをクリックしてアクセスログを表示します。

ログ出力フォーマット

Log Settings セクションで、必要に応じて Log Output Format を JSON または TEXT に設定します。

• [JSON] を選択すると、アクセスログは JSON 文字列としてコンテナの stdout に出力されます。

• [TEXT] を選択すると、アクセスログはプレーンテキスト文字列としてコンテナの stdout に出力されます。

カスタムログフォーマット

1. Log Settings セクションで、フィールドを選択するか、カスタムフィールド情報を変更するか、またはログフィールドリストの下部にある アイコンをクリックして新しいログフィールドを追加します。

   [ログ出力を有効にする] スイッチがオンの場合にのみ、ログフォーマットをカスタマイズできます。Log Format セクションでは、デフォルトで選択されているログフィールドは必須であり、選択解除できません。ログフィールド値は、リクエストヘッダー、レスポンスヘッダー、または Envoy の組み込み値から取得できます。

   例えば、accept-encoding リクエストヘッダーをログに記録するには、accessLogFormat key を accept-encoding に、Type を Request Properties に、accessLogFormat value を Accept-Encoding に設定します。リクエストヘッダーのフォーマットテンプレートは %REQ(HEADER_NAME)% (例: %REQ(:AUTHORITY)%)、レスポンスヘッダーの場合は %RESP(HEADER_NAME)% (例: %RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%)、Envoy の組み込み属性の場合は %ATTRIBUTE_NAME% (例: %REQUEST_DURATION%) です。

2. 次のコマンドを実行して、サービスメッシュ内のデータプレーンコンポーネントのログを表示します。

   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"
   }

   アクセスログには、ステップ 1 で追加した Accept-Encoding ヘッダーの値が表示されます。

ログフィルタリング

Log Settings セクションで、Enable Log Filter を選択してログフィルタリングを有効にし、テキストボックスにフィルタリング式を入力します。アクセスログは、式に一致するリクエストに対してのみ生成されます。

たとえば、レスポンス HTTP ステータス >= 400 という条件を満たすリクエストのみをログに記録するには、式 response.code >= 400 を使用します。詳細については、「CEL 式および一般的なフィールド」をご参照ください。

メトリック生成

メトリックは、クライアント側メトリックとサーバー側メトリックに分類されます。

• クライアント側メトリック：サイドカーがクライアントとしてリクエストを開始する際に生成されるメトリック。ゲートウェイメトリックもクライアント側メトリックに分類されます。

• サーバー側メトリック：サイドカーがサーバーとしてリクエストを受信する際に生成されるメトリック。

1. Metric Settings セクションの、Client-Side Metrics 列または Server-Side Metrics 列で、必要に応じてメトリックの Enabled チェックボックスを選択または選択解除します。

   • メトリックが有効な場合、データプレーン サイドカーまたはゲートウェイは、ポート 15020 の /stats/prometheus パスを介してこのメトリックを公開します。

   • メトリックが無効な場合、指定されたポートとパスでは公開されません。

2. 次のコマンドを実行して、サイドカーまたはゲートウェイによって公開されるメトリックを表示します。

   kubectl を使用して、サイドカーまたはゲートウェイコンテナ内で curl コマンドを実行し、ローカルポート 15020 の /stats/prometheus パスにアクセスして、エクスポートされたメトリックを表示できます。

   kubectl exec httpbin-5c5944c58c-w**** -c istio-proxy -- curl 127.0.0.1:15020/stats/prometheus|head -n 10

   出力例：

   # TYPE istio_agent_cert_expiry_seconds gauge
   istio_agent_cert_expiry_seconds{resource_name="default"} 46725.287654548
   # HELP istio_agent_endpoint_no_pod Endpoints without an associated pod.
   # TYPE istio_agent_endpoint_no_pod gauge
   istio_agent_endpoint_no_pod 0
   # HELP istio_agent_go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.
   # TYPE istio_agent_go_gc_duration_seconds summary
   istio_agent_go_gc_duration_seconds{quantile="0"} 5.0149e-05
   istio_agent_go_gc_duration_seconds{quantile="0.25"} 9.8807e-05
   ......

メトリックディメンション

メトリックディメンションは、豊富なコンテキスト情報を提供します。これらのディメンションを使用して、Prometheus でターゲットメトリックをフィルタリングできます。例えば、source_app ディメンションを使用して、特定のクライアントアプリケーションからのリクエストのメトリックをフィルタリングできます。

kubectl exec httpbin-5c5944c58c-w**** -c istio-proxy -- curl 127.0.0.1:15020/stats/prometheus

istio_request_bytes_sum{reporter="destination",source_workload="istio-ingressgateway",source_canonical_service="unknown",source_canonical_revision="latest",source_workload_namespace="istio-system",source_principal="spiffe://cluster.local/ns/istio-system/sa/istio-ingressgateway",source_app="istio-ingressgateway",source_version="unknown",source_cluster="c479fc4abd2734bfaaa54e9e36fb26c01",destination_workload="httpbin",destination_workload_namespace="default",destination_principal="spiffe://cluster.local/ns/default/sa/httpbin",destination_app="httpbin",destination_version="v1",destination_service="httpbin.default.svc.cluster.local",destination_canonical_service="httpbin",destination_canonical_revision="v1",destination_service_name="httpbin",destination_service_namespace="default",destination_cluster="c479fc4abd2734bfaaa54e9e36fb26c01",request_protocol="http",response_code="200",grpc_response_status="",response_flags="-",connection_security_policy="mutual_tls"} 18000

istio_request_bytes_sum{response_code="200"} 16550

istio_request_bytes_sum{response_code="200",request_path="/spec.json"} 5800

サンプリング率

トレーシングのサンプリング率をカスタマイズできます。これは、トレースが生成されるリクエストの割合を決定します。値 0 はトレーシングを無効にします。

カスタムタグ

レポートされたトレーシングスパンにアタッチされたタグをカスタマイズできます。Tracing Analysis Settings セクションで、Add Custom Tags をクリックし、Name、Type、Value を設定します。

有効なタイプには、固定値、リクエストヘッダー、環境変数があります。次の表に、各タイプの説明と設定例を示します。