Prometheus di docker aapanel tidak jalan muncul Abnormal dan di log unknow log flag '--storage.tsb.retention'
? Apa Itu Prometheus?
Prometheus adalah sistem monitoring dan time-series database (TSDB) yang digunakan untuk mengumpulkan, menyimpan, dan menganalisis data metrik dari sistem, aplikasi, atau infrastruktur IT. Prometheus sering digunakan dalam ekosistem cloud-native dan sangat populer di komunitas DevOps.
?️ Fungsi Utama Prometheus
-
? Mengumpulkan Data Metrik Secara Berkala (Scraping)
- Prometheus menarik (scrape) data metrik dari target endpoint menggunakan HTTP (port 9090 secara default).
- Setiap endpoint harus menyediakan data dalam format yang bisa dibaca Prometheus (misalnya
/metrics).
-
? Menyimpan Data dalam Bentuk Time-Series
- Data yang dikumpulkan disimpan dalam bentuk time-series database (TSDB).
- Setiap data memiliki timestamp, label, dan nilai metrik.
-
? Mendeteksi Anomali & Mengirimkan Notifikasi (Alerting)
- Dengan Alertmanager, Prometheus bisa mengirimkan notifikasi jika ada kondisi abnormal, misalnya:
- CPU usage tinggi
- Server mati
- Respon lambat
- Notifikasi bisa dikirim ke Slack, Telegram, email, atau Webhook lainnya.
- Dengan Alertmanager, Prometheus bisa mengirimkan notifikasi jika ada kondisi abnormal, misalnya:
-
? Visualisasi Data dengan Grafana
- Prometheus bisa diintegrasikan dengan Grafana untuk menampilkan data dalam bentuk grafik interaktif.
- Ini berguna untuk memonitor performa sistem secara real-time.
-
⚙️ Scaling & High Availability
- Bisa digunakan dalam arsitektur multi-node dengan tambahan tools seperti Thanos atau Cortex.
- Bisa menangani ribuan metrik per detik.
? Contoh Penggunaan Prometheus
✅ Monitoring Server & Infrastruktur
- Melacak penggunaan CPU, RAM, Disk, dan Jaringan pada server.
✅ Monitoring Kubernetes (k8s) - Mengamati pod, node, dan cluster di Kubernetes.
✅ Monitoring Aplikasi - Melihat respon time API, request per detik, error rate, dll.
✅ Monitoring Database - Mengecek jumlah koneksi aktif, query slow, dan penggunaan storage.
cara mengatasi, Error yang muncul masih terkait dengan flag --storage.tsdb.retention, yang sudah tidak valid di versi Prometheus terbaru.
Konfigurasi docker-compose.yml yang Anda gunakan masih memiliki kesalahan yang menyebabkan status "Abnormal" pada aaPanel.
? Kesalahan dalam Konfigurasi
-
Flag
--storage.tsdb.retentionSalah- Anda masih menggunakan flag
--storage.tsdb.retention=200h - Seharusnya:
--storage.tsdb.retention.time=200h
- Anda masih menggunakan flag
jika masih gagal maka
Jika error masih muncul meskipun sudah diganti dengan --storage.tsdb.retention.time=200h, kemungkinan ada beberapa penyebab:
? Solusi Alternatif
-
Cek Versi Prometheus yang Sedang Digunakan
Jalankan perintah berikut untuk melihat versi yang terinstal:Jika versinya lebih lama dari 2.7.0, maka opsi
--storage.tsdb.retention.timetidak dikenali. ternyata versi yang saya gunakan versi 3 -
Gunakan Flag
--storage.tsdb.retention.sizesebagai Alternatif
Jika--storage.tsdb.retention.timetetap error, coba gunakan:
dan masalah pun selesai prometeus jalan normal
? Kesimpulan
Prometheus adalah solusi monitoring yang kuat dan fleksibel, digunakan untuk mengumpulkan dan menganalisis metrik dari berbagai sistem. Dengan integrasi ke Grafana dan Alertmanager, Prometheus membantu tim DevOps & SRE dalam troubleshooting, observability, dan alerting.

