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.

Property Type Description
serviceid ID ID usługi.

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

Możliwe wartości:
0 - ustaw stan 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 stanu.

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

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

Możliwe wartości, jeśli propagation_rule jest ustawione na "0" lub "3":
0 - Nie sklasyfikowano.

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 - Nie sklasyfikowano;
1 - Informacja;
2 - Ostrzeżenie;
3 - Średni;
4 - Wysoki;
5 - Katastrofa.

Zachowanie właściwości:
- wymagane jeśli ustawiono propagation_rule
status integer Czy usługa ma stan OK, czy stan problemu.

Jeśli usługa ma stan problemu, status jest równy albo ważności najbardziej krytycznego problemu, albo najwyższemu statusowi usługi podrzędnej w stanie problemu.

Jeśli usługa ma stan OK, status ma wartość -1.

Zachowanie właściwości:
- tylko do odczytu
description string Opis usługi.
uuid string Uniwersalny unikalny identyfikator, używany do powiązania importowanych usług z już istniejącymi. Generowany automatycznie, jeśli nie zostanie podany.
created_at integer Znacznik czasu Unix, kiedy usługa została utworzona.
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 pośrednictwem interfejsu API Zabbix.

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

Property Type Description
clock timestamp Czas, w którym nastąpiła zmiana stanu usługi.
value integer Status usługi.

Zapoznaj się z właściwością status usługi, aby uzyskać listę możliwych wartości.

Znacznik problemu

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

Property Type Description
tag string Nazwa znacznika problemu.

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

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