> Service-object

De volgende objecten zijn direct gerelateerd aan de service API.

Service

Het serviceobject heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
serviceid string ID van de service.

Eigenschapsgedrag:
- alleen lezen
- vereist voor updatebewerkingen
algorithm integer Statusberekeningsregel. Alleen van toepassing als er kindservices zijn.

Mogelijke waarden:
0 - status instellen op OK;
1 - meest kritisch als alle kinderen problemen hebben;
2 - meest kritisch van kindservices.

Eigenschapsgedrag:
- vereist voor aanmaakbewerkingen
name string Naam van de service.

Eigenschapsgedrag:
- vereist voor aanmaakbewerkingen
sortorder integer Positie van de service die wordt gebruikt voor sorteren.

Mogelijke waarden: 0-999.

Eigenschapsgedrag:
- vereist voor aanmaakbewerkingen
weight integer Servicegewicht.

Mogelijke waarden: 0-1000000.

Standaard: 0.
propagation_rule integer Statuspropagatieregel.

Mogelijke waarden:
0 - (standaard) propageer de servicestatus zoals die is - zonder enige wijzigingen;
1 - verhoog de gepropageerde status met een opgegeven propagation_value (met 1 tot 5 ernstgraden);
2 - verlaag de gepropageerde status met een opgegeven propagation_value (met 1 tot 5 ernstgraden);
3 - negeer deze service - de status wordt helemaal niet naar de bovenservice gepropageerd;
4 - stel vaste servicestatus in met een opgegeven propagation_value.

Eigenschapsgedrag:
- vereist als propagation_value is ingesteld
propagation_value integer Statuspropagatiewaarde.

Mogelijke waarden als propagation_rule is ingesteld op "0" of "3":
0 - Niet geclassificeerd.

Mogelijke waarden als propagation_rule is ingesteld op "1" of "2":
1 - Informatie;
2 - Waarschuwing;
3 - Gemiddeld;
4 - Hoog;
5 - Ramp.

Mogelijke waarden als propagation_rule is ingesteld op "4":
-1 - OK;
0 - Niet geclassificeerd;
1 - Informatie;
2 - Waarschuwing;
3 - Gemiddeld;
4 - Hoog;
5 - Ramp.

Eigenschapsgedrag:
- vereist als propagation_rule is ingesteld
status integer Of de service zich in de OK- of probleemstatus bevindt.

Als de service zich in de probleemstatus bevindt, is status gelijk aan:
- de ernst van het meest kritieke probleem;
- de hoogste status van een kindservice in de probleemstatus.

Als de service zich in de OK-status bevindt, is status gelijk aan: -1.

Eigenschapsgedrag:
- alleen lezen
description string Beschrijving van de service.
uuid string Unieke universele identificatiecode, gebruikt voor het koppelen van geïmporteerde services aan reeds bestaande. Automatisch gegenereerd indien niet opgegeven.
created_at integer Unix-tijdstempel waarop de service is aangemaakt.
readonly boolean Toegang tot de service.

Mogelijke waarden:
0 - Lezen en schrijven;
1 - Alleen lezen.

Eigenschapsgedrag:
- alleen lezen

Statusregel

Het statusregelobject heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
type integer Voorwaarde voor het instellen van de status (Nieuwe status).

Mogelijke waarden:
0 - als ten minste (N) kindservices de status (Status) hebben of hoger;
1 - als ten minste (N%) van de kindservices de status (Status) hebben of hoger;
2 - als minder dan (N) kindservices de status (Status) hebben of lager;
3 - als minder dan (N%) van de kindservices de status (Status) hebben of lager;
4 - als het gewicht van kindservices met de status (Status) of hoger ten minste (W) is;
5 - als het gewicht van kindservices met de status (Status) of hoger ten minste (N%) is;
6 - als het gewicht van kindservices met de status (Status) of lager minder is dan (W);
7 - als het gewicht van kindservices met de status (Status) of lager minder is dan (N%).

Waar:
- N (W) is limit_value;
- (Status) is limit_status;
- (Nieuwe status) is new_status.

Eigenschapsgedrag:
- vereist
limit_value integer Limietwaarde.

Mogelijke waarden:
- voor N en W: 1-100000;
- voor N%: 1-100.

Eigenschapsgedrag:
- vereist
limit_status integer Limietstatus.

Mogelijke waarden:
-1 - OK;
0 - Niet geclassificeerd;
1 - Informatie;
2 - Waarschuwing;
3 - Gemiddeld;
4 - Hoog;
5 - Ramp.

Eigenschapsgedrag:
- vereist
new_status integer Nieuwe statuswaarde.

Mogelijke waarden:
0 - Niet geclassificeerd;
1 - Informatie;
2 - Waarschuwing;
3 - Gemiddeld;
4 - Hoog;
5 - Ramp.

Eigenschapsgedrag:
- vereist

Servicetag

Het object voor servicetags heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
tag string Naam van de servicetag.

Eigenschapsgedrag:
- vereist
value string Waarde van de servicetag.

Service-alarm

Service-alarms kunnen niet rechtstreeks worden gemaakt, bijgewerkt of verwijderd via de Zabbix API.

De objecten voor service-alarmen vertegenwoordigen een verandering in de status van een service. Ze hebben de volgende eigenschappen.

Eigenschap Type Beschrijving
clock tijdstempel Tijdstip waarop de verandering in de servicestatus heeft plaatsgevonden.
value integer Status van de service.

Zie de eigenschap servicestatus voor een lijst van mogelijke waarden.

Probleemtag

Probleemtags maken het mogelijk om services te koppelen aan probleemgebeurtenissen. Het object voor probleemtags heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
tag string Naam van de probleemtag.

Gedrag van eigenschap:
- verplicht
operator integer Operator voor mappingvoorwaarde.

Mogelijke waarden:
0 - (standaard) gelijk aan;
2 - gelijkend op.
value string Waarde van de probleemtag.