Halaman ini menjelaskan cara mengirim metrik dari Config Sync ke pengekspor OpenTelemetry kustom.
Config Sync menggunakan OpenCensus untuk membuat dan merekam metrik, sedangkan OpenTelemetry untuk mengekspor metriknya. Halaman ini menjelaskan cara mengonfigurasi metrik tersebut ke pengekspor kustom. Untuk mengetahui cara lain mengekspor metrik, baca artikel 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 Pengekspor Kolektor OpenTelemetry dan Pengekspor OpenTelemetry Collector-Contrib.
Resource pemantauan OpenTelemetry dikelola dalam namespace config-management-monitoring
terpisah. Untuk mengonfigurasi pengekspor OpenTelemetry kustom yang akan 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 konten 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 pipeline
metrics
. Kolom lainnya bersifat opsional dan dapat dikonfigurasi, tetapi sebaiknya Anda menyertakan pemroses batch
dan ekstensi health check seperti dalam contoh.
Setelah Anda 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 Anda 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. Misalnya, nama, label, dan atribut metrik dapat berubah di antara
versi Config Sync.
Saat dibuat pada metrik Config Sync, perubahan tersebut diumumkan di 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.