Container Service for Kubernetes：Aktifkan Analisis Tracing untuk Komponen Data Plane

Jika Anda belum terbiasa dengan tracing, lihat Konsep Dasar untuk memahami konsep dasar yang relevan.

Prasyarat

• Anda memiliki klaster ACK dikelola atau klaster ACK khusus yang menjalankan Kubernetes 1.28 atau lebih baru. Untuk informasi tentang cara meningkatkan klaster, lihat Tingkatkan Klaster ACK secara Manual.

• Versi Helm adalah V3. Untuk panduan memperbarui Helm, lihat Perbarui Helm V2 ke Helm V3.

  Saat menginstal OpenTelemetry Collector, versi Helm harus 3.9 atau lebih baru.

• Managed Service for OpenTelemetry telah diaktifkan dan diberi otorisasi. Untuk informasi lebih lanjut, lihat Persiapan.

  Managed Service for OpenTelemetry menyediakan alat untuk aplikasi terdistribusi seperti restorasi jejak lengkap, statistik volume permintaan, topologi jejak, dan analisis ketergantungan aplikasi.

Berikut adalah langkah-langkah untuk mengaktifkan Analisis Tracing untuk data plane klaster:

1. Dapatkan titik akhir dan token otentikasi Managed Service for OpenTelemetry, lalu simpan token otentikasi dalam Secret klaster agar OpenTelemetry Collector dapat membaca konfigurasi dan informasi otentikasi.

2. Deploy OpenTelemetry Collector untuk mengumpulkan, memproses, dan mengekspor data observabilitas.

   Marketplace Container Service for Kubernetes (ACK) memungkinkan Anda menerapkan OpenTelemetry Collector dalam mode DaemonSet di klaster.

3. Gunakan kubelet untuk mengaktifkan Analisis Tracing dan konfigurasikan parameter terkait (laju pengambilan sampel). Data yang dikumpulkan kemudian diteruskan ke Managed Service for OpenTelemetry menggunakan OpenTelemetry Collector.

Langkah 1: Dapatkan titik akhir dan token otentikasi

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

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

3. Pilih wilayah pelaporan data, atur Connection Type ke Alibaba Cloud VPC Network, dan Export Protocol ke gRPC. Simpan informasi titik akhir untuk digunakan selanjutnya.

   Sumber daya diinisialisasi secara otomatis di wilayah yang Anda akses pertama kali. Ikuti instruksi di halaman tersebut untuk melanjutkan.

   

Langkah 2: Simpan token otentikasi di Secret klaster

Simpan token otentikasi di Secret dalam klaster ACK Anda dan referensikan melalui variabel lingkungan di OpenTelemetry Collector. Secret harus berada di namespace yang sama dengan OpenTelemetry Collector yang akan diterapkan di langkah 3.

Secara default, OpenTelemetry Collector diterapkan di namespace otel-collector. Anda dapat membuat namespace bernama otel-collector secara manual atau menggunakan namespace lain saat menginstal OpenTelemetry Collector.

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

2. Di halaman Clusters, klik nama klaster yang ingin Anda ubah. Di panel kiri, pilih Configurations > Secrets.

3. Klik Create, lalu atur parameter sesuai petunjuk untuk membuat Secret. Tabel berikut menjelaskan parameter tersebut.

   Parameter	Nilai valid	Contoh
   Name	opentelemetry-exporter-config Penting Gunakan nilai ini daripada nama kustom.
   Type	Opaque
   Parameter dalam kotak dialog Tambah Secret:
   Name (Key)	grpc-token Penting Gunakan nilai ini daripada nama kustom.
   Value	Token otentikasi yang diperoleh di Langkah 1.
   Encode Data Values Using Base64	Aktifkan

Langkah 3: Instal OpenTelemetry Collector

OpenTelemetry Collector adalah kolektor data observabilitas yang menyediakan kemampuan penerimaan, pemrosesan, dan ekspor data seragam. OpenTelemetry Collector dapat digunakan untuk terhubung ke berbagai jenis data observabilitas sumber terbuka, seperti Jaeger, Prometheus, dan Fluent Bit. Ini menghindari kebutuhan untuk menerapkan beberapa kolektor observabilitas.

1. Masuk ke Konsol ACK. Di panel navigasi kiri, pilih Marketplace > Marketplace.

2. Cari opentelemetry-collector dan klik kartunya.

   Halaman ini berisi pengenalan komponen dan deskripsi parameter. Anda dapat membaca halaman ini atau menyelesaikan konfigurasi yang diperlukan sesuai panduan berikut.

3. Di pojok kanan atas halaman, klik Deploy. Di kotak dialog yang muncul, pilih klaster dan namespace. Ikuti instruksi di halaman untuk melanjutkan ke langkah berikutnya.

   Namespace komponen harus sama dengan Secret yang dibuat di Langkah 2.

4. Pilih versi bagan. Kami sarankan menggunakan versi default. Konfigurasikan parameter dan instal bagan sesuai petunjuk.

   Parameter	Deskripsi	Contoh
   mode	Atur parameter ini ke daemonset untuk menerapkan OpenTelemetry Collector dalam mode DaemonSet. mode: "daemonset"
   enableXtraceTokenFromSecret	Atur parameter ini ke true untuk mereferensikan token otentikasi melalui variabel lingkungan. Setelah diaktifkan, token tidak akan disimpan sebagai teks biasa di Secret OpenTelemetry Collector, mencegah kebocoran informasi sensitif. enableXtraceTokenFromSecret: true Pastikan Anda telah menyelesaikan operasi di Langkah 2 untuk menghindari kegagalan dalam penyebaran bagan.
   exporters	Tambahkan pengeskpor data bernama otlp untuk menentukan URL ke mana data tracing dilaporkan. Ganti endpoint dengan titik akhir yang Anda peroleh di Langkah 1. exporters: otlp: endpoint: <Titik akhir internal yang Anda peroleh> tls: insecure: true headers: Authentication: ${env:OPENTELEMETRY_GRPC_TOKEN}
   receivers	Tambahkan penerima bernama otlp/kubelet untuk mendengarkan di port 4317 dan menerima data kubelet menggunakan OTLP atau gRPC. receivers: otlp/kubelet: # Buat penerima bernama otlp/kubelet. protocols: grpc: endpoint: 127.0.0.1:4317
   service.pipelines.traces	Konfigurasikan pipeline pemrosesan OpenTelemetry Collector, tambahkan eksportir otlp ke service.pipelines.traces.exporters, dan tambahkan penerima otlp/kubelet ke service.pipelines.traces.receivers. traces: exporters: - debug - otlp processors: - memory_limiter - batch - resource receivers: - otlp - jaeger - zipkin - otlp/kubelet
   hostNetwork	Atur parameter ini ke true. OpenTelemetry Collector dapat menggunakan alamat IP dan port host untuk komunikasi. hostNetwork: true

   Setelah instalasi, halaman secara otomatis dialihkan ke halaman Helm.

   Di panel navigasi kiri, pilih Workloads > DaemonSets. Di halaman DaemonSets, pilih namespace komponen. Jika ada DaemonSet bernama opentelemetry-collector-agent dan status semua pod adalah Running, OpenTelemetry Collector berhasil diinstal.

Langkah 4: Aktifkan Analisis Tracing untuk kubelet

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

2. Di halaman Clusters, temukan klaster yang ingin dikelola dan klik namanya. Di panel navigasi kiri, pilih Nodes > Node Pools.

3. Di halaman Node Pools, temukan node pool target dan pilih > Kubelet Configuration di kolom Actions. Ikuti instruksi untuk menambahkan parameter kustom, baca pertimbangan penting, pilih node yang ingin diperbarui, konfigurasikan Batch Update Policy (Maximum Number of Nodes to Repair per Batch), dan klik submit.

   • Di bagian Custom Parameters, klik + Custom Parameters. Pilih tracing dari daftar drop-down parameter Name, dan pilih endpoint. Atur parameter Value ke localhost:4317, yang menunjukkan bahwa data tracing kubelet dikirim ke localhost:4317. Alamat ini sesuai dengan titik akhir penerima otlp/kubelet di Langkah 3.

   • Klik + Custom Parameters, pilih tracing dari daftar drop-down parameter Name, dan pilih samplingRatePerMillion. Laju pengambilan sampel menentukan persentase permintaan yang diambil sampelnya per sejuta permintaan. Tergantung pada konfigurasi keseluruhan Anda, Analisis Tracing dapat berdampak pada jaringan klaster dan performa CPU. Jika terjadi masalah performa, Anda dapat mengurangi laju pengambilan sampel sesuai beban klaster.

     Sebagai contoh, 1000000 mewakili laju pengambilan sampel 100%, yaitu untuk setiap sejuta permintaan, semua permintaan diambil sampel dan dicatat. 100000 mewakili laju pengambilan sampel 10%. 10000 mewakili laju pengambilan sampel 1%.

     

Langkah 5: Lihat data tracing di konsol Managed Service for OpenTelemetry

1. Masuk ke Konsol Managed Service for OpenTelemetry. Di panel navigasi kiri, klik Applications.

2. Di bagian atas halaman, pilih wilayah, klik nama aplikasi kubelet, dan ikuti instruksi di konsol untuk melihat informasi jejak.

   Berikut adalah deskripsi tab utama. Untuk informasi lebih lanjut tentang tab, lihat Detail Aplikasi.

   • Trace Explorer: Menampilkan jejak dan topologi aplikasi dari permintaan kubelet.

     • Di pojok kiri atas halaman, masukkan resources.k8s.cluster.name : "ClusterId" di kotak pencarian untuk memfilter jejak klaster tertentu.

       Anda dapat memperoleh ID klaster di daftar klaster.

     • Klik ID jejak di daftar jejak untuk melihat detail jejak permintaan kubelet, termasuk tampilan topologi, jumlah layanan yang terlibat, dan jumlah antarmuka yang dipanggil.

   • Provided Services: Menampilkan jumlah permintaan, jumlah kesalahan, serta durasi rata-rata antarmuka yang disediakan oleh kubelet.

   • Dependencies: Permintaan ke layanan dependen kubelet, seperti jumlah permintaan untuk containerd, jumlah kesalahan, dan durasi rata-rata.

Referensi

Untuk memantau dan mencatat data tracing API server klaster, lihat Aktifkan Analisis Tracing untuk Komponen Control Plane Klaster.