Mengirim metrik Config Sync ke sistem pemantauan kustom

Halaman ini menjelaskan cara mengirim metrik dari Config Sync ke kustom Pengekspor OpenTelemetry.

Perhatian: Solusi ini diberikan untuk kemudahan dan tidak dikelola oleh Sinkronisasi Konfigurasi. Konfigurasi kustom menggantikan setelan default dan tetap bertahan di antara upgrade. Config Sync mencoba mempertahankan konsistensi metrik.

Config Sync menggunakan OpenCensus untuk membuat dan mencatat metrik dan OpenTelemetry untuk mengekspor metriknya. Halaman ini menjelaskan cara mengonfigurasi metrik tersebut ke pengekspor kustom. Untuk cara lain untuk mengekspor metrik, lihat Memantau Config Sync dengan Cloud Monitoring atau Pantau Config Sync dengan Prometheus.

Mengonfigurasi pengekspor OpenTelemetry kustom

Jika Anda ingin mengirim metrik Anda ke sistem pemantauan selain Prometheus atau di Cloud Monitoring, Anda dapat memodifikasi konfigurasi OpenTelemetry. Untuk daftar dari sistem pemantauan yang didukung, lihat Pengekspor Kolektor OpenTelemetry dan Pengekspor-Contrib Collector OpenTelemetry.

Resource pemantauan OpenTelemetry dikelola dalam Namespace config-management-monitoring. Untuk mengonfigurasi OpenTelemetry kustom untuk digunakan dengan Config Sync, Anda perlu membuat ConfigMap dengan nama otel-collector-custom dalam namespace config-management-monitoring tersebut. ConfigMap harus berisi kunci otel-collector-config.yaml dan nilainya harus berupa isi file konfigurasi OpenTelemetry Collector kustom. Untuk informasi selengkapnya tentang opsi konfigurasi, lihat Dokumentasi konfigurasi OpenTelemetry Collector.

ConfigMap berikut adalah contoh ConfigMap dengan pengekspor logging kustom:

# otel-collector-custom-cm.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: otel-collector-custom
  namespace: config-management-monitoring
  labels:
    app: opentelemetry
    component: otel-collector
data:
  otel-collector-config.yaml: |
    receivers:
      opencensus:
    exporters:
      logging:
        logLevel: debug
    processors:
      batch:
    extensions:
      health_check:
    service:
      extensions: [health_check]
      pipelines:
        metrics:
          receivers: [opencensus]
          processors: [batch]
          exporters: [logging]

Semua konfigurasi kustom harus menentukan penerima opencensus dan metrics {i>pipelines<i} yang sama. Kolom lainnya bersifat opsional dan dapat dikonfigurasi, tetapi sebaiknya bahwa Anda menyertakan prosesor batch dan ekstensi health check seperti di contoh.

Setelah Anda membuat ConfigMap, gunakan kubectl untuk membuat resource:

kubectl apply -f otel-collector-custom-cm.yaml

OpenTelemetry Collector Deployment mengambil ConfigMap ini dan secara otomatis akan dimulai ulang untuk menerapkan konfigurasi kustom.

Batasan

Saat mengupgrade Config Sync ke versi baru, jika Anda membuat otel-collector-custom ConfigMap untuk versi sebelumnya, setelan kustom Anda mungkin tidak kompatibel dengan Config Sync versi baru. Sebagai misalnya, nama metrik, label, dan atribut dapat berubah antara Versi Config Sync.

Saat perubahan dilakukan pada metrik Config Sync, perubahan tersebut akan diumumkan di catatan rilis. Perubahan ini mungkin mengharuskan Anda untuk mengupdate konfigurasi otel-collector kustom Anda.

Karena keterbatasan ini, sebaiknya Anda hanya menggunakan metrik kustom untuk solusi sementara. Jika Anda merasa perlu menggunakan konfigurasi, ajukan tiket dukungan untuk meminta solusi fitur atau perbaikan {i>bug<i}.