Mengirim metrik Config Sync ke sistem pemantauan kustom

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

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

Mengonfigurasi pengekspor OpenTelemetry kustom

Jika ingin mengirim metrik ke sistem pemantauan selain Prometheus atau Cloud Monitoring, Anda dapat mengubah konfigurasi OpenTelemetry. Untuk daftar sistem pemantauan yang didukung, lihat OpenTelemetry Collector Exporters dan OpenTelemetry Collector-Contrib Exporters.

Resource pemantauan OpenTelemetry dikelola di namespace config-management-monitoring terpisah. Untuk mengonfigurasi eksportir OpenTelemetry kustom agar dapat digunakan dengan Config Sync, Anda perlu membuat ConfigMap dengan nama otel-collector-custom di namespace config-management-monitoring tersebut. ConfigMap harus berisi kunci otel-collector-config.yaml dan nilainya harus berupa konten file konfigurasi OpenTelemetry Collector kustom. Untuk informasi selengkapnya tentang opsi konfigurasi, lihat dokumentasi konfigurasi OpenTelemetry Collector.

ConfigMap berikut adalah contoh ConfigMap dengan eksportir 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 pipeline metrics. Kolom lainnya bersifat opsional dan dapat dikonfigurasi, tetapi sebaiknya Anda menyertakan ekstensi health check dan prosesor batch seperti dalam contoh.

Setelah membuat ConfigMap, gunakan kubectl untuk membuat resource:

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

Deployment OpenTelemetry Collector mengambil ConfigMap ini dan otomatis memulai ulang untuk menerapkan konfigurasi kustom.

Batasan

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

Jika perubahan dilakukan pada metrik Config Sync, perubahan tersebut akan diumumkan dalam catatan rilis. Perubahan ini mungkin mengharuskan Anda memperbarui konfigurasi otel-collector kustom.

Karena batasan ini, sebaiknya Anda hanya menggunakan konfigurasi metrik kustom untuk solusi sementara. Jika Anda merasa perlu menggunakan konfigurasi kustom, ajukan tiket dukungan untuk meminta solusi sebagai fitur atau perbaikan bug.