Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine, sehingga Anda dapat menggunakan Google Cloud Managed Service for Prometheus untuk mengumpulkan metrik dari pengekspor Kibana. Dokumen ini menunjukkan cara melakukan hal berikut:
- Siapkan pengekspor Kibana untuk melaporkan metrik.
- Konfigurasi resource PodMonitoring untuk Google Cloud Managed Service for Prometheus guna mengumpulkan metrik yang diekspor.
- Akses dasbor di Cloud Monitoring untuk melihat metrik.
- Konfigurasi aturan pemberitahuan untuk memantau metrik.
Petunjuk ini hanya berlaku jika Anda menggunakan koleksi terkelola dengan Managed Service for Prometheus. Jika Anda menggunakan koleksi yang di-deploy sendiri, baca dokumentasi Kibana untuk mengetahui informasi penginstalan.
Petunjuk ini diberikan sebagai contoh dan diharapkan dapat berfungsi di sebagian besar lingkungan Kubernetes. Jika Anda mengalami masalah saat menginstal aplikasi atau pengekspor karena kebijakan organisasi atau keamanan yang ketat, sebaiknya baca dokumentasi open source untuk mendapatkan dukungan.Untuk informasi tentang Kibana, lihat Kibana.
Prasyarat
Untuk mengumpulkan metrik dari pengekspor Kibana menggunakan Managed Service for Prometheus dan koleksi terkelola, deployment Anda harus memenuhi persyaratan berikut:
- Cluster Anda harus menjalankan Google Kubernetes Engine versi 1.21.4-gke.300 atau yang lebih baru.
- Anda harus menjalankan Google Cloud Managed Service for Prometheus dengan mengaktifkan koleksi terkelola. Untuk informasi selengkapnya, lihat Mulai menggunakan koleksi terkelola.
- Agar dapat menggunakan dasbor yang tersedia di Cloud Monitoring untuk integrasi Kibana, Anda harus menggunakan
kibana-prometheus-exporter
versi 8.0.0 atau yang lebih baru.Untuk informasi selengkapnya tentang dasbor yang tersedia, lihat Melihat dasbor.
Proses penginstalan memerlukan penggunaan bin/kibana-plugin install PLUGIN
. Salah satu cara untuk menginstal plugin ini adalah dengan menentukan image Docker Kibana kustom; lihat contoh berikut:
FROM kibana:KIBANA_VERSION
RUN bin/kibana-plugin install https://github.com/pjhampton/kibana-prometheus-exporter/releases/download/PLUGIN_VERSION/kibanaPrometheusExporter-PLUGIN_VERSION.zip
Setelah membangun image dan mengirimkannya ke repositori jarak jauh, image tersebut dapat digunakan dalam deployment Kubernetes. Contoh:
apiVersion: v1
kind: ConfigMap
metadata:
name: kibana
data:
kibana.yml: |
server.name: kibana
server.host: "0.0.0.0"
# Update this with credentials to match your Elasticsearch instance
elasticsearch.hosts: http://username:password@elasticsearch-service-name:9200
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: kibana
labels:
app.kubernetes.io/name: kibana
spec:
...
template:
...
spec:
containers:
- name: kibana
image: CUSTOM_IMAGE
ports:
- containerPort: 5601
name: kibana
protocol: TCP
volumeMounts:
- mountPath: /usr/share/kibana/config/kibana.yml
subPath: kibana.yml
name: kibana
volumes:
- name: kibana
configMap:
name: kibana
items:
- key: kibana.yml
path: kibana.yml
Untuk memverifikasi bahwa pengekspor Kibana memunculkan metrik pada endpoint yang diharapkan, lakukan tindakan berikut:
Siapkan penerusan port dengan perintah berikut:
kubectl -n NAMESPACE_NAME port-forward POD_NAME 5601
Akses endpoint
localhost:5601/_prometheus/metrics
menggunakan browser atau utilitascurl
di sesi terminal lainnya.
Menentukan resource PodMonitoring
Untuk penemuan target, Layanan Terkelola untuk Operator Prometheus memerlukan resource PodMonitoring yang sesuai dengan pengekspor Kibana di namespace yang sama.
Anda dapat menggunakan konfigurasi PodMonitoring berikut:
Untuk menerapkan perubahan konfigurasi dari file lokal, jalankan perintah berikut:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
Anda juga dapat menggunakan Terraform untuk mengelola konfigurasi Anda.
Menentukan aturan dan pemberitahuan
Anda dapat menggunakan konfigurasi Rules
berikut untuk menentukan pemberitahuan pada metrik Kibana:
Untuk menerapkan perubahan konfigurasi dari file lokal, jalankan perintah berikut:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
Anda juga dapat menggunakan Terraform untuk mengelola konfigurasi Anda.
Untuk mengetahui informasi selengkapnya tentang cara menerapkan aturan ke cluster Anda, lihat Evaluasi dan pemberitahuan aturan terkelola.
Anda dapat menyesuaikan nilai minimum pemberitahuan agar sesuai dengan aplikasi Anda.Memverifikasi konfigurasi
Anda dapat menggunakan Metrics Explorer untuk memverifikasi bahwa Anda telah mengonfigurasi pengekspor Kibana dengan benar. Cloud Monitoring mungkin memerlukan waktu satu atau dua menit untuk menyerap metrik Anda.
Untuk memastikan metrik diserap, lakukan tindakan berikut:
-
Di panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih leaderboard Metrics Explorer:
- Di toolbar panel pembuat kueri, pilih tombol dengan nama code MQL atau code PromQL.
- Pastikan PromQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.
- Masukkan dan jalankan kueri berikut:
up{job="kibana", cluster="CLUSTER_NAME", namespace="NAMESPACE_NAME"}
Lihat dasbor
Integrasi Cloud Monitoring meliputi dasbor Kibana Prometheus Overview. Dasbor diinstal secara otomatis saat Anda mengonfigurasi integrasi. Anda juga dapat melihat pratinjau statis dasbor tanpa menginstal integrasi.
Untuk melihat dasbor yang terinstal, lakukan hal berikut:
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih
Dashboards:
- Pilih tab Daftar Dasbor.
- Pilih kategori Integrations.
- Klik nama dasbor, misalnya, Ringkasan Kibana Prometheus.
Untuk melihat pratinjau statis dasbor, lakukan hal berikut:
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih
Integrations:
- Klik filter platform deployment Kubernetes Engine.
- Temukan integrasi Kibana, lalu klik View Details.
- Pilih tab Dasbor.
Pemecahan masalah
Untuk mengetahui informasi tentang cara memecahkan masalah penyerapan metrik, lihat Masalah terkait pengumpulan dari pengekspor dalam Memecahkan masalah sisi penyerapan.