Alibaba Cloud Service Mesh:Pengaturan observabilitas ASM

Output log akses

1. Di bagian Log Settings, alihkan sakelar Enable Log Output sesuai kebutuhan.

   • Jika diaktifkan, sidecar atau gerbang (gateway) pada bidang data (data plane) akan mengeluarkan log akses ke standard output (stdout) kontainer.

   • Jika dinonaktifkan, sidecar atau gerbang pada bidang data tidak lagi mengeluarkan log ke stdout kontainer.

2. Lihat log di stdout kontainer sidecar bidang data.

   Contoh berikut menunjukkan cara melihat log akses menggunakan kubectl.

   1. Jalankan perintah berikut untuk melihat log sidecar:

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

      Contoh output

      {
          "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. Jalankan perintah berikut untuk melihat log gerbang masuk (ingress gateway):

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

      Contoh output

      {
          "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. (Opsional) Lihat log akses di konsol Container Service for Kubernetes.

   Jika Anda menggunakan kluster Alibaba Cloud Container Service for Kubernetes (ACK), Anda juga dapat melihat log akses di konsol ACK.

   1. Login ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

   2. Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Workloads > Pods.

   3. Di halaman Pods, klik nama pod target, lalu klik tab Logs di bagian bawah halaman untuk melihat log akses.

Format output log

Di bagian Log Settings, atur Log Output Format menjadi JSON atau TEXT sesuai kebutuhan.

• Jika Anda memilih JSON, log akses akan dikeluarkan ke stdout kontainer sebagai string JSON.

• Jika Anda memilih TEXT, log akses akan dikeluarkan ke stdout kontainer sebagai string teks biasa.

Format log kustom

1. Di bagian Log Settings, pilih field, modifikasi informasi field kustom, atau klik ikon di bagian bawah daftar field log untuk menambahkan field log baru.

   Anda hanya dapat menyesuaikan format log ketika sakelar Enable Log Output diaktifkan. Di bagian Log Format, field log yang dipilih secara default bersifat wajib dan tidak dapat dibatalkan pemilihannya. Nilai field log dapat diambil dari header permintaan (request headers), header respons (response headers), atau nilai Envoy bawaan.

   Sebagai contoh, untuk mencatat header permintaan accept-encoding, atur accessLogFormat key menjadi accept-encoding, Type menjadi Request Properties, dan accessLogFormat value menjadi Accept-Encoding. Templat format untuk header permintaan adalah %REQ(HEADER_NAME)% (misalnya, %REQ(:AUTHORITY)%), untuk header respons adalah %RESP(HEADER_NAME)% (misalnya, %RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%), dan untuk atribut Envoy bawaan adalah %ATTRIBUTE_NAME% (misalnya, %REQUEST_DURATION%).

2. Jalankan perintah berikut untuk melihat log komponen bidang data di service mesh.

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

   Contoh output

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

   Log akses sekarang menampilkan nilai header Accept-Encoding yang Anda tambahkan di langkah 1.

Penyaringan log

Di bagian Log Settings, pilih Enable Log Filter untuk mengaktifkan penyaringan log, lalu masukkan ekspresi penyaringan di kotak teks. Log akses hanya dihasilkan untuk permintaan yang sesuai dengan ekspresi tersebut.

Sebagai contoh, untuk mencatat hanya permintaan yang memenuhi kondisi Response Http Status >= 400, gunakan ekspresi response.code >= 400. Untuk informasi selengkapnya, lihat Ekspresi CEL dan field umum.

Pembuatan metrik

Metrik dikategorikan sebagai metrik sisi klien dan metrik sisi server.

• Metrik sisi klien: Metrik yang dihasilkan ketika sidecar bertindak sebagai klien untuk memulai permintaan. Metrik gerbang (gateway) juga dikategorikan sebagai metrik sisi klien.

• Metrik sisi server: Metrik yang dihasilkan ketika sidecar bertindak sebagai server untuk menerima permintaan.

1. Di bagian Metric Settings, pada kolom Client-Side Metrics atau Server-Side Metrics, centang atau hapus centang kotak Enabled untuk metrik sesuai kebutuhan.

   • Jika metrik diaktifkan, sidecar atau gerbang bidang data mengekspos metrik ini melalui path /stats/prometheus pada port 15020.

   • Jika metrik dinonaktifkan, metrik tersebut tidak diekspos pada port dan path yang ditentukan.

2. Jalankan perintah berikut untuk melihat metrik yang diekspos oleh sidecar atau gerbang.

   Anda dapat menggunakan kubectl untuk menjalankan perintah curl di dalam kontainer sidecar atau gerbang guna mengakses path /stats/prometheus pada port lokal 15020 dan melihat metrik yang diekspor.

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

   Contoh output:

   # 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
   ......

Dimensi metrik

Dimensi metrik memberikan informasi kontekstual yang kaya. Anda dapat menggunakan dimensi ini untuk menyaring metrik target di Prometheus. Misalnya, Anda dapat menggunakan dimensi source_app untuk menyaring metrik permintaan dari aplikasi klien tertentu.

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

Persentase sampling

Anda dapat menyesuaikan persentase sampling untuk tracing, yang menentukan persentase permintaan yang akan menghasilkan jejak. Nilai 0 menonaktifkan tracing.

Tag kustom

Anda dapat menyesuaikan tag yang dilampirkan pada rentang tracing (tracing spans) yang dilaporkan. Di bagian Tracing Analysis Settings, klik Add Custom Tags, lalu konfigurasikan Name, Type, dan Value.

Jenis yang valid meliputi Fixed Value, Request Header, dan Environment Variable. Tabel berikut menjelaskan setiap jenis beserta contohnya.