PHP · MySQL / MariaDB · SNMP · Zabbix-agent

Övervaka servrar, hypervisors och nätverk från en sida

VM Monitor visar status för Windows- och Linux-servrar, NAS, Proxmox, VMware och Hyper-V, switchar, routrar och brandväggar samt vanliga tjänster. Du får larm när något går över dina gränsvärden.

Innan du börjar

Krav

Installationen nedan utgår från Debian eller Ubuntu. Samma delar behövs på andra distributioner, med andra paketnamn.

Server (där VM Monitor körs)

Nätverk

Installation

Steg för steg

Följ stegen i ordning. Byt ut vmmon.example.se och lösenord mot dina egna värden.

1. Installera webbserver, databas och PHP 8.5

   Uppdatera systemet och lägg först till en paketkälla för PHP 8.5. Debian och Ubuntu levererar ofta en äldre PHP-version som standard, så här används Ondřej Surýs paketkälla.

   UbuntuDebian

   bashKopiera

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y software-properties-common curl unzip
   sudo add-apt-repository -y ppa:ondrej/php
   sudo apt update

   Installera sedan PHP med alla tillägg. iputils-ping behövs för ping-checks och snmp ger dig kommandot snmpwalk för felsökning.

   bashKopiera

   sudo apt install -y php8.5-cli php8.5-fpm php8.5-mysql php8.5-curl \
     php8.5-snmp php8.5-mbstring iputils-ping snmp
   php -v
   php -m | grep -Ei 'pdo_mysql|curl|openssl|snmp|mbstring'

   Utskriften från php -m ska innehålla alla fem namnen.

   Välj webbserver och databas. Du behöver bara en av varje.

   nginxApache

   bashKopiera

   sudo apt install -y nginx
   sudo systemctl enable --now nginx php8.5-fpm

   MariaDBMySQL

   bashKopiera

   sudo apt install -y mariadb-server
   sudo systemctl enable --now mariadb
   sudo mysql_secure_installation

   På RHEL, Rocky och Alma heter paketen php-snmp, php-mysqlnd och så vidare. PHP 8.5 kommer då från Remi-repot. Resten av guiden gäller oförändrad, men filsökvägar och användaren www-data heter apache eller nginx.

2. Skapa databasanvändare och importera databasen

   Zippen innehåller schema.sql. Den skapar databasen vmmon med alla tabeller och är komplett, så du ska inte köra några migrate_*.sql vid en ny installation.

   Skapa först en egen användare med rättigheter bara på databasen vmmon:

   bashKopiera

   sudo mysql

   sqlKopiera

   CREATE DATABASE IF NOT EXISTS vmmon CHARACTER SET utf8mb4;
   CREATE USER 'vmmon'@'localhost' IDENTIFIED BY 'byt-till-ett-langt-losenord';
   GRANT ALL PRIVILEGES ON vmmon.* TO 'vmmon'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

   Importera sedan schemat från den uppackade mappen:

   bashKopiera

   cd /var/www/vmmon
   sudo mysql < schema.sql
   sudo mysql -e "USE vmmon; SHOW TABLES;"

   Listan ska innehålla 13 tabeller, bland annat users, servers, server_checks, alert_rules och app_log. Hoppa till steg 3 om du inte har packat upp filerna än, och kör importen när de ligger på plats.

   schema.sql är till för en tom installation. Kör den inte mot en databas med data, den skapar tabellerna från början.

   Ska databasen ligga på en annan server? Skapa användaren som 'vmmon'@'webbserverns-ip' och sätt bind-address i databasens konfiguration så att den lyssnar på nätverket.

3. Lägg filerna på plats och ställ in config

   bashKopiera

   sudo mkdir -p /var/www/vmmon
   sudo unzip vmmon.zip -d /tmp/vmmon-unzip
   sudo cp -r /tmp/vmmon-unzip/vmmon/. /var/www/vmmon/
   sudo chown -R www-data:www-data /var/www/vmmon
   sudo find /var/www/vmmon -type d -exec chmod 750 {} \;
   sudo find /var/www/vmmon -type f -exec chmod 640 {} \;

   Webbanvändaren måste kunna skriva i mappen, eftersom programmet skapar filen secret.php vid första start.

   Databasuppgifter i config.local.php

   Kopiera exempelfilen och fyll i dina uppgifter. Redigera inte config.php. Den ersätts vid uppdateringar, medan config.local.php ligger kvar.

   bashKopiera

   cd /var/www/vmmon
   sudo -u www-data cp config.local.php.example config.local.php
   sudo -u www-data nano config.local.php

   config.local.phpKopiera

   <?php
   const DB_DSN  = 'mysql:host=localhost;dbname=vmmon;charset=utf8mb4';
   const DB_USER = 'vmmon';
   const DB_PASS = 'byt-till-ett-langt-losenord';

   Rad	Betyder
   DB_DSN	host är databasservern (localhost eller ett IP-nummer), dbname är databasen. Lägg till ;port=3307 om du använder en annan port.
   DB_USER	Användaren du skapade i steg 2.
   DB_PASS	Lösenordet till den användaren. Använd enkla citattecken, och tecknet ' i lösenordet måste skrivas \'.

   Ta backup på secret.php när den har skapats. Den innehåller nyckeln som krypterar lösenord och tokens i databasen. Utan den måste du skriva in dem igen. Nyckeln kan i stället sättas som SECRET_KEY i config.local.php.

4. Konfigurera webbservern

   Konfigurationen pekar på PHP-FPM och stänger dessutom åtkomsten till filer som inte ska nås utifrån, som .sql, .txt och config.local.php.

   nginxApache

   /etc/nginx/sites-available/vmmonKopiera

   server {
       listen 80;
       server_name vmmon.example.se;
       root /var/www/vmmon;
       index index.php;
   
       location / { try_files $uri $uri/ =404; }
   
       location ~ \.php$ {
           include snippets/fastcgi-php.conf;
           fastcgi_pass unix:/run/php/php8.5-fpm.sock;
       }
   
       # Stäng åtkomst till filer som inte ska nås utifrån
       location ~* \.(sql|txt|service|example|md)$ { deny all; }
       location ~* ^/(config\.local|secret)\.php$ { deny all; }
       location ~ /\.ht { deny all; }
   }

   bashKopiera

   sudo ln -s /etc/nginx/sites-available/vmmon /etc/nginx/sites-enabled/vmmon
   sudo nginx -t && sudo systemctl reload nginx

   HTTPS

   Inloggningen och dina lösenord ska aldrig gå i klartext. Hämta ett gratis certifikat med Let's Encrypt:

   nginxApache

   bashKopiera

   sudo apt install -y certbot python3-certbot-nginx
   sudo certbot --nginx -d vmmon.example.se

   Har du bara ett internt nätverk får du använda en egen CA eller ett självsignerat certifikat.

5. Första start och administratör

   1. Öppna https://vmmon.example.se. Så länge databasen saknar användare visar inloggningssidan formuläret Skapa första administratören.
   2. Fyll i användarnamn, e-post och ett lösenord på minst 8 tecken. E-postadressen används för "Glömt lösenord".
   3. Öppna Inställningar. Under Allmänt ställer du in intervall, gränsvärden och hur länge data och loggar sparas. Under SNMP anger du standard-community, och under Notifieringar fyller du i SMTP och eventuellt Telegram, webhook och SMS.
   4. Lägg till din första server under Servrar, och skapa larmregler under Larmregler.

   Fler användare skapas under Inställningar → Användare. Rollen admin kan ändra allt, rollen user kan bara titta.

6. Bakgrundstjänsten (systemctl)

   Utan tjänsten körs kontroller och larm bara medan någon har dashboarden öppen, eftersom webbläsaren då anropar api/poll.php var 15:e sekund. Tjänsten vmmon-worker kör dem hela tiden. När den är igång hoppar dashboarden över egen pollning, och om tjänsten stannar tar webbläsaren över automatiskt.

   Filen vmmon-worker.service följer med i zippen:

   vmmon-worker.serviceKopiera

   [Unit]
   Description=VM Monitor worker (kontroller, hosts och larm)
   After=network-online.target mysql.service mariadb.service
   
   [Service]
   User=www-data
   WorkingDirectory=/var/www/vmmon
   ExecStart=/usr/bin/php /var/www/vmmon/worker.php
   Restart=always
   RestartSec=5
   
   [Install]
   WantedBy=multi-user.target

   Justera User och sökvägarna om du valde andra. Användaren ska vara samma som webbservern kör som, eftersom den behöver läsa config.local.php och secret.php.

   bashKopiera

   sudo cp /var/www/vmmon/vmmon-worker.service /etc/systemd/system/
   sudo systemctl daemon-reload
   sudo systemctl enable --now vmmon-worker
   systemctl status vmmon-worker
   journalctl -u vmmon-worker -f

   I loggen ska du se startar, och vid första cykeln kördes: N kontroller…. Därefter kommer lever: … var tionde minut. Du kan också köra en enda cykel för hand: sudo -u www-data php /var/www/vmmon/worker.php --once.

   Vill du se tjänstens logg i gränssnittet under Inställningar → Loggar lägger du webbanvändaren i gruppen systemd-journal:
   sudo usermod -aG systemd-journal www-data, och startar sedan om PHP-FPM och tjänsten. PHP:s exec() måste vara tillåtet.

   Utan systemd

   • Cron, varje minut: * * * * * www-data php /var/www/vmmon/worker.php --for=55
   • Windows: nssm install VMMonitor php.exe C:\sökväg\worker.php, eller en schemalagd aktivitet vid start.

Underhåll

Uppgradera

1. Ta backup på databasen: mysqldump vmmon > vmmon-backup.sql, och på secret.php och config.local.php.
2. Ersätt filerna i /var/www/vmmon med de nya. Dina uppgifter ligger kvar i config.local.php.
3. Kör de migreringsfiler som är nyare än din version, i ordning, till exempel sudo mysql vmmon < migrate_v19.sql. Filen README.txt anger vilken migrering som hör till vilken uppgradering. Kör bara dem du inte redan har kört.
4. Starta om tjänsten: sudo systemctl restart vmmon-worker, och ladda om webbläsaren med Ctrl+F5.

Funktioner

Vad kan övervakas

Allt läggs till i gränssnittet. Varje server, host, nätverksenhet och tjänst har samma sida med rutan Pausa larm / Inaktivera / Dölj från dash och panelen Tjänster och kontroller, där varje kontroll kan testas för hand med Testa nu.

Kontrolltyper

TCP-portar med färdiga val

Zabbix-agent, grupper av kontroller

Varje Zabbix-kontroll kan ha ett villkor för OK, till exempel <90, >=1, =active eller ~text.

Nätverksenheter

Välj roll (switch, router eller brandvägg) när du lägger till enheten. Enheter som inte finns i listan fungerar som Annan via standard-SNMP, men visar då färre sensorer.

Larm och notiser

Larmregler skapas i tre steg: vad som ska övervakas, villkor och mottagare. En regel kan gälla alla enheter, vissa enheter eller bara en viss tjänst, ett interface eller en VM.

Kanaler

Larm kan pausas per enhet eller för alla på en gång, och en enhet kan sättas i underhållsläge.

Vanliga frågor

FAQ

Installation

Ping och SNMP

Zabbix-agent

Virtualisering

Dashboard och inställningar

Säkerhet