Alibaba Cloud Service Mesh:可観測性設定を構成する

前提条件

V1.17.2.35 以降の ASM インスタンスが作成されています。 詳細については、「ASM インスタンスを作成する」または「ASM インスタンスを更新する」をご参照ください。

適用範囲

手順

ログ設定

[ログ設定] セクションでは、アクセスログ出力の有効化または無効化、アクセスログの出力形式のカスタマイズ、アクセスログの形式のカスタマイズ、およびログのフィルタリングを行うことができます。

アクセスログ出力を有効または無効にする

1. [ログ設定] セクションで、ビジネス要件に基づいて [ログ出力を有効にする] スイッチをオンまたはオフにします。

   • スイッチをオンにすると、ASM インスタンスのデータプレーン上のサイドカープロキシまたはゲートウェイは、アクセスログをコンテナに送信し、コンテナはログを stdout 出力ストリームに出力します。

   • スイッチをオフにすると、ASM インスタンスのデータプレーン上のサイドカープロキシまたはゲートウェイは、コンテナへのアクセスログの送信を停止し、コンテナはログを stdout 出力ストリームに出力しなくなります。

2. データプレーン上のサイドカーコンテナの標準出力ストリームでログを表示します。

   次の例は、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（ACK）コンソールでアクセスログを表示します。

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

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

   2. [クラスタ] ページで、管理するクラスタを見つけて名前をクリックします。 左側のウィンドウで、[ワークロード] > [ポッド] を選択します。

   3. [ポッド] ページで、目的のポッドの名前をクリックし、[ログ] タブをクリックしてアクセスログを表示します。

アクセスログの出力形式をカスタマイズする

[ログ設定] セクションで、ビジネス要件に基づいて [ログ出力形式] パラメータを [JSON] または [テキスト] に設定します。

• パラメータを [JSON] に設定すると、アクセスログは JSON 文字列として対応するコンテナに出力されます。

• パラメータを [テキスト] に設定すると、アクセスログはプレーンテキスト文字列として対応するコンテナに出力されます。

アクセスログの形式をカスタマイズする

1. [ログ設定] セクションで、目的のカスタムフィールドを選択するか、カスタムフィールドの情報を変更します。 下部にあるログメトリックの右側にある アイコンをクリックして、ログフィールドを追加することもできます。

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

   次の例では、[accessLogFormat キー] を accept-encoding に、[タイプ] を [リクエストプロパティ] に、[accessLogFormat 値] を Accept-Encoding に設定して、リクエスト内の accept-encoding ヘッダーを出力します。

2. 次のコマンドを実行して、ASM インスタンスのデータプレーン上のコンポーネントのログを表示します。

   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 ヘッダーの値がアクセスログに出力されます。

ログをフィルタリングする

[ログ設定] セクションの下部で、[ログフィルターを有効にする] を選択し、ビジネス要件に基づいてテキストボックスにログフィルター式を入力します。 式と一致しないリクエストのアクセスログは出力されません。

たとえば、レスポンスの HTTP ステータスコード が 400 以上のリクエストのログを出力するには、式を response.code >= 400 に設定します。 詳細については、「CEL 式とよく使用される属性」をご参照ください。

CEL 式とよく使用される属性

ログフィルター式は、Common Expression Language（CEL）で記述されます。 次の表は、CEL 式でよく使用される属性について説明しています。 詳細については、「CEL」および「Envoy」をご参照ください。

メトリック設定

メトリック設定には、メトリックの有効化または無効化と、メトリックディメンションの編集が含まれます。

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

トレース分析設定

トレース構成には、サンプリング率とカスタムタグが含まれます。 トレースでは、完全なトレースを構築するために、コールチェーン全体で一貫したレポート構成が必要になります。 レポートエンドポイントまたはサンプリングレートに一貫性がないと、トレースが不完全になる可能性があります。 このため、1.24.6.83 より前のバージョンでは、名前空間レベルまたはワークロードレベルのトレース構成はサポートされていません。 1.24.6.83 以降のバージョンでは、ASM は Kubernetes API を介した Telemetry リソースの変更をサポートしており、名前空間レベルおよびワークロードレベルのトレース構成を有効にできます。 詳細については、「Telemetry フィールドの説明」をご参照ください。