Obiekt usługi

Następujące obiekty są bezpośrednio powiązane z API usługi.

Usługa

Obiekt usługi ma następujące właściwości.

Właściwość Typ Opis
serviceid ID ID usługi.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji aktualizacji
algorithm integer Reguła obliczania statusu. Ma zastosowanie tylko wtedy, gdy istnieją usługi podrzędne.

Możliwe wartości:
0 - ustaw status na OK;
1 - najbardziej krytyczny, jeśli wszystkie elementy podrzędne mają problemy;
2 - najbardziej krytyczny spośród usług podrzędnych.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
name string Nazwa usługi.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
sortorder integer Pozycja usługi używana do sortowania.

Możliwe wartości: 0-999.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
weight integer Waga usługi.

Możliwe wartości: 0-1000000.

Domyślnie: 0.
propagation_rule integer Reguła propagacji statusu.

Możliwe wartości:
0 - (domyślnie) propaguj status usługi bez zmian;
1 - zwiększ propagowany status o podaną wartość propagation_value (o 1 do 5 poziomów ważności);
2 - zmniejsz propagowany status o podaną wartość propagation_value (o 1 do 5 poziomów ważności);
3 - ignoruj tę usługę - status w ogóle nie jest propagowany do usługi nadrzędnej;
4 - ustaw stały status usługi przy użyciu podanej wartości propagation_value.

Zachowanie właściwości:
- wymagane, jeśli ustawiono propagation_value
propagation_value integer Wartość propagacji statusu.

Możliwe wartości, jeśli propagation_rule jest ustawione na „0” lub „3”:
0 - Niesklasyfikowane.

Możliwe wartości, jeśli propagation_rule jest ustawione na „1” lub „2”:
1 - Informacja;
2 - Ostrzeżenie;
3 - Średni;
4 - Wysoki;
5 - Katastrofa.

Możliwe wartości, jeśli propagation_rule jest ustawione na „4”:
-1 - OK;
0 - Niesklasyfikowane;
1 - Informacja;
2 - Ostrzeżenie;
3 - Średni;
4 - Wysoki;
5 - Katastrofa.

Zachowanie właściwości:
- wymagane, jeśli ustawiono propagation_rule
status integer Określa, czy usługa jest w stanie OK, czy w stanie problemu.

Jeśli usługa jest w stanie problemu, status jest równy jednej z następujących wartości:
- ważności najbardziej krytycznego problemu;
- najwyższemu statusowi usługi podrzędnej będącej w stanie problemu.

Jeśli usługa jest w stanie OK, status jest równy: -1.

Zachowanie właściwości:
- tylko do odczytu
description string Opis usługi.
uuid string Uniwersalny unikalny identyfikator używany do łączenia importowanych usług z już istniejącymi. Generowany automatycznie, jeśli nie został podany.
created_at integer Znacznik czasu Unix określający moment utworzenia usługi.
readonly integer Dostęp do usługi.

Możliwe wartości:
0 - Odczyt i zapis;
1 - Tylko do odczytu.

Zachowanie właściwości:
- tylko do odczytu

Reguła statusu

Obiekt reguły statusu ma następujące właściwości.

Właściwość Typ Opis
type integer Warunek ustawienia statusu (Nowy status).

Możliwe wartości:
0 - jeśli co najmniej (N) usług podrzędnych ma status (Status) lub wyższy;
1 - jeśli co najmniej (N%) usług podrzędnych ma status (Status) lub wyższy;
2 - jeśli mniej niż (N) usług podrzędnych ma status (Status) lub niższy;
3 - jeśli mniej niż (N%) usług podrzędnych ma status (Status) lub niższy;
4 - jeśli waga usług podrzędnych o statusie (Status) lub wyższym wynosi co najmniej (W);
5 - jeśli waga usług podrzędnych o statusie (Status) lub wyższym wynosi co najmniej (N%);
6 - jeśli waga usług podrzędnych o statusie (Status) lub niższym jest mniejsza niż (W);
7 - jeśli waga usług podrzędnych o statusie (Status) lub niższym jest mniejsza niż (N%).

Gdzie:
- N (W) to limit_value;
- (Status) to limit_status;
- (Nowy status) to new_status.

Zachowanie właściwości:
- wymagane
limit_value integer Wartość graniczna.

Możliwe wartości:
- dla N i W: 1-100000;
- dla N%: 1-100.

Zachowanie właściwości:
- wymagane
limit_status integer Status graniczny.

Możliwe wartości:
-1 - OK;
0 - Niesklasyfikowany;
1 - Informacja;
2 - Ostrzeżenie;
3 - Średni;
4 - Wysoki;
5 - Katastrofa.

Zachowanie właściwości:
- wymagane
new_status integer Wartość nowego statusu.

Możliwe wartości:
0 - Niesklasyfikowany;
1 - Informacja;
2 - Ostrzeżenie;
3 - Średni;
4 - Wysoki;
5 - Katastrofa.

Zachowanie właściwości:
- wymagane

Znacznik usługi

Obiekt znacznika usługi ma następujące właściwości.

Właściwość Type Opis
tag string Nazwa znacznika usługi.

Zachowanie właściwości:
- wymagane
value string Wartość znacznika usługi.

Alarm usługi

Alarmów usługi nie można bezpośrednio tworzyć, aktualizować ani usuwać za pomocą Zabbix API.

Obiekty alarmu usługi reprezentują zmianę stanu usługi. Mają następujące właściwości.

Właściwość Typ Opis
clock timestamp Czas wystąpienia zmiany stanu usługi.
value integer Status usługi.

Listę możliwych wartości można znaleźć we właściwości status usługi.

Znacznik problemu

Znaczniki problemów umożliwiają powiązanie usług ze zdarzeniami problemów. Obiekt znacznika problemu ma następujące właściwości.

Właściwość Typ Opis
tag string Nazwa znacznika problemu.

Zachowanie właściwości:
- wymagane
operator integer Warunek mapowania operator.

Możliwe wartości:
0 - (domyślnie) Równa się;
2 - Zawiera.
value string Wartość znacznika problemu.