All Products
Search

This Product

    Alibaba Cloud Service Mesh:Menyesuaikan metrik di ASM

    Document Center

    Alibaba Cloud Service Mesh:Menyesuaikan metrik di ASM

    Last Updated:Jun 22, 2026

    Setelah Anda mengaktifkan pengumpulan metrik Prometheus untuk instans Service Mesh ASM, proxy Envoy-nya mulai menghasilkan serangkaian metrik default. ASM memungkinkan Anda menyesuaikan metrik ini pada tingkat mesh, Service Mesh, atau Service Mesh untuk observabilitas yang lebih terarah. Topik ini menjelaskan cara menyesuaikan metrik di Service Mesh ASM.

    Prasyarat

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

    Latar Belakang

    Istio menghasilkan metrik berikut:

    • Untuk traffic HTTP, HTTP/2, dan gRPC, Istio menghasilkan metrik berikut:

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

    • Untuk traffic TCP, Istio menghasilkan metrik berikut:

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

    Setiap metrik Istio mencakup label default berikut:

    DefaultStatTags=["reporter","source_namespace","source_workload","source_workload_namespace","source_principal","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"]

    Referensi label

    Label

    Deskripsi

    reporter

    Entitas yang melaporkan permintaan. Nilai label ini bervariasi berdasarkan reporter:

    • destination jika proxy Istio sisi server adalah reporter.

    • source jika proxy Istio sisi client atau gateway adalah reporter.

    source_workload

    Nama workload sumber. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    source_workload_namespace

    Namespace workload sumber. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    source_principal

    Principal peer dari sumber traffic. Nilai ini hanya dikumpulkan jika autentikasi peer dikonfigurasi.

    source_app

    Aplikasi sumber, diidentifikasi berdasarkan label aplikasi dari workload sumber. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    source_version

    Versi workload sumber. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    source_cluster

    Kluster workload sumber.

    destination_namespace

    Namespace workload tujuan. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    destination_workload

    Nama workload tujuan. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    destination_workload_namespace

    Namespace workload tujuan. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    destination_principal

    Principal peer dari tujuan traffic. Nilai ini hanya dikumpulkan jika autentikasi peer dikonfigurasi.

    destination_app

    Aplikasi tujuan, diidentifikasi berdasarkan label aplikasi dari workload tujuan. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    destination_version

    Versi workload tujuan. Default-nya unknown jika nilainya tidak dapat dikumpulkan.

    destination_service

    Host layanan tujuan yang menangani permintaan.

    destination_service_name

    Nama layanan tujuan.

    destination_service_namespace

    Namespace layanan tujuan.

    destination_port

    Port tujuan.

    destination_cluster

    Kluster workload tujuan.

    request_protocol

    Protokol permintaan.

    request_operation

    Operasi permintaan.

    response_flags

    Detail tambahan tentang respons atau koneksi dari proxy.

    grpc_response_status

    Status respons gRPC.

    connection_security_policy

    Kebijakan autentikasi layanan dari permintaan.

    Prosedur

    Sebelum v1.15.3.65

    1. Opsi: Aktifkan pemantauan Prometheus.

      Catatan

      Jika Anda telah mengaktifkan pemantauan Prometheus, lewati langkah ini.

      1. Masuk ke Konsol ASM. Di panel navigasi kiri, pilih Service Mesh > Mesh Management.

      2. Pada halaman Mesh Management, klik nama instans ASM. Di panel navigasi kiri, pilih ASM Instance > Base Information.

      3. Pada halaman Basic Information, klik Settings di pojok kanan atas.

      4. Di panel Settings Update, pilih Enable Prometheus monitoring, pilih opsi sesuai kebutuhan, lalu klik OK.

    2. Sesuaikan metrik.

      1. Di panel navigasi kiri, pilih Observability Management Center > Customized Metrics, lalu klik Create.

      2. Pada halaman Create, konfigurasikan parameter, lalu klik Create.

        Parameter

        Deskripsi

        Match Label

        Atur Name ke nama label dan Value ke nama aplikasi. Metrik kustom hanya berlaku untuk aplikasi yang sesuai dengan label ini.

        inboundSidecar

        Klik inboundSidecar, lalu klik Add Metrics untuk mengonfigurasi label kustom untuk traffic inbound.

        • Metric Name: Biarkan kosong agar konfigurasi berlaku untuk semua metrik.

        • Metric Dimension: Klik Add Dimension untuk mengonfigurasi Tag dan Expression.

        • Tags_to_remove: Tentukan label dimensi yang akan dihapus.

        outboundSidecar

        Klik outboundSidecar, lalu klik Add Metrics untuk mengonfigurasi label kustom untuk traffic outbound.

        • Metric Name: Biarkan kosong agar konfigurasi berlaku untuk semua metrik.

        • Metric Dimension: Klik Add Dimension untuk mengonfigurasi Tag dan Expression.

        • Tags_to_remove: Tentukan label dimensi yang akan dihapus.

        gateway

        Klik gateway, lalu klik Add Metrics untuk mengonfigurasi label kustom untuk gateway.

        • Metric Name: Biarkan kosong agar konfigurasi berlaku untuk semua metrik.

        • Metric Dimension: Klik Add Dimension untuk mengonfigurasi Tag dan Expression.

        • Tags_to_remove: Tentukan label dimensi yang akan dihapus.
        Catatan

        Jika Anda hanya mengonfigurasi inboundSidecar dan tidak mengonfigurasi outboundSidecar serta gateway, label kustom hanya berlaku untuk traffic inbound. Metrik default dihasilkan untuk traffic outbound dan gateway.

    v1.15.3.65 hingga v1.17.2.35

    ASM mengganti halaman Customized Metrics dengan halaman Monitoring metrics. UI baru ini menyederhanakan konfigurasi. Untuk menggunakan fitur ini, instans ASM Anda harus versi v1.15.3.65-g97cc18dd-aliyun atau lebih baru. Untuk mempelajari cara upgrade instans, lihat Upgrade instans ASM.

    1. Masuk ke Konsol ASM. Di panel navigasi kiri, pilih Service Mesh > Mesh Management.

    2. Pada halaman Mesh Management, klik nama instans ASM. Di panel navigasi kiri, pilih Observability Management Center > Monitoring metrics.

    3. Pada halaman Monitoring metrics, klik tab Metric setting untuk mengonfigurasi metrik Global atau custom sesuai kebutuhan.

      • Konfigurasi metrik global

        ASM menyediakan serangkaian metrik global default yang diaktifkan secara default. Anda dapat mengaktifkan atau menonaktifkan metrik terkait atau memodifikasi dimensinya sesuai kebutuhan. Untuk informasi lebih lanjut tentang metrik tersebut, lihat Referensi metrik.

        Tindakan

        Deskripsi

        Aktifkan atau nonaktifkan metrik global

        • Untuk mengaktifkan metrik global: Klik tab Global. Temukan metrik target dan centang kotak Enabled di kolom client-side metric atau server-side metric, lalu klik preserve.

        • Untuk menonaktifkan metrik global: Klik tab Global. Temukan metrik target dan hapus centang kotak Enabled di kolom client-side metric atau server-side metric, lalu klik preserve.

        Modifikasi dimensi metrik

        1. Klik tab Global. Temukan metrik target dan klik Edit dimension di kolom client-side metric atau server-side metric.

        2. Di kotak dialog Customize CLIENT dimension configuration, pilih dimensi target, klik Confirm, lalu klik preserve.

        Metrik global mencakup ALL_METRICS, REQUEST_COUNT, REQUEST_DURATION, REQUEST_SIZE, dan RESPONSE_SIZE. Dimensi yang dihapus, seperti source_app dan source_version, ditampilkan di baris metrik terkait.

      • Konfigurasi metrik kustom

        Klik tab custom dan klik Create. Konfigurasikan parameter, lalu klik Create di bagian bawah halaman. Untuk informasi lebih lanjut tentang metrik tersebut, lihat Referensi metrik.

        Parameter

        Deskripsi

        Namespaces

        Pilih namespace tempat metrik kustom berlaku.

        Name

        Masukkan nama untuk konfigurasi metrik kustom.

        Workload selection

        Klik Add Matching Label untuk mengonfigurasi nama label dan nama workload. ASM mencocokkan aplikasi berdasarkan konfigurasi ini, dan metrik kustom hanya berlaku untuk aplikasi yang cocok.

        Metric setting

        ASM menyediakan serangkaian metrik global default yang diaktifkan secara default. Anda dapat mengaktifkan atau menonaktifkan metrik terkait atau memodifikasi dimensinya.

        • Aktifkan atau nonaktifkan metrik global:

          • Untuk mengaktifkan metrik global: Temukan metrik target dan centang kotak Enabled di kolom client-side metric atau server-side metric.

          • Untuk menonaktifkan metrik global: Temukan metrik target dan hapus centang kotak Enabled di kolom client-side metric atau server-side metric.

        • Modifikasi dimensi:

          1. Temukan metrik target dan klik Edit dimension di kolom client-side metric atau server-side metric.

          2. Di kotak dialog Customize CLIENT dimension configuration, pilih dimensi target, lalu klik Confirm.
    Penting

    • Anda dapat menggunakan selector untuk mengonfigurasi metrik untuk workload tertentu dalam namespace. Selector memungkinkan Anda memilih workload berdasarkan label-nya.

    • Konfigurasi berikut tidak valid dalam namespace yang sama:

      • Menggunakan selector untuk membuat beberapa metrik kustom (Telemetry CR) untuk workload yang sama.

      • Membuat beberapa metrik kustom tanpa menentukan selector.

    Untuk informasi lebih lanjut, lihat Workload selection.

    v1.17.2.35 dan seterusnya

    Untuk informasi lebih lanjut, lihat Konfigurasi pengaturan observabilitas.

    Referensi metrik

    Tabel berikut menjelaskan metrik di ASM. Untuk informasi lebih lanjut, lihat MetricSelector.IstioMetric.

    Catatan

    Gateway ASM hanya mengekspor metrik sisi client. Sidecar dapat mengekspor metrik sisi client maupun sisi server.

    Metrik

    Deskripsi

    Metrik Prometheus

    ALL_METRICS

    Mewakili semua metrik Istio default.

    -

    REQUEST_COUNT

    Penghitung permintaan aplikasi untuk traffic HTTP, HTTP/2, dan gRPC.

    istio_requests_total

    REQUEST_DURATION

    Histogram durasi permintaan untuk traffic HTTP, HTTP/2, dan gRPC.

    istio_request_duration_milliseconds

    REQUEST_SIZE

    Histogram ukuran badan permintaan untuk traffic HTTP, HTTP/2, dan gRPC.

    istio_request_bytes

    RESPONSE_SIZE

    Histogram ukuran badan respons untuk traffic HTTP, HTTP/2, dan gRPC.

    istio_response_bytes

    TCP_OPENED_CONNECTIONS

    Penghitung koneksi TCP yang dibuka selama masa pakai workload.

    istio_tcp_connections_opened_total

    TCP_CLOSED_CONNECTIONS

    Penghitung koneksi TCP yang ditutup selama masa pakai workload.

    istio_tcp_connections_closed_total

    TCP_SENT_BYTES

    Penghitung byte yang dikirim selama respons melalui koneksi TCP.

    istio_tcp_sent_bytes_total

    TCP_RECEIVED_BYTES

    Penghitung byte yang diterima selama permintaan melalui koneksi TCP.

    istio_tcp_received_bytes_total

    GRPC_REQUEST_MESSAGES

    Penghitung yang bertambah untuk setiap pesan gRPC yang dikirim oleh client.

    istio_request_messages_total

    GRPC_RESPONSE_MESSAGES

    Penghitung yang bertambah untuk setiap pesan gRPC yang dikirim oleh server.

    istio_response_messages_total