全部产品
Search

搜索本产品

    Application Real-Time Monitoring Service：Menambahkan dan menggunakan tag

    文档中心

    Application Real-Time Monitoring Service：Menambahkan dan menggunakan tag

    更新时间：Jul 06, 2025

    Tag dari Application Real-Time Monitoring Service (ARMS) memungkinkan Anda mengorganisir dan memantau data seperti metrik Pemantauan Aplikasi, jejak, dan log. Topik ini menjelaskan cara menghubungkan aplikasi ke pusat tag, menambahkan tag ke aplikasi, serta menggunakan tag untuk menanyakan metrik pada halaman detail aplikasi dan tampilan Grafana.

    Prasyarat

    Aplikasi harus dipantau oleh Pemantauan Aplikasi. Untuk informasi lebih lanjut, lihat Ikhtisar Pemantauan Aplikasi.

    Untuk aplikasi Java, persyaratan berikut harus dipenuhi:

    • Jika aplikasi diterapkan di kluster Kubernetes, versi ack-onepilot adalah V3.0.4 atau yang lebih baru dan versi ARMS agent adalah V2.7.3.5 atau yang lebih baru.

    • Jika aplikasi diterapkan di lingkungan lain, versi ARMS agent adalah V2.7.3.5 atau yang lebih baru. Untuk mendapatkan paket instalasi terbaru dari ARMS agent, lakukan operasi berikut: Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Application Monitoring > Agent Management. Di halaman Manajemen Agent, klik tab Agent Release Notes.

    Jenis-jenis Tag

    Pemantauan Aplikasi menyediakan tag aplikasi dan tag instance. Pilih jenis tag berdasarkan kebutuhan bisnis Anda. Baik tag aplikasi maupun tag instance menggunakan pasangan kunci-nilai. Anda dapat menambahkan beberapa pasangan kunci-nilai sekaligus.

    Tag Aplikasi

    Untuk melihat atau memodifikasi tag aplikasi, masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Application Monitoring > Application List. Anda dapat menggunakan tag aplikasi untuk menanyakan aplikasi, mengelola izin aplikasi, dan membagi tagihan.

    Tag Instance

    Setiap aplikasi yang dipantau dalam Pemantauan Aplikasi dapat berisi beberapa instance aplikasi, dan setiap instance aplikasi mewakili sebuah proses. Instance aplikasi yang berbeda yang termasuk dalam aplikasi yang sama mungkin memiliki tag instance yang berbeda.

    Untuk instance aplikasi yang secara otomatis terhubung dari lingkungan Kubernetes ke Pemantauan Aplikasi, ARMS menambahkan tag berikut secara default.

    Kunci Tag

    Deskripsi

    workloadKind

    Jenis beban kerja tempat instance aplikasi tersebut termasuk. Contoh: Deployment.

    workloadName

    Nama beban kerja tempat instance aplikasi tersebut termasuk.

    clusterName

    Nama kluster Kubernetes tempat instance aplikasi tersebut termasuk.

    namespace

    Namespace kluster Kubernetes tempat instance aplikasi tersebut termasuk.

    version

    Tag gambar.

    Dapat ditimpa oleh tag instance kustom.

    agentVersion

    Versi ARMS agent.

    Selain tag instance default, Anda dapat menambahkan tag instance kustom. Pada saat yang sama, tag instance yang ditambahkan ke aplikasi sepenuhnya diwarisi dan ditampilkan dengan data pemantauan setiap instance aplikasi.

    Catatan

    Kami merekomendasikan agar kunci tag instance kustom sesuai dengan konvensi metrik dan label Prometheus. Kunci harus ditentukan berdasarkan ekspresi reguler ^[a-zA-Z_][a-zA-Z0-9_]*$. Untuk kunci yang tidak ditentukan berdasarkan ekspresi reguler, ARMS agent menggunakan garis bawah (_) untuk mengganti fragmen yang tidak sesuai. Sebagai contoh, 1key:1value diganti dengan _key:1value.

    Contoh:

    Sebagaimana ditunjukkan pada gambar berikut, aplikasi my-app berisi dua instance: Instance A dan Instance B. Metrik Instance B memiliki tag berikut: env: Dev, team: Observability, app: my-app, workloadKind: Deployment, workloadName: my-app, clusterName: ClusterA, namespace: nsA, dan gitVersion: 1.0.2.

    Tambahkan tag instance kustom

    Tambahkan tag instance kustom ke aplikasi yang diterapkan di lingkungan Kubernetes

    Metode 1 (direkomendasikan): Gunakan label pod untuk menambahkan tag instance kustom

    Untuk aplikasi yang diterapkan di lingkungan Kubernetes dan memiliki ARMS agent yang diinstal secara otomatis, Anda dapat menambahkan tag instance kustom dengan menggunakan label pod.

    Catatan

    Metode ini cocok untuk aplikasi yang diterapkan di Container Service for Kubernetes (ACK) atau lingkungan Kubernetes lainnya. Untuk informasi tentang cara menginstal ARMS agent secara otomatis untuk aplikasi yang diterapkan di ACK atau lingkungan Kubernetes lainnya, lihat Ikhtisar Pemantauan Aplikasi.

    Ambil contoh aplikasi yang diterapkan di kluster ACK:

    Masuk ke Konsol ACK. Di panel navigasi kiri halaman detail kluster, klik Deployments atau StatefulSets. Di halaman yang muncul, pilih namespace, temukan Deployment atau StatefulSet, lalu pilih More > View in YAML di kolom Tindakan. Dalam kotak dialog Edit YAML, tambahkan tag kustom dan klik Perbarui. Instance aplikasi akan dimulai ulang, dan tag instance baru akan ditambahkan.image.png

    Metode 2: Gunakan variabel lingkungan pod untuk menambahkan tag instance kustom

    Catatan

    Metode ini didukung di ARMS agents V4.0.0 atau yang lebih baru untuk Java, V1.5.0 atau yang lebih baru untuk Go, dan V1.3.0 atau yang lebih baru untuk Python.

    Untuk menambahkan tag instance kustom yang hanya dapat diperoleh setelah pod dibuat, seperti podName, Anda dapat menambahkan variabel lingkungan di skrip startup kontainer. Lakukan langkah-langkah berikut:

    1. Tambahkan variabel lingkungan bernama ARMS_HOST_TAGS ke kontainer. Atur nilainya menjadi tag instance. Format: key1:value1&key2:value2. Contoh: export ARMS_HOST_TAGS="gitVersion:1.0.2&ip:192.168.1.101".

    2. Setelah variabel lingkungan berlaku, mulai prosesnya.

    Tambahkan tag instance kustom ke aplikasi yang memiliki ARMS agent diinstal secara manual

    Java

    Metode 1: Tambahkan parameter baris perintah -D

    Tambahkan parameter baris perintah -D bernama -Darms.host.tags="${yourLabel}" ke parameter startup aplikasi.

    Ganti ${yourLabel} dengan tag instance yang ingin Anda tambahkan. Format: key1:value1&key2:value2. Contoh: -Darms.host.tags="gitVersion:1.0.2&ip:192.168.1.101".

    Metode 2: Modifikasi file konfigurasi

    ARMS agent V4.0.0 atau yang lebih baru

    1. Lihat Modifikasi ARMS Agents untuk Parameter Java dan Wilayah Pelaporan Data dan bikin file konfigurasi .properties di direktori mana saja. Di file konfigurasi, tambahkan bidang profiler.tags.customtags dan tentukan nilainya sebagai tag instance yang ingin Anda tambahkan. Pisahkan beberapa tag dalam format key1:value1&key2:value2. Contoh:

      #profiler.tags.customtags=key1:value1&key2:value2
profiler.tags.customtags=gitVersion:1.0.2&ip:192.168.1.101

    2. Tambahkan -Dotel.javaagent.configuration-file=${path/to/config/file} atau variabel lingkungan OTEL_JAVAAGENT_CONFIGURATION_FILE=${path/to/config/file} ke perintah startup aplikasi Java Anda.

      Catatan

      • Ganti ${path/to/config/file} dengan jalur lengkap file konfigurasi yang Anda buat di langkah sebelumnya. Contoh: -Dotel.javaagent.configuration-file=/home/admin/config/agent-config.properties atau OTEL_JAVAAGENT_CONFIGURATION_FILE=/home/admin/config/agent-config.properties.

      • Jika baik perintah startup maupun variabel lingkungan dikonfigurasi, perintah startup yang berlaku.

    3. Mulai ulang proses Java.

    ARMS agent lebih awal dari V4.0.0

    1. Lihat Modifikasi ARMS Agents untuk Parameter Java dan Wilayah Pelaporan Data dan modifikasi bidang profiler.tags.customtags di file konfigurasi arms-agent.config dari paket instalasi agent. Anda dapat menambahkan tag instance kustom dalam format key1:value1&key2:value2. Contoh:

      #profiler.tags.customtags=key1:value1&key2:value2
profiler.tags.customtags=gitVersion:1.0.2&ip:192.168.1.101

    2. Mulai ulang proses Java.

    Go

    Nyatakan variabel lingkungan dan mulai ulang proses aplikasi.

    #export ARMS_HOST_TAGS=key1:value1&key2:value2
export ARMS_HOST_TAGS="gitVersion:1.0.2&ip:192.168.1.101"

    Python

    Nyatakan variabel lingkungan dan mulai ulang proses aplikasi.

    #export ARMS_HOST_TAGS=key1:value1&key2:value2
export ARMS_HOST_TAGS="gitVersion:1.0.2&ip:192.168.1.101"

    Tambahkan tag ke aplikasi yang diterapkan di lingkungan Kubernetes menggunakan label pod

    Gunakan salah satu dari cara berikut untuk menambahkan tag:

    Penting

    Persyaratan versi untuk ack-onepilot:

    • V3.0.16 atau yang lebih baru untuk Java

    • V3.2.0 atau yang lebih baru untuk Go

    • V4.1.1 atau yang lebih baru untuk Python

    Gunakan awalan app.customAppKey.

    Label pod dengan awalan app.customAppKey. dianggap sebagai tag aplikasi, bukan tag instance.

    Dalam kode berikut, ARMS menambahkan tag aplikasi env: dev ke aplikasi.

      template:
    metadata:
      labels:
        app.customAppKey.env: dev
        app: mall-gateway
        armsPilotAutoEnable: 'on'
        aliyun.com/app-language: golang  # Tentukan aplikasi Go.
        armsPilotCreateAppName: mall-gateway

    Tambahkan variabel lingkungan ARMS_APP_LABELS

    Untuk menggunakan kembali label pod yang ada sebagai tag aplikasi, konfigurasikan ack-onepilot V4.1.2 atau yang lebih baru:

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

    2. Di halaman Clusters, temukan kluster yang ingin Anda kelola dan klik namanya. Di panel kiri, pilih Workloads > Deployments.

    3. Di halaman Deployments, klik komponen ack-onepilot. Umumnya, ia dinamai ack-onepilot-ack-onepilot di namespace ack-onepilot.

      image.png

    4. Di pojok kanan atas halaman yang muncul, klik Edit.

    5. Gulir ke bawah hingga Anda melihat bagian Environments. Klik Add, tambahkan variabel lingkungan ARMS_APP_LABELS, dan atur nilainya menjadi string yang dipisahkan koma. Setelah dikonfigurasi, semua kunci yang terdaftar di /spec/template/metadata/labels yang cocok dengan ARMS_APP_LABELS didaftarkan sebagai tag aplikasi.

      image

    6. Tunggu komponen ack-onepilot untuk memulai ulang dan melewati pemeriksaan kesehatan. Lalu, mulai ulang pod aplikasi Anda untuk menerapkan label.

      image.png

    Catatan

    • Di ARMS, aplikasi adalah kumpulan beberapa instance aplikasi. Ini dapat memiliki beberapa instance aplikasi, atau milik beberapa beban kerja atau kluster Kubernetes. Anda dapat menggunakan label pod untuk menambahkan tag aplikasi secara efisien dalam skenario DevOps. Namun, metode ini memiliki beberapa batasan.

    • Tag aplikasi yang ditambahkan menggunakan label pod tidak dapat dihapus atau dimodifikasi secara langsung. Untuk memodifikasi atau menghapus kunci tag yang ada, Anda harus memodifikasi file YAML dan kemudian menggunakan konsol ARMS atau Operasi API.

    • Jika beberapa beban kerja milik aplikasi yang sama, tag aplikasi yang ditambahkan menggunakan label pod mungkin bertentangan satu sama lain. Anda harus memastikan konsistensi tag aplikasi.

    Gunakan tag aplikasi

    Pertanyaan aplikasi

    Ketika Anda melihat daftar aplikasi atau membuat aturan peringatan di konsol ARMS, Anda dapat menggunakan tag aplikasi untuk menanyakan aplikasi.

    Manajemen izin berbasis tag

    Anda dapat mengelola izin RAM berdasarkan tag aplikasi. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.

    Gunakan tag instance

    Tanyakan data pemantauan di halaman detail aplikasi

    1. Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Application Monitoring > Application List.

    2. Di halaman Application List, pilih wilayah di bilah navigasi atas dan klik nama aplikasi yang ingin Anda kelola.

      3. Catatan

      Ikon yang ditampilkan di kolom Language menunjukkan bahasa aplikasi yang digunakan.

      Java图标: Aplikasi Java

      image: Aplikasi Go

      image: Aplikasi Python

      Tanda hubung (-): aplikasi yang dipantau di Managed Service for OpenTelemetry.

    3. Di berbagai modul halaman detail aplikasi, Anda dapat menggunakan tag instance untuk menanyakan data pemantauan. Misalnya, Anda dapat membandingkan dan menganalisis data pemantauan berdasarkan versi gambar.

    Tanyakan metrik di halaman tampilan Grafana

    1. Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Application Monitoring > Application List.

    2. Di halaman Application List, pilih wilayah di bilah navigasi atas dan klik nama aplikasi yang ingin Anda kelola.

      3. Catatan

      Ikon yang ditampilkan di kolom Language menunjukkan bahasa yang digunakan untuk menulis aplikasi.

      Java图标: Aplikasi Java

      image: Aplikasi Go

      image: Aplikasi Python

      Tanda hubung (-): aplikasi yang dipantau di Managed Service for OpenTelemetry.

    3. Di panel navigasi kiri, klik Grafana view. Di halaman yang muncul, konfigurasikan tag untuk melihat metrik.

      GrafanaView