Cluster Troubleshooting
2 min read
Kubernetes Cluster : Troubleshooting #
Paket Kubernetes Cluster merupakan produk yang sangat kompleks, karena terdiri dari banyak langkah yang perlu dijalankan untuk menyelesaikan proses instalasi. Setiap langkah tersebut berpotensi gagal karena berbagai alasan, dan penting untuk menganalisis penyebabnya agar masalah serupa tidak terjadi di masa depan.
Berikut ini adalah langkah-langkah utama untuk melakukan troubleshooting di berbagai tahap proses serta jenis log yang perlu diperiksa:
- K8s Installation
- Events Tracking
- Pod Logs
K8s Installation #
Proses instalasi cluster Kubernetes memang cukup kompleks, namun sudah sepenuhnya otomatis dan dilengkapi dengan mekanisme penanganan error. Platform secara otomatis akan menangani sebagian besar masalah umum dan menampilkan penyebab utamanya langsung di dashboard.
Untuk masalah yang lebih kompleks, Kamu bisa menggunakan fitur Send Report melalui widget yang tersedia, agar tim support bisa membantu menganalisis dan menyelesaikannya.

Laporan tersebut akan mencakup log instalasi, pesan kesalahan, dan semua informasi debug lain yang dibutuhkan untuk analisis.
Selain itu, paket Kubernetes secara otomatis akan memverifikasi semua komponen cluster setelah instalasi selesai. Detailnya bisa kamu lihat di file /var/log/k8s-health-check.log yang ada di node master. Ada skrip utilitas khusus yang akan memeriksa status kesehatan dari komponen-komponen berikut :
- Weave CNI Plugin
- Ingress Controller
- Metrics Server
- Kubernetes Dashboard
- Node Problem Detector
- Monitoring Tools
- Remote API
- NFS Storage
- Sample App
Jika pemeriksaan kesehatan tidak berhasil memastikan bahwa suatu komponen berjalan (running), maka peringatan akan ditampilkan di jendela keberhasilan instalasi. Namun, peringatan ini tidak selalu berarti ada gangguan di cluster—misalnya, beberapa deployment mungkin masih dalam proses.
Kamu bisa menjalankan perintah kubectl get pods –all-namespaces untuk memeriksa status semua pod. Jika semuanya berstatus Running, berarti cluster kamu dalam kondisi baik. Kalau tidak, hubungi tim support Jagoan Cloud dan sertakan log terkait Kubernetes dari direktori /var/log.
Events Tracking #
Kamu dapat menggunakan kubectl atau Kubernetes Dashboard untuk melacak dan menganalisis event (kejadian) baik untuk satu namespace tertentu maupun untuk semua namespace sekaligus (dengan syarat Kamu memiliki izin yang cukup):
- Event di Kubernetes Dashboard

- Contoh output dari perintah kubectl get events -n $namespace

Pod Logs #
Setelah pod dijadwalkan untuk dijalankan pada node yang tersedia, Kamu bisa mengikuti log yang sesuai melalui :
- Kubernetes Dashboard – buka halaman pod lalu klik tombol Logs di pojok kanan atas
- kubectl – gunakan perintah untuk mengelola pod
Contohnya, log ini bisa membantu menemukan penyebab utama dari event “Back-off restart failed container” pada pod kamu.
Powered by BetterDocs
