Checkmk Proxmox

Proxmox monitoring in CheckMK

Erstellen eines Api Nutzers auf Proxmox Ebene

• Als erstes muss ein Benutzer für Checkmk auf dem Proxmox-Cluster angelegt werden
  • Datacenter -> Permissions -> User

• Anschließend wird eine Gruppe erstellt mit dem Namen Read_Only (der Name kann beliebig gewählt werden)
  • Datacenter -> Permissions -> Groups

• Dieser Gruppe müssen nun noch Rechte vergeben werden.
  • Datacenter -> Permissions
• Der Path steht von wo aus Beginnend die Gruppe Rechte hat.
  • Hierfür wählen wir /
• Als Role nehmen wir den PVEAuditor.
  • Dies ist dafür das die Gruppe nur Read-Only Rechte besitzt

Checkmk Konfiguration

• Wir gehen davon aus das die Proxmoxe schon als Host in Checkmk eingetragen sind und der Agent installiert ist.
• Die Option für die Proxmox Hosts Monitoring agents muss auf Configured API integrations and Checkmk agent gewechselt werden

Special Agent

• Über Setup -> VM, Cloud, Container -> Proxmox VE richten wir den Special Agent ein.
• Als Username und Password werden die Daten von dem vorher erstellten Proxmox User genutzt.
  • Das @pve ist wichtig um anzugeben welche Authentifizierung der User nutzt
• Die Proxmox Hosts wurden in einem Ordner erstellt (proxmox), in der wir die Regel erstellen

Service monitoring rules

• Weitere 5 Regeln müssen angelegt werden, dass die Services auch angezeigt werden.
• Diese befinden sich unter Setup -> Services -> Service monitoring rules
• Oder über Setup das Stichwort Proxmox suchen

• Die 5 Services Proxmox VE VM Backup, Proxmox VE Node Info, Proxmox VE memory percentage used, Proxmox VE VM Info, Proxmox VE disk percentage used müssen für den Proxmox Ordner angelegt werden.

Wichtige Zusatz Info

• Der Checkmk Server muss in der Lage sein die Proxmox Server über den Hostname erreichen zu können.
  • Die IP mit anzugeben wird nicht funktionieren, außer als Hostname wird die IP Adresse gewählt.
  • Ein Workaround, wenn es keine Möglichkeit gibt für den Checkmk Server den Hostname aufzulösen, ist die IP und den Namen in die /etc/Hosts einzutragen
• Die angelegten Hosts im Checkmk müssen den selben Hostname wie die Virtuellen Maschinen im Proxmox haben.
  • Falls der FQDN im Checkmk angegeben worden ist und die VM in dem Proxmox ohne Domain geschrieben ist, kann folgendes unternommen werden:

• In unserem Beispiel sind unsere VMs im Checkmk mit dem FQDN eingetragen und in unserem Proxmox nur als Hostname
• Über 'Setup -> Access to Agents -> Hostname translation for piggybacked hosts erstellen wir eine Regel

• An die erhaltenen Piggyback Daten hängen wir nun mithilfe dieser Regel die Domain an.