Proxmox VE, açık kaynaklı yapısı ve esnekliği sayesinde yaygın kullanılan bir sanallaştırma çözümüdür. Altyapınız büyüdüğünde performans sorunlarını fark etmek ve kaynak kullanımını düzenli takip etmek için Zabbix devreye girer. CPU, bellek, disk ve ağ izleme, cluster sağlığı takibi ve otomatik uyarılar sayesinde sistem daha güvenilir hale gelir. Bu entegrasyon, hem kurumlara hem de bireysel kullanıcılara büyük avantaj sağlar.
Konuyla ilgili daha geniş bilgi için Zabbix Kurulumu ile Dashboard Yönetimi ve İzleme yazımıza göz atabilirsiniz.

Zabbix Proxmox Gereksinimleri
Hazırlık aşamasında üç temel gereksinim vardır. Birincisi, kurulu ve aktif durumda bir Zabbix sunucusudur. İkincisi, en az bir adet Proxmox VE host gereklidir. Üçüncüsü ise, agent kurulumu yapabilmek için Proxmox host üzerinde root erişiminin bulunmasıdır.
Zabbix Agent 2 Kurulumu (Proxmox Host)
Proxmox host’tan performans ve donanım metriklerini izlemek için Zabbix Agent 2 kurulumu yapılmalıdır. Kurulum tamamlandığında CPU, bellek, disk kullanımı ve ağ trafiği gibi veriler düzenli olarak Zabbix tarafından toplanır.
apt update
apt install zabbix-agent2
systemctl enable zabbix-agent2
systemctl start zabbix-agent2
Kurulum tamamlandıktan sonra /etc/zabbix/zabbix_agent2.conf dosyasında Zabbix sunucusunun IP adresi tanımlanmalıdır. Daha sonra servisi yeniden başlatmak yeterlidir.
Server=ZABBIX_SERVER_IP
ServerActive=ZABBIX_SERVER_IP
Hostname=proxmox-node1
API ile Cluster ve VM İzleme
Agent, host seviyesindeki verileri toplar; ancak cluster sağlığı ve VM bilgileri için Proxmox’un REST API’si kullanılır. Bunun için Proxmox tarafında özel bir kullanıcı ve API token tanımlanmalıdır.
zabbix-monitoring adında kullanıcı oluşturalım.Kimlik doğrulama yöntemi olarak PVE Authentication Server seçelim.

Kullanıcıya bir API token atadıktan sonra “Separate privileges” seçeneğini kapalı bırakalım ve Token kimliği ve gizli anahtarı güvenli bir yerde saklayalım.
*Rol olarak PVE Auditor atayın

Zabbix tarafında ise host tanımlaması yapılırken makrolar bölümüne bu token bilgileri girilir. Böylece Zabbix, API aracılığıyla cluster ve sanal makineleri otomatik olarak keşfeder.
{$PVE.API.TOKEN} → API Token Kimliği
{$PVE.API.SECRET} → Token Gizli Anahtarı
{$PVE.URL.HOST} → Node IP adresi (opsiyonel)
{$PVE.URL.PORT} → 8006 (varsayılan, opsiyonel)

Web Arayüzünde Yapılandırma
Zabbix sunucusu kurulduktan sonra web arayüzüne giriş yapalım. Varsayılan kullanıcı adı Admin, parola ise zabbix’tir. İlk girişte sizi karşılayan dashboard, Zabbix sunucusunun kendi durumunu gösterir.
Proxmox Host Ekleme
Proxmox’u Zabbix’e entegre etmek için yeni bir host ekleyelim. Host adı: “Proxmox Cluster” gibi anlamlı bir isim verelim. Şablonda olarak Proxmox VE by HTTP seçelim. Grup olarak “Hypervisors” kullanılabilir veya yeni bir grup oluşturulabilir. Arayüz kısmına cluster’ın yönetici node’unun IP adresi girilmesi yeterlidir, ancak tüm node adresleri de eklenerek daha güvenli bir yapı elde edilebilir.

Bu adımlar tamamlandığında Zabbix, Proxmox ile bağlantı kurar ve birkaç dakika içinde veriler toplanmaya başlar.
Şablonlar ve Alarm Senaryoları
Resmi Zabbix deposunda Proxmox için özel bir şablon bulunmasa da topluluk tarafından geliştirilen şablonlar kullanılabilir. Bu şablonlar içe aktarıldığında CPU, bellek, disk IO, ağ trafiği ve depolama kullanımı gibi birçok metrik hazır hale gelir. Proxmox VE ile Cluster Yapılandırması yapıldığında bu şablonlar daha kapsamlı bir izleme ortamı sağlar.
Dashboard ve Raporlama
Zabbix sadece veri toplamakla kalmaz, bu verileri görselleştirir. Proxmox cluster’ın genel sağlığını, VM performansını ve depolama durumunu grafikler ve tablolar aracılığıyla izleyebilirsiniz. Ayrıca SLA raporları sayesinde uptime oranlarını ve kapasite kullanım trendlerini üst yönetime sunabilirsiniz.
Sıkça Sorulan Sorular (SSS)
Zabbix ile Proxmox ve VMware ESXi izleme arasında fark var mı, hangisini tercih etmeliyim?
Zabbix her iki sanallaştırma platformunu da destekler; Proxmox için HTTP API ve agent üzerinden metrikler toplanırken, VMware ESXi tarafında vCenter entegrasyonu ve hazır şablonlar kullanılır. Kapsamlı bir karşılaştırmayı şu yazımızda;
👉Proxmox ve VMware ESXi Karşılaştırması
Proxmox VE Zabbix ile nasıl izlenir?
Proxmox’u Zabbix ile izlemek için “Proxmox VE by HTTP” şablonunu kullanabilirsiniz. Bunun için Proxmox tarafında API token oluşturarak zabbix-monitoring gibi bir kullanıcı tanımlayın. Ardından bu token bilgilerini Zabbix’te makro alanına ekleyerek cluster ve sanal makinelerin otomatik keşfini sağlayabilirsiniz.
Proxmox Zabbix HTTP şablonu çalışmıyor, ne yapmalıyım?
En sık karşılaşılan sorun API token izinleridir. Proxmox’ta oluşturulan token’ın “separate privileges” seçeneği kapalı olmalı ve kullanıcıya PVE Auditor rolü atanmalıdır. Ayrıca Zabbix tarafında doğru node IP’si ve port bilgisi girilmediğinde de bağlantı kurulamaz. Bağlantıyı test etmek için curl komutuyla API erişimini deneyebilirsiniz.
Çok node’lu Proxmox cluster’ı Zabbix ile nasıl izlerim?
Cluster’daki tüm node IP’lerini Zabbix üzerinde ilgili host arayüzüne ekleyebilirsiniz. Her node’a ayrıca agent kurulması da önerilir. Bu şekilde bir node erişilemez hale gelse bile diğerlerinden veri toplamaya devam edilir.
Zabbix ile Proxmox yedekleme ve depolama durumu izlenebilir mi?
Bunun için topluluk tarafından geliştirilen ek şablonlar veya scriptler kullanılabilir. Örneğin depolama doluluk oranları, PBS (Proxmox Backup Server) görevleri veya snapshot durumları özel komut dosyaları ile izlenebilir.