[comment]: # attributes: notoc

[comment]: # translation:outdated

[comment]: # ({be4ab03d-be4ab03d})
# 5 Simpele Controles

[comment]: # ({/be4ab03d-be4ab03d})

[comment]: # ({d34430b9-76023448})
### 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]

::: noteclassic
*Gebruikersnaam* en *Wachtwoord* velden in de configuratie van eenvoudige controle-items worden gebruikt voor VMware-monitoring-items; anders worden ze genegeerd.
:::

[comment]: # ({/d34430b9-76023448})

[comment]: # ({3915152c-f59a5ccc})
### 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](/manual/vm_monitoring/vmware_keys).

|Item-sleutel|Beschrijving|
|--|--------|
[icmpping](#icmpping)|De bereikbaarheid van de host via ICMP-ping.|
|[icmppingloss](#icmppingloss)|Het percentage verloren pakketten.|
|[icmppingsec](#icmppingsec)|De responstijd van ICMP-ping.|
|[net.tcp.service](#nettcpservice)|Controleert of een service actief is en TCP-verbindingen accepteert.|
|[net.tcp.service.perf](#nettcpserviceperf)|Controleert de prestaties van een TCP-service.|
|[net.udp.service](#netudpservice)|Controleert of een service actief is en reageert op UDP-verzoeken.|
|[net.udp.service.perf](#netudpserviceperf)|Controleert de prestaties van een UDP-service.|

[comment]: # ({/3915152c-f59a5ccc})

[comment]: # ({new-23d7246f})

### Item key details

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

[comment]: # ({/new-23d7246f})

[comment]: # ({new-7d8dff2e})

##### icmpping\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmpping}

<br>
The host accessibility by ICMP ping.<br>
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](#default-values).

Example:

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

[comment]: # ({/new-7d8dff2e})

[comment]: # ({new-6cd0f1b1})

##### icmppingloss\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmppingloss}

<br>
The percentage of lost packets.<br>
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](#default-values).

[comment]: # ({/new-6cd0f1b1})

[comment]: # ({new-b5636838})

##### icmppingsec\[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>\] {#icmppingsec}

<br>
The ICMP ping response time (in seconds).<br>
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](#default-values).

[comment]: # ({/new-b5636838})

[comment]: # ({cecb7c2a-b0a71170})
##### net.tcp.service[service,<ip>,<poort>] {#nettcpservice}

<br>
Controleert of een service actief is en TCP-verbindingen accepteert.<br>
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](/manual/appendix/items/service_check_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.

[comment]: # ({/cecb7c2a-b0a71170})

[comment]: # ({2b8dd30e-946385b4})
##### net.tcp.service.perf[service,<ip>,<poort>] {#nettcpserviceperf}

<br>
Controleert de prestaties van een TCP-service.<br>
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](/manual/appendix/items/service_check_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.

[comment]: # ({/2b8dd30e-946385b4})

[comment]: # ({db92de8d-2859223a})
##### net.udp.service[service,<ip>,<poort>] {#netudpservice}

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

Parameters:

-   **service** - mogelijke waarden: *ntp* (zie [details](/manual/appendix/items/service_check_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.

[comment]: # ({/db92de8d-2859223a})

[comment]: # ({942e3066-9cf5922c})
##### net.udp.service.perf[service,<ip>,<poort>] {#netudpserviceperf}

<br>
Controleert de prestaties van een UDP-service.<br>
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](/manual/appendix/items/service_check_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.

[comment]: # ({/942e3066-9cf5922c})

[comment]: # ({621c13d4-85612a2b})
::: noteimportant
Voor ondersteuning van SourceIP in eenvoudige LDAP-controles (bijv. `net.tcp.service[ldap]`), is OpenLDAP-versie 2.6.1 of hoger vereist.
:::

[comment]: # ({/621c13d4-85612a2b})

[comment]: # ({e1980fa1-92a6c4ae})
##### 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.

[comment]: # ({/e1980fa1-92a6c4ae})

[comment]: # ({30611a67-b08a4508})
### ICMP-pings

Zabbix gebruikt een externe utility **[fping](https://fping.org/)** om ICMP-pings (**icmpping**, **icmppingloss**, **icmppingsec**) te verwerken.

[comment]: # ({/30611a67-b08a4508})

[comment]: # ({d81af73e-e3dd9826})
##### 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](http://repo.zabbix.com/non-supported/rhel/) aan voor RHEL. Houd er rekening mee dat deze pakketten worden geleverd zonder officiële ondersteuning.

- fping kan ook [vanaf de bron](https://github.com/schweikert/fping/blob/develop/README.md#installation) worden gecompileerd.

[comment]: # ({/d81af73e-e3dd9826})

[comment]: # ({b2c27900-9ced6345})
##### Configuratie

Specificeer de locatie van fping in de *[FpingLocation](/manual/appendix/config/zabbix_server#fpinglocation)* parameter van het configuratiebestand van de Zabbix-server/proxy 
(of de *[Fping6Location](/manual/appendix/config/zabbix_server#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](/manual/installation/known_issues#simple_checks) voor het verwerken van eenvoudige controles met fping-versies lager dan 3.10.

[comment]: # ({/b2c27900-9ced6345})

[comment]: # ({e379fb37-3c21487d})
##### Standaardwaarden

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

|Parameter|Eenheid|Beschrijving|Vlag in fping|Standaarden ingesteld door|<|Toegestane limieten<br>door Zabbix|<|
|--|--|--------|-|--|--|--|--|
|||||**fping**|**Zabbix**|**min**|**max**|
|pakketten|aantal|aantal aanvraagpakketten verzonden naar een doel|-C||3|1|10000|
|interval|milliseconden|tijd om te wachten tussen opeenvolgende pakketten naar een individueel doelwit|-p|1000||20|onbeperkt|
|grootte|bytes|pakketgrootte in bytes<br>56 bytes op x86, 68 bytes op x86_64|-b|56 of 68||24|65507|
|time-out|milliseconden|**fping v3.x** - time-out om te wachten na het laatste verzonden pakket, beïnvloed door de *-C* vlag<br> **fping v4.x** - individuele time-out voor elk pakket|-t|**fping v3.x** - 500<br>**fping v4.x** en nieuwer - overgenomen van de *-p* vlag, maar niet meer dan 2000||50|onbeperkt|

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](/manual/concepts/server#server_process_types) 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](/manual/appendix/config/zabbix_server#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.

[comment]: # ({/e379fb37-3c21487d})