5 Simpele Controles

Overzicht

Eenvoudige controles worden normaal gesproken gebruikt voor externe agentloze controles van services.

Merk op dat de Zabbix-agent niet nodig is voor eenvoudige controles. De Zabbix-server/-proxy is verantwoordelijk voor de verwerking van eenvoudige controles (externe verbindingen maken, enz.).

Voorbeelden van het gebruik van eenvoudige controles:

net.tcp.service[ftp,,155]
net.tcp.service[http]
net.tcp.service.perf[http,,8080]
net.udp.service.perf[ntp]

Ondersteunde controles

De item-sleutels worden vermeld zonder optionele parameters en aanvullende informatie. Klik op de item-sleutel om de volledige details te zien.

Zie ook VMware monitoring item-sleutels.

Item key details

Parameters without angle brackets are mandatory. Parameters marked with angle brackets < > are optional.

icmpping[<target>,<packets>,<interval>,<size>,<timeout>,<options>]

The host accessibility by ICMP ping.
Return value: 0 - ICMP ping fails; 1 - ICMP ping successful.

Parameters:

• target - the host IP or DNS name;
• packets - the number of packets;
• interval - the time between successive packets in milliseconds;
• size - the packet size in bytes;
• timeout - the timeout in milliseconds;
• options - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to allow_redirect, redirected responses are treated as target host up.

See also the table of default values.

Example:

icmpping[,4] #If at least one packet of the four is returned, the item will return 1.

icmppingloss[<target>,<packets>,<interval>,<size>,<timeout>,<options>]

The percentage of lost packets.
Return value: Float.

Parameters:

• target - the host IP or DNS name;
• packets - the number of packets;
• interval - the time between successive packets in milliseconds;
• size - the packet size in bytes;
• timeout - the timeout in milliseconds;
• options - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to allow_redirect, redirected responses are treated as target host up.

See also the table of default values.

icmppingsec[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>]

The ICMP ping response time (in seconds).
Return value: Float.

Parameters:

• target - the host IP or DNS name;
• packets - the number of packets;
• interval - the time between successive packets in milliseconds;
• size - the packet size in bytes;
• timeout - the timeout in milliseconds;
• mode - possible values: min, max, or avg (default);
• options - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to allow_redirect, redirected responses are treated as target host up.

Comments:

• Packets which are lost or timed out are not used in the calculation;
• If the host is not available (timeout reached), the item will return 0;
• If the return value is less than 0.0001 seconds, the value will be set to 0.0001 seconds;
• See also the table of default values.

net.tcp.service[service,<ip>,<poort>]

Controleert of een service actief is en TCP-verbindingen accepteert.
Retourwaarde: 0 - de service is niet actief; 1 - de service is actief.

Parameters:

• service - mogelijke waarden: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (zie details);
• ip - het IP-adres of de DNS-naam (standaard wordt het IP/DNS van de host gebruikt);
• poort - het poortnummer (standaard wordt het standaard poortnummer van de service gebruikt).

Opmerkingen:

• Merk op dat bij de tcp service het aangeven van de poort verplicht is;
• Deze controles kunnen resulteren in aanvullende berichten in systeemdaemon-logbestanden (SMTP- en SSH-sessies worden meestal gelogd);
• Het controleren van versleutelde protocollen (zoals IMAP op poort 993 of POP op poort 995) wordt momenteel niet ondersteund. Als tijdelijke oplossing kun je net.tcp.service[tcp,<ip>,poort] gebruiken voor controles zoals deze.

Voorbeeld:

net.tcp.service[ftp,,45] #Dit item kan worden gebruikt om de beschikbaarheid van een FTP-server op TCP-poort 45 te testen.

net.tcp.service.perf[service,<ip>,<poort>]

Controleert de prestaties van een TCP-service.
Retourwaarde: Decimaal getal: 0,000000 - de service is niet actief; seconden - het aantal seconden dat wordt besteed aan het verbinden met de service.

Parameters:

• service - mogelijke waarden: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (zie details);
• ip - het IP-adres of de DNS-naam (standaard wordt het IP/DNS van de host gebruikt);
• poort - het poortnummer (standaard wordt het standaard poortnummer van de service gebruikt).

Opmerkingen:

• Merk op dat bij de tcp service het aangeven van de poort verplicht is;
• Het controleren van versleutelde protocollen (zoals IMAP op poort 993 of POP op poort 995) wordt momenteel niet ondersteund. Als tijdelijke oplossing kun je net.tcp.service[tcp,<ip>,poort] gebruiken voor controles zoals deze.

Voorbeeld:

net.tcp.service.perf[ssh] #Dit item kan worden gebruikt om de snelheid van de initiële respons van de SSH-server te testen.

net.udp.service[service,<ip>,<poort>]

Controleert of een service actief is en reageert op UDP-verzoeken.
Retourwaarde: 0 - de service is niet actief; 1 - de service is actief.

Parameters:

• service - mogelijke waarden: ntp (zie details);
• ip - het IP-adres of de DNS-naam (standaard wordt het IP/DNS van de host gebruikt);
• poort - het poortnummer (standaard wordt het standaard poortnummer van de service gebruikt).

Voorbeeld:

net.udp.service[ntp,,45] #Dit item kan worden gebruikt om de beschikbaarheid van de NTP-service op UDP-poort 45 te testen.

net.udp.service.perf[service,<ip>,<poort>]

Controleert de prestaties van een UDP-service.
Retourwaarde: Decimaal getal: 0,000000 - de service is niet actief; seconden - het aantal seconden dat wordt besteed aan het wachten op een respons van de service.

Parameters:

• service - mogelijke waarden: ntp (zie details);
• ip - het IP-adres of de DNS-naam (standaard wordt het IP/DNS van de host gebruikt);
• poort - het poortnummer (standaard wordt het standaard poortnummer van de service gebruikt).

Voorbeeld:

net.udp.service.perf[ntp] #Dit item kan worden gebruikt om de responstijd van de NTP-service te testen.

Time-out verwerking

Zabbix zal een eenvoudige controle niet langer verwerken dan het aantal seconden dat is gedefinieerd in het Time-out veld in het configuratiebestand van de Zabbix-server/proxy.

ICMP-pings

Zabbix gebruikt een externe utility fping om ICMP-pings (icmpping, icmppingloss, icmppingsec) te verwerken.

Installatie

fping is niet inbegrepen bij Zabbix en moet apart worden geïnstalleerd:

• Diverse op Unix gebaseerde platformen hebben het fping-pakket in hun standaardrepositories, maar het is niet vooraf geïnstalleerd. In dit geval kun je de pakketbeheerder gebruiken om fping te installeren.

• Zabbix biedt fping-pakketten aan voor RHEL. Houd er rekening mee dat deze pakketten worden geleverd zonder officiële ondersteuning.

• fping kan ook vanaf de bron worden gecompileerd.

Configuratie

Specificeer de locatie van fping in de FpingLocation parameter van het configuratiebestand van de Zabbix-server/proxy (of de Fping6Location parameter voor het gebruik van IPv6-adressen).

fping moet uitvoerbaar zijn voor de gebruiker waaronder de Zabbix-server/proxy wordt uitgevoerd en deze gebruiker moet voldoende rechten hebben.

Zie ook: Bekende problemen voor het verwerken van eenvoudige controles met fping-versies lager dan 3.10.

Standaardwaarden

Standaardwaarden, limieten en beschrijving van waarden voor parameters van ICMP-controles:

De standaardwaarden kunnen enigszins verschillen afhankelijk van het platform en de versie.

Daarnaast gebruikt Zabbix fping-opties -i interval ms (verwar dit niet met de itemparameter interval die in de bovenstaande tabel wordt genoemd, die overeenkomt met de fping-optie -p) en -S bron IP-adres (of -I in oudere fping-versies). Deze opties worden automatisch gedetecteerd door controles uit te voeren met verschillende combinaties van opties. Zabbix probeert de minimale waarde in milliseconden te detecteren die fping toestaat te gebruiken met -i door 3 waarden te proberen: 0, 1 en 10. De waarde die als eerste slaagt, wordt vervolgens gebruikt voor daaropvolgende ICMP-controles. Dit proces wordt individueel uitgevoerd door elk ICMP pinger proces.

Automatisch gedetecteerde fping-opties worden elk uur ongeldig verklaard en opnieuw gedetecteerd bij de volgende poging om een ICMP-controle uit te voeren. Stel DebugLevel>=4 in om details van dit proces te bekijken in het logbestand van de server of proxy.

Zabbix schrijft IP-adressen die moeten worden gecontroleerd door een van de drie icmpping* sleutels naar een tijdelijk bestand, dat vervolgens aan fping wordt doorgegeven. Als items verschillende sleutelparameters hebben, worden alleen degenen met identieke sleutelparameters naar één bestand geschreven. Alle IP-adressen die naar het enkele bestand zijn geschreven, worden parallel door fping gecontroleerd, zodat het Zabbix ICMP-pinger-proces een vaste hoeveelheid tijd zal besteden, ongeacht het aantal IP-adressen in het bestand.