Menyesuaikan metrik pemantauan di ASM - Alibaba Cloud Service Mesh

Setelah Anda mengaktifkan Service Mesh (ASM) untuk sebuah instans, Envoy menghasilkan metrik default yang dapat Anda sesuaikan untuk mesh, namespace, atau beban kerja tertentu. Topik ini menjelaskan cara menyesuaikan metrik pemantauan tersebut di Service Mesh (ASM).

Prasyarat

Kluster telah ditambahkan ke instans ASM. Untuk informasi selengkapnya, lihat Menambahkan kluster ke instans ASM.

Informasi latar belakang

Istio menghasilkan metrik default, dan setiap metrik berisi tag. Bagian ini menjelaskan metrik default yang dihasilkan oleh Istio.

Untuk lalu lintas HTTP, HTTP/2, dan gRPC, Istio menghasilkan metrik berikut:

Request Count (istio_requests_total): Ini adalah COUNTER yang bertambah untuk setiap permintaan yang ditangani oleh proxy Istio.
Request Duration (istio_request_duration_milliseconds): Ini adalah DISTRIBUTION yang mengukur durasi permintaan.
Request Size (istio_request_bytes): Ini adalah DISTRIBUTION yang mengukur ukuran badan permintaan HTTP.
Response Size (istio_response_bytes): Ini adalah DISTRIBUTION yang mengukur ukuran badan respons HTTP.
gRPC Request Message Count (istio_request_messages_total): Ini adalah COUNTER yang bertambah untuk setiap pesan gRPC yang dikirim dari klien.
gRPC Response Message Count (istio_response_messages_total): Ini adalah COUNTER yang bertambah untuk setiap pesan gRPC yang dikirim dari server.

Untuk lalu lintas TCP, Istio menghasilkan metrik berikut:

Tcp Bytes Sent (istio_tcp_sent_bytes_total): Ini adalah COUNTER yang mengukur jumlah total byte yang dikirim selama respons dalam koneksi TCP.
Tcp Bytes Received (istio_tcp_received_bytes_total): Ini adalah COUNTER yang mengukur jumlah total byte yang diterima selama permintaan dalam koneksi TCP.
Tcp Connections Opened (istio_tcp_connections_opened_total): Ini adalah COUNTER yang bertambah untuk setiap koneksi yang dibuka.
Tcp Connections Closed (istio_tcp_connections_closed_total): Ini adalah COUNTER yang bertambah untuk setiap koneksi yang ditutup.

Setiap metrik yang dihasilkan oleh Istio berisi tag default berikut:

DefaultStatTags=["reporter","source_namespace","source_workload","source_workload_namespace","source_principal","source_app","source_version","source_app","source_version","source_cluster","destination_namespace","destination_principal","destination_app","destination_version","destination_service","destination_service_name","destination_service_namespace","destination_port","destination_cluster","request_protocol","request_operation","response_flags","grpc_response_status","connection_security_policy","source_canonical_service","destination_canonical_service","source_canonical_revision","destination_canonical_revision"]

Deskripsi tag

Tag	Deskripsi
reporter	Pelapor permintaan. Nilai tag bervariasi tergantung pada pelapor. Jika pelapor adalah proxy Istio sisi server, nilai tag adalah `destination`. Jika pelapor adalah proxy Istio sisi klien atau gerbang, nilai tag adalah `source`.
source_workload	Nama beban kerja sumber. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
source_workload_namespace	Namespace dari beban kerja sumber. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
source_principal	Principal rekan dari sumber lalu lintas. Nilai tag ini hanya dapat dikumpulkan jika autentikasi rekan telah dibuat.
source_app	Aplikasi sumber yang diidentifikasi oleh tag aplikasi dari beban kerja sumber. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
source_version	Versi beban kerja sumber. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
source_cluster	Kluster dari beban kerja sumber.
destination_namespace	Namespace dari beban kerja tujuan. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
destination_workload	Nama beban kerja tujuan. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
destination_workload_namespace	Namespace dari beban kerja tujuan. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
destination_principal	Principal rekan dari tujuan lalu lintas. Nilai tag ini hanya dapat dikumpulkan jika autentikasi rekan telah dibuat.
destination_app	Aplikasi tujuan yang diidentifikasi oleh tag aplikasi dari beban kerja tujuan. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
destination_version	Versi beban kerja tujuan. Jika tidak ada nilai tag yang dikumpulkan, nilainya adalah `unknown`.
destination_service	Host layanan tujuan yang bertanggung jawab atas permintaan masuk.
destination_service_name	Nama layanan tujuan.
destination_service_namespace	Namespace dari layanan tujuan.
destination_port	Port tujuan.
destination_cluster	Kluster dari beban kerja tujuan.
request_protocol	Protokol permintaan.
request_operation	Operasi yang diminta.
response_flags	Rincian tambahan tentang respons atau koneksi dari proxy.
grpc_response_status	Status respons gRPC.
connection_security_policy	Kebijakan autentikasi layanan dari permintaan.

Prosedur

Untuk instans ASM sebelum V1.15.3.65

(Opsional) Aktifkan pemantauan Prometheus.
Catatan
Jika Anda telah mengaktifkan pemantauan Prometheus, lewati langkah ini.
1. Masuk ke Konsol ASM. Di panel navigasi sebelah kiri, pilih Service Mesh > Mesh Management.
2. Pada halaman Mesh Management, klik nama instans ASM. Di panel navigasi sebelah kiri, pilih ASM Instance > Base Information.
3. Pada halaman Basic Information, klik Feature Settings di pojok kanan atas.
4. Di panel Update Feature Settings, pilih Enable Prometheus Metric Collection, pilih metode pengaktifan sesuai kebutuhan, lalu klik OK.

Menyesuaikan metrik.

Di panel navigasi sebelah kiri, pilih Observability Management Center > Custom Metrics, lalu klik Create.

Pada halaman Create, konfigurasikan parameter dan klik Create.

Item Konfigurasi	Deskripsi
Match Labels	Tetapkan Name ke nama tag dan Value ke nama aplikasi. ASM mencocokkan aplikasi berdasarkan nilai yang ditentukan. Metrik kustom hanya berlaku untuk aplikasi ini.
inboundSidecar	Klik inboundSidecar, lalu klik Add Metric untuk mengonfigurasi tag kustom untuk lalu lintas masuk. Metric Name: Biarkan kosong agar berlaku untuk semua metrik. Metric Dimension: Klik Add Metric Dimension untuk mengonfigurasi Tag dan Expression. Tags To Remove: Tentukan tag yang akan dihapus dari dimensi metrik.
outboundSidecar	Klik outboundSidecar, lalu klik Add Metric untuk mengonfigurasi tag kustom untuk lalu lintas keluar. Metric Name: Biarkan kosong agar berlaku untuk semua metrik. Metric Dimension: Klik Add Metric Dimension untuk mengonfigurasi Tag dan Expression. Tags To Remove: Tentukan tag yang akan dihapus dari dimensi metrik.
gateway	Klik gateway, lalu klik Add Metric untuk mengonfigurasi tag kustom untuk gerbang. Metric Name: Biarkan kosong agar berlaku untuk semua metrik. Metric Dimension: Klik Add Metric Dimension untuk mengonfigurasi Tag dan Expression. Tags To Remove: Tentukan tag yang akan dihapus dari dimensi metrik.

配置inboundSidecar

Catatan

Jika Anda hanya mengonfigurasi inboundSidecar dan membiarkan outboundSidecar serta gateway tidak dikonfigurasi, tag kustom hanya digunakan untuk lalu lintas masuk. Metrik untuk lalu lintas keluar dan gerbang dihasilkan menggunakan metode default.

Untuk instans ASM versi V1.15.3.65 atau lebih baru dan sebelum V1.17.2.35

ASM telah meningkatkan halaman Custom Metrics dan mengganti namanya menjadi Monitoring Metrics. Antarmuka pengguna baru menyederhanakan konfigurasi dan meningkatkan efisiensi. Untuk menggunakan fitur ini, instans ASM Anda harus versi V1.15.3.65-g97cc18dd-aliyun atau lebih baru. Untuk informasi selengkapnya tentang cara meningkatkan instans ASM, lihat Meningkatkan instans ASM.

Masuk ke Konsol ASM. Di panel navigasi sebelah kiri, pilih Service Mesh > Mesh Management.
Pada halaman Mesh Management, klik nama instans ASM. Di panel navigasi sebelah kiri, pilih Observability Management Center > Monitoring metrics.

Pada halaman Monitoring Metrics, klik tab Metric Settings. Konfigurasikan metrik Global atau Custom sesuai kebutuhan.

Mengonfigurasi metrik global

ASM menyediakan beberapa metrik global yang diaktifkan secara default. Anda dapat mengaktifkan atau menonaktifkan metrik ini atau memodifikasi dimensinya sesuai kebutuhan. Untuk informasi selengkapnya tentang metrik tersebut, lihat Deskripsi metrik.

Operasi	Deskripsi
Mengaktifkan atau menonaktifkan metrik global	Untuk mengaktifkan metrik global: Klik tab Global. Untuk metrik target, pilih Enable di kolom CLIENT-side Metrics atau SERVER-side Metrics, lalu klik Save. Untuk menonaktifkan metrik global: Klik tab Global. Untuk metrik target, hapus centang Enable di kolom CLIENT-side Metrics atau SERVER-side Metrics, lalu klik Save.
Memodifikasi dimensi metrik	Klik tab Global. Untuk metrik target, klik Edit Dimensions di kolom CLIENT-side Metrics atau SERVER-side Metrics. Di kotak dialog Configure Custom CLIENT-side Dimensions, pilih dimensi target, klik OK, lalu klik Save.

全局指标

Mengonfigurasi metrik kustom

Klik tab Custom, klik Create, konfigurasikan parameter, lalu klik Create di bagian bawah halaman. Untuk informasi selengkapnya tentang metrik ini, lihat Deskripsi metrik.

Item Konfigurasi	Deskripsi
Namespace	Pilih namespace tempat metrik pemantauan kustom berlaku.
Name	Masukkan nama untuk metrik kustom.
Workload Selector	Klik Add Match Label untuk mengonfigurasi nama tag dan nama beban kerja. ASM mencocokkan aplikasi berdasarkan konfigurasi tersebut. Metrik kustom hanya berlaku untuk aplikasi ini.
Metric Settings	ASM menyediakan beberapa metrik global yang diaktifkan secara default. Anda dapat mengaktifkan atau menonaktifkan metrik tersebut atau memodifikasi dimensinya. Mengaktifkan atau menonaktifkan metrik global: Untuk mengaktifkan metrik global: Untuk metrik target, pilih Enable di kolom CLIENT-side Metrics atau SERVER-side Metrics. Untuk menonaktifkan metrik global: Untuk metrik target, hapus centang Enable di kolom CLIENT-side Metrics atau SERVER-side Metrics. Memodifikasi dimensi: Untuk metrik target, klik Edit Dimensions di kolom CLIENT-side Metrics atau SERVER-side Metrics. Di kotak dialog Configure Custom CLIENT-side Dimensions, pilih dimensi target, lalu klik OK.

自定义指标

Penting

Anda dapat menggunakan pemilih untuk mengonfigurasi metrik untuk satu beban kerja dalam namespace. Pemilih mendukung pemilihan beban kerja berdasarkan tag.
Dalam namespace yang sama, konfigurasi berikut tidak valid:
- Menggunakan pemilih untuk membuat beberapa metrik kustom (resource kustom Telemetry) untuk beban kerja yang sama.
- Membuat beberapa metrik kustom tanpa menentukan pemilih.

Untuk informasi selengkapnya, lihat Workload Selection.

Untuk instans ASM V1.17.2.35 atau lebih baru

Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan observabilitas.

Deskripsi metrik

Tabel berikut menjelaskan metrik pemantauan ASM. Untuk informasi selengkapnya, lihat MetricSelector.IstioMetric.

Catatan

Gerbang ASM hanya mendukung ekspor metrik sisi klien. Sidecar dapat mengekspor metrik sisi klien maupun sisi server.

Metrik	Deskripsi	Metrik yang sesuai di Prometheus
ALL_METRICS	Semua metrik Istio default.	-
REQUEST_COUNT	Counter untuk permintaan aplikasi yang dihasilkan untuk lalu lintas HTTP, HTTP/2, dan gRPC.	istio_requests_total
REQUEST_DURATION	Histogram durasi permintaan untuk lalu lintas HTTP, HTTP/2, dan gRPC.	istio_request_duration_milliseconds
REQUEST_SIZE	Histogram ukuran badan permintaan untuk lalu lintas HTTP, HTTP/2, dan gRPC.	istio_request_bytes
RESPONSE_SIZE	Histogram ukuran badan respons untuk lalu lintas HTTP, HTTP/2, dan gRPC.	istio_response_bytes
TCP_OPENED_CONNECTIONS	Counter untuk koneksi TCP yang dibuka selama siklus hidup beban kerja.	istio_tcp_connections_opened_total
TCP_CLOSED_CONNECTIONS	Counter untuk koneksi TCP yang ditutup selama siklus hidup beban kerja.	istio_tcp_connections_closed_total
TCP_SENT_BYTES	Counter untuk byte yang dikirim selama respons melalui koneksi TCP.	istio_tcp_sent_bytes_total
TCP_RECEIVED_BYTES	Counter untuk byte yang diterima selama permintaan melalui koneksi TCP.	istio_tcp_received_bytes_total
GRPC_REQUEST_MESSAGES	Counter yang bertambah untuk setiap pesan gRPC yang dikirim dari klien.	istio_request_messages_total
GRPC_RESPONSE_MESSAGES	Counter yang bertambah untuk setiap pesan gRPC yang dikirim dari server.	istio_response_messages_total