All Products
Search

This Product

    Container Service for Kubernetes:Aktifkan pelacakan untuk pengontrol NGINX Ingress

    Document Center

    Container Service for Kubernetes:Aktifkan pelacakan untuk pengontrol NGINX Ingress

    Last Updated:Jun 21, 2026

    Container Service for Kubernetes (ACK) memungkinkan Anda mengaktifkan pelacakan untuk pengontrol NGINX Ingress dan mengirim data jejak ke Managed Service for OpenTelemetry. Managed Service for OpenTelemetry mengumpulkan, memproses, dan menyimpan data jejak ini secara real time, serta menghasilkan data pemantauan seperti jejak terperinci dan peta topologi real time untuk troubleshooting dan mendiagnosis masalah pada pengontrol NGINX Ingress.

    Penting

    Proyek open source Ingress-NGINX tidak akan lagi dipelihara setelah Maret 2026. Akibatnya, Container Service for Kubernetes juga akan menghentikan pemeliharaan untuk pengontrol NGINX Ingress. Pahami risikonya sebelum melanjutkan. Untuk detail selengkapnya, lihat pengumuman produk tentang penghentian pemeliharaan komponen pengontrol NGINX Ingress.

    Prasyarat

    Kompatibilitas versi

    Dukungan pelacakan bervariasi di berbagai versi komponen pengontrol NGINX Ingress, sehingga Anda perlu memilih metode konfigurasi yang sesuai dengan versi Anda.

    Versi pengontrol NGINX Ingress

    OpenTelemetry

    OpenTracing

    ≥ v1.10.2-aliyun.1

    Didukung

    Tidak didukung

    v1.9.3-aliyun.1

    Didukung

    Didukung

    v1.8.2-aliyun.1

    Didukung

    Didukung

    < v1.8.2-aliyun.1

    Tidak didukung

    Didukung

    Prosedur

    Pilih prosedur yang sesuai dengan versi pengontrol NGINX Ingress Anda.

    OpenTelemetry

    Langkah 1: Dapatkan titik akhirManaged Service for OpenTelemetry

    Konsol baru

    1. Masuk ke atau Konsol Managed Service for OpenTelemetry. Di panel navigasi sebelah kiri, klik Integration Center.

    2. Di bagian Open Source Frameworks, klik kartu OpenTelemetry.

    3. Di panel OpenTelemetry yang muncul, pilih wilayah tempat Anda ingin melaporkan data.

    4. Catat titik akhir untuk metode pelaporan gRPC.ot-新版-中文.jpg

      Catatan

      Gunakan titik akhir VPC jika pengontrol NGINX Ingress diterapkan di wilayah Alibaba Cloud yang sama dengan integrasi Managed Service for OpenTelemetry Anda. Jika tidak, gunakan titik akhir publik.

    Konsol lama

    1. Login ke Konsol Managed Service for OpenTelemetry.

    2. Di panel navigasi kiri, klik Cluster Configurations. Di halaman yang muncul, klik tab Access Point Information.

    3. Di bagian atas halaman, pilih wilayah yang ingin Anda hubungkan.

    4. Di bagian Cluster Information, aktifkan sakelar Show Token. Di bagian Client, klik OpenTelemetry, lalu catat titik akhir untuk metode pelaporan gRPC.

      ot-旧版-中文.jpg

      Catatan

      Gunakan titik akhir VPC jika pengontrol NGINX Ingress diterapkan di wilayah Alibaba Cloud yang sama dengan integrasi Managed Service for OpenTelemetry Anda. Jika tidak, gunakan titik akhir publik.

    Langkah 2: Konfigurasikan pengontrol NGINX IngressManaged Service for OpenTelemetry

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

    3. Di halaman Deployments, atur Namespace ke kube-system. Cari nginx-ingress-controller, lalu klik Edit.

    4. Di bagian atas halaman Edit, pilih kontainer nginx-ingress-controller. Di tab Environment Variable, klik Add untuk menetapkan variabel lingkungan berikut.

      Jenis

      Kunci variabel

      Nilai/sumber nilai

      Deskripsi

      Kustom

      OTEL_EXPORTER_OTLP_HEADERS

      authentication=<authentication token>

      Gunakan token otentikasi yang Anda peroleh di Langkah 1: Dapatkan titik akhir. Contoh: authentication=bfXXXXXXXe@7bXXXXXXX1_bXXXXXe@XXXXXXX1.

      image

      Setelah menambahkan variabel, klik Edit di panel kanan halaman Update. Di kotak dialog yang muncul, klik OK.

    5. Di panel navigasi kiri, pilih Configurations > ConfigMaps.

    6. Di halaman Configurations, atur Namespace ke kube-system. Cari nginx-configuration, lalu klik Actions di kolom Edit untuk ConfigMap nginx-configuration.

    7. Di panel Edit, klik Add, tambahkan konfigurasi berikut, lalu klik OK.

      Parameter

      Deskripsi

      Nilai

      Contoh

      enable-opentelemetry

      Mengaktifkan pelacakan OpenTelemetry.

      • true: mengaktifkan pelacakan.

      • false: menonaktifkan pelacakan.

      true

      main-snippet

      -

      env OTEL_EXPORTER_OTLP_HEADERS;

      env OTEL_EXPORTER_OTLP_HEADERS;

      otel-service-name

      Nama layanan.

      Kustom.

      nginx-ingress

      otlp-collector-host

      Nama domain titik akhir pelaporan gRPC.

      Gunakan titik akhir VPC yang Anda peroleh di Langkah 1: Dapatkan titik akhir. Hapus awalan http:// dan nomor port. Contoh: tracing-analysis-XX-XX-XXXXX.aliyuncs.com.

      tracing-analysis-XX-XX-XXXXX.aliyuncs.com

      otlp-collector-port

      Port titik akhir pelaporan gRPC.

      Masukkan nilai aktual.

      8090

      opentelemetry-trust-incoming-span

      Menentukan apakah akan mempercayai jejak masuk dari layanan lain.

      • true: kepercayaan diaktifkan.

      • false: kepercayaan dinonaktifkan.

      true

      opentelemetry-operation-name

      Format rentang jejak.

      HTTP $request_method $service_name $uri

      HTTP $request_method $service_name $uri

      otel-sampler

      Strategi pengambilan sampel.

      Untuk informasi lebih lanjut tentang parameter, lihat opentelemetry.

      TraceIdRatioBased

      otel-sampler-ratio

      Laju pengambilan sampel.

      Nilainya harus antara 0 dan 1, dengan maksimal dua tempat desimal. Nilai 0 berarti tidak ada permintaan yang diambil sampelnya, dan 1 berarti semua permintaan diambil sampelnya.

      Untuk informasi lebih lanjut tentang parameter, lihat opentelemetry.

      0,1

      otel-sampler-parent-based

      Menentukan apakah akan mewarisi keputusan pengambilan sampel dari layanan hulu.

      • false (Default): Tidak mewarisi keputusan pengambilan sampel hulu. Pengambilan sampel didasarkan pada parameter otel-sampler dan otel-sampler-ratio.

      • true: Mewarisi keputusan pengambilan sampel hulu. Parameter otel-sampler dan otel-sampler-ratio diabaikan.

      Untuk informasi lebih lanjut tentang parameter, lihat opentelemetry.

      false

    Langkah 3: Lihat data jejakManaged Service for OpenTelemetry

    1. Login ke Konsol Managed Service for OpenTelemetry.

    2. Di panel navigasi kiri, klik Applications.

    3. Di bagian atas halaman Applications, pilih wilayah, lalu klik nama aplikasi nginx-ingress.

      • Di tab Application Overview, lihat metrik seperti jumlah permintaan dan jumlah error.应用概览-中.jpg

      • Di tab Trace Analysis, lihat informasi seperti daftar jejak dan durasi rata-rata.调用链分析-中.jpg

      • Di tab Trace Analysis, klik ID Jejak untuk melihat detail jejak.trace详情-中.jpg

    OpenTracing

    Langkah 1: Dapatkan titik akhirManaged Service for OpenTelemetry

    Konsol baru

    1. Login ke Konsol Managed Service for OpenTelemetry. Di panel navigasi kiri, klik Integration Center.

    2. Di bagian Open Source Frameworks, klik kartu Zipkin.

      Catatan

      Titik akhir yang Anda peroleh bergantung pada klien yang digunakan. Topik ini menggunakan Zipkin sebagai contoh.

    3. Di panel Zipkin yang muncul, pilih wilayah tempat Anda ingin melaporkan data.

    4. Catat informasi titik akhir.zipkin-新版-中.jpg

      Catatan

      Gunakan titik akhir VPC jika pengontrol NGINX Ingress diterapkan di wilayah Alibaba Cloud yang sama dengan integrasi Managed Service for OpenTelemetry Anda. Jika tidak, gunakan titik akhir publik.

    Konsol lama

    1. Login ke Konsol Managed Service for OpenTelemetry.

    2. Di panel navigasi kiri, klik Cluster Configurations. Di halaman yang muncul, klik tab Access Point Information.

    3. Di bagian atas halaman, pilih wilayah yang ingin Anda hubungkan.

    4. Di bagian Cluster Information, aktifkan sakelar Show Token. Di bagian Client, klik Zipkin, lalu catat informasi titik akhir.

      zipkin-旧版-中文.jpg

      Catatan

      Gunakan titik akhir VPC jika pengontrol NGINX Ingress diterapkan di wilayah Alibaba Cloud yang sama dengan integrasi Managed Service for OpenTelemetry Anda. Jika tidak, gunakan titik akhir publik.

    Langkah 2: Konfigurasikan pengontrol NGINX IngressManaged Service for OpenTelemetry

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

    2. Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Configurations > ConfigMaps.

    3. Di halaman Configurations, atur Namespace ke kube-system. Cari nginx-configuration, lalu klik Actions di kolom Edit untuk ConfigMap nginx-configuration.

    4. Di panel Edit, klik Add, tambahkan konfigurasi berikut, lalu klik OK.

      Parameter

      Deskripsi

      Nilai

      Contoh

      enable-opentracing

      Menentukan apakah akan mengaktifkan pelacakan.

      • true: mengaktifkan pelacakan.

      • false: menonaktifkan pelacakan.

      true

      zipkin-service-name

      Nama layanan.

      Kustom.

      nginx-ingress

      zipkin-collector-host

      Nama domain titik akhir pelaporan.

      Ubah titik akhir yang Anda peroleh di Langkah 1: Dapatkan titik akhir. Hapus awalan http:// dan tambahkan tanda tanya ? di akhir. Contohnya:

      • Titik akhir asli: http://tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans

      • Nilai yang dimodifikasi: tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans?

      tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans?

      opentracing-trust-incoming-span

      Menentukan apakah akan mempercayai jejak dari layanan atau sistem lain.

      • true: kepercayaan diaktifkan.

      • false: kepercayaan dinonaktifkan.

      true

      zipkin-sample-rate

      Laju pengambilan sampel.

      Nilainya harus antara 0 dan 1, dengan maksimal dua tempat desimal. Nilai 0 berarti tidak ada permintaan yang diambil sampelnya, dan 1 berarti semua permintaan diambil sampelnya.

      0,1

    Langkah 3: Lihat data jejakManaged Service for OpenTelemetry

    1. Login ke Konsol Managed Service for OpenTelemetry.

    2. Di panel navigasi kiri, klik Applications.

    3. Di bagian atas halaman Applications, pilih wilayah, lalu klik nama aplikasi nginx.

    4. Di panel navigasi kiri halaman detail aplikasi, klik API Call. Di area kanan, lihat informasi jejak.

      • Tab Overview menampilkan topologi jejak.3.jpg

      • Klik tab Traces untuk melihat hingga 100 jejak dengan durasi terpanjang untuk aplikasi tersebut. Untuk informasi lebih lanjut tentang data jejak, lihat Interface Calls.调用链路

      • Di tab Traces, klik ID Jejak untuk melihat detail jejak.2.jpg

    Ubah protokol propagasi jejak (Opsional)

    Saat Anda menggunakan OpenTelemetry untuk pelacakan pengontrol NGINX Ingress, OpenTelemetry secara default mengenali dan mempropagasikan konteks jejak ke downstream dalam format W3C Trace Context. Jika aplikasi frontend dan backend Anda menggunakan protokol lain, seperti Jaeger atau Zipkin, Anda perlu mengubah protokol propagasi jejak OpenTelemetry agar dapat menghubungkan jejak dari aplikasi frontend, pengontrol NGINX Ingress, dan aplikasi backend. Topik ini menjelaskan cara mengubah protokol propagasi jejak OpenTelemetry yang digunakan oleh pengontrol NGINX Ingress.

    1. Selain konfigurasi di Langkah 2, sublangkah 4, tambahkan variabel lingkungan OTEL_PROPAGATORS. Simpan perubahan dan redeploy nginx-ingress-controller.

      Kunci variabel

      Nilai

      Deskripsi

      OTEL_PROPAGATORS

      tracecontext,baggage,b3,jaeger

      Format propagasi. Untuk informasi lebih lanjut, lihat Tentukan format header propagasi untuk OpenTelemetry.

    2. Selain konfigurasi di Langkah 2, sublangkah 7, ubah konfigurasi main-snippet untuk menerapkan variabel lingkungan OTEL_PROPAGATORS.

      Parameter

      Nilai

      Deskripsi

      main-snippet

      env OTEL_EXPORTER_OTLP_HEADERS; env OTEL_PROPAGATORS;

      Memuat variabel lingkungan.

    Referensi