Documentation
Table of Contents
> Item object
Poniższe obiekty są bezpośrednio powiązane z interfejsem API item.
Item
Pozycje scenariuszy WWW nie mogą być bezpośrednio tworzone, aktualizowane ani usuwane za pomocą API Zabbix.
Obiekt item ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| itemid | string | (tylko do odczytu) ID pozycji. |
| delay (wymagane) |
string | Interwał aktualizacji pozycji. Akceptuje sekundy lub jednostkę czasu z sufiksem (30s,1m,2h,1d). Opcjonalnie można podać jedną lub więcej okresów użytkownika zarówno jako interwały elastyczne, jak i harmonogramowe. Wiele interwałów jest oddzielanych średnikiem. Można używać makr użytkownika. Jedno makro musi wypełnić całe pole. Wiele makr w jednym polu nie są obsługiwane ani makra łączone z tekstem. Elastyczne interwały mogą być zapisane jako dwa makra oddzielone ukośnikiem (np. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Opcjonalne dla zdarzeń trapper Zabbix, pozycji zależnych i dla agenta Zabbix (aktywnego) z kluczem mqtt.get. |
| hostid (wymagane) |
string | ID hosta lub szablonu, do którego należy pozycja. Dla operacji aktualizacji to pole jest tylko do odczytu. |
| interfaceid (wymagane) |
string | ID interfejsu hosta pozycji. Używane tylko dla pozycji hosta. Nie jest wymagane dla agenta Zabbix (aktywnego), wewnętrznego Zabbix, trapper Zabbix, obliczeń, zależnych, monitora bazy danych i pozycji skryptowych. Opcjonalne dla pozycji agenta HTTP. |
| key_ (wymagane) |
string | Klucz pozycji. |
| name (wymagane) |
string | Nazwa pozycji. |
| type (wymagane) |
integer | Typ pozycji. Możliwe wartości: 0 - agent Zabbix; 2 - trapper Zabbix; 3 - proste sprawdzenie; 5 - wewnętrzne Zabbix; 7 - agent Zabbix (aktywny); 9 - pozycja scenariusza WWW; 10 - Test zewnętrzny; 11 - monitor bazy danych; 12 - agent IPMI; 13 - agent SSH; 14 - agent Telnet; 15 - obliczona; 16 - agent JMX; 17 - pułapka SNMP; 18 - pozycja zależna; 19 - agent HTTP; 20 - agent SNMP; 21 - skrypt |
| url (wymagane) |
string | Ciąg URL, wymagany tylko dla typu pozycji agenta HTTP. Obsługuje makra użytkownika, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}. |
| value_type (wymagane) |
integer | Typ informacji pozycji. Możliwe wartości: 0 - liczba zmiennoprzecinkowa; 1 - znak; 2 - log; 3 - liczba całkowita bez znaku; 4 - tekst. |
| allow_traps | integer | Pole pozycji agenta HTTP. Pozwala na wypełnienie wartości jak w przypadku typu pozycji trapper. 0 - (domyślne) Nie zezwalaj na przyjmowanie przychodzących danych. 1 - Zezwalaj na przyjmowanie przychodzących danych. |
| authtype | integer | Używane tylko przez pozycje agenta SSH lub agenta HTTP. Możliwe wartości metody uwierzytelniania agenta SSH: 0 - (domyślne) hasło; 1 - klucz publiczny. Możliwe wartości metody uwierzytelniania agenta HTTP: 0 - (domyślne) brak 1 - podstawowy 2 - NTLM 3 - Kerberos |
| description | string | Opis pozycji. |
| error | string | (tylko do odczytu) Tekst błędu, jeśli występują problemy z aktualizacją wartości pozycji. |
| flags | integer | (tylko do odczytu) Pochodzenie pozycji. Możliwe wartości: 0 - pozycja standardowa; 4 - pozycja wykryta. |
| follow_redirects | integer | Pole pozycji agenta HTTP. Podążaj za przekierowaniami odpowiedzi podczas pobierania danych. 0 - Nie podążaj za przekierowaniami. 1 - (domyślne) podążaj za przekierowaniami. |
| headers | object | Pole pozycji agenta HTTP. Obiekt z nagłówkami żądania HTTP(S), gdzie nazwa nagłówka jest używana jako klucz, a wartość nagłówka jako wartość. Przykład: { "User-Agent": "Zabbix" } |
| history | string | Jednostka czasu, jak długo dane historyczne powinny być przechowywane. Akceptuje również makra użytkownika. Domyślnie: 90d. |
| http_proxy | string | Pole pozycji agenta HTTP. Ciąg połączenia z serwerem proxy HTTP(S). |
| inventory_link | integer | ID pola inwentaryzacji hosta, które jest wypełniane przez pozycję. Sprawdź stronę inwentaryzacji hosta w celu uzyskania listy obsługiwanych pól inwentaryzacji hosta i ich identyfikatorów. Domyślnie: 0. |
| ipmi_sensor | string | Czujnik IPMI. Używane tylko przez pozycje IPMI. |
| jmx_endpoint | string | Niestandardowy ciąg połączenia agenta JMX. Wartość domyślna: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi |
| lastclock | timestamp | (tylko do odczytu) Czas ostatniej aktualizacji wartości pozycji. Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz rozszerzyć ten okres czasu, zmieniając wartość parametru Maksymalny okres wyświetlania historii w sekcji menu Administracja → Ogólne. |
| lastns | integer | (tylko do odczytu) Nanosekundy czasu ostatniej aktualizacji wartości pozycji. Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz rozszerzyć ten okres czasu, zmieniając wartość parametru Maksymalny okres wyświetlania historii w sekcji menu Administracja → Ogólne. |
| lastvalue | string | (tylko do odczytu) Ostatnia wartość pozycji. Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz rozszerzyć ten okres czasu, zmieniając wartość parametru Maksymalny okres wyświetlania historii w sekcji menu Administracja → Ogólne. |
| logtimefmt | string | Format czasu w wpisach dziennika. Używane tylko przez pozycje typu log. |
| master_itemid | integer | ID głównej pozycji. Rekursja do 3 pozycji zależnych i maksymalna liczba pozycji zależnych równa 29999 jest dozwolona. Wymagane przez pozycje zależne. |
| output_format | integer | Pole pozycji agenta HTTP. Czy odpowiedź powinna być przekonwertowana do JSON. 0 - (domyślne) Przechowuj niezmienione. 1 - Konwertuj na JSON. |
| params | string | Dodatkowe parametry zależne od typu pozycji: - skrypt wykonywany dla pozycji SSH i Telnet; - zapytanie SQL dla pozycji monitora bazy danych; - formuła dla pozycji obliczanych; - skrypt dla pozycji skryptowych. |
| parameters | array | Dodatkowe parametry dla pozycji skryptowych. Tablica obiektów z właściwościami 'name' i 'value', gdzie nazwa musi być unikatowa. |
| password | string | Hasło do uwierzytelniania. Używane przez proste sprawdzenie, SSH, Telnet, monitor bazy danych, JMX i pozycje agenta HTTP. Podczas używania przez JMX, nazwa użytkownika powinna być również określona wraz z hasłem lub obie właściwości powinny być pozostawione puste. |
| post_type | integer | Pole pozycji agenta HTTP. Typ żądanych danych wysyłanych w żądaniach. 0 - (domyślne) Dane nieprzetworzone. 2 - Dane JSON. 3 - Dane XML. |
| posts | string | Pole pozycji agenta HTTP. Dane treści żądania HTTP(S). Używane z post_type. |
| prevvalue | string | (tylko do odczytu) Poprzednia wartość pozycji. Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz rozszerzyć ten okres czasu, zmieniając wartość parametru Maksymalny okres wyświetlania historii w sekcji menu Administracja → Ogólne. |
| privatekey | string | Nazwa pliku klucza prywatnego. |
| publickey | string | Nazwa pliku klucza publicznego. |
| query_fields | array | Pole pozycji agenta HTTP. Parametry zapytania. Tablica obiektów z parami 'klucz':'wartość', gdzie wartość może być pustym ciągiem. |
| request_method | integer | Pole pozycji agenta HTTP. Typ metody żądania. 0 - (domyślne) GET 1 - POST 2 - PUT 3 - HEAD |
| retrieve_mode | integer | Pole pozycji agenta HTTP. Która część odpowiedzi powinna być przechowywana. 0 - (domyślne) Treść. 1 - Nagłówki. 2 - Zarówno treść, jak i nagłówki będą przechowywane. Dla metody żądania HEAD dozwolona jest tylko wartość 1. |
| snmp_oid | string | OID SNMP. |
| ssl_cert_file | string | Pole pozycji agenta HTTP. Ścieżka pliku klucza certyfikatu publicznego SSL. |
| ssl_key_file | string | Pole pozycji agenta HTTP. Ścieżka pliku klucza prywatnego SSL. |
| ssl_key_password | string | Pole pozycji agenta HTTP. Hasło do pliku klucza SSL. |
| state | integer | (tylko do odczytu) Stan pozycji. Możliwe wartości: 0 - (domyślne) normalny; 1 - nieobsługiwany. |
| status | integer | Status pozycji. Możliwe wartości: 0 - (domyślne) pozycja włączona; 1 - pozycja wyłączona. |
| status_codes | string | Pole pozycji agenta HTTP. Zakresy wymaganych kodów stanu HTTP oddzielone przecinkami. Obsługuje również makra użytkownika jako część listy oddzielonej przecinkami. Przykład: 200,200-{$M},{$M},200-400 |
| templateid | string | (tylko do odczytu) ID nadrzędnego szablonu pozycji. Wskazówka: Użyj właściwości hostid, aby określić szablon, do którego należy pozycja. |
| timeout | string | Czas oczekiwania na żądanie danych pozycji. Używane dla pozycji agenta HTTP i pozycji skryptowych. Obsługuje makra użytkownika. domyślnie: 3s maksymalna wartość: 60s |
| trapper_hosts | string | Dozwolone hosty. Używane przez pozycje typu trapper lub pozycje agenta HTTP. |
| trends | string | Jednostka czasu, jak długo dane trendów powinny być przechowywane. Akceptuje również makra użytkownika. Domyślnie: 365d. |
| units | string | Jednostki wartości. |
| username | string | Nazwa użytkownika do uwierzytelniania. Używane przez proste sprawdzenie, SSH, Telnet, monitor bazy danych, JMX i pozycje agenta HTTP. Wymagane przez pozycje SSH i Telnet. Podczas używania przez JMX, hasło również powinno być określone razem z nazwą użytkownika lub obie właściwości powinny być pozostawione puste. |
| uuid | string | Uniwersalny unikalny identyfikator używany do łączenia zaimportowanej pozycji z już istniejącymi. Używane tylko dla pozycji w szablonach. Automatycznie generowane, jeśli nie jest podane. |
| valuemapid | string | ID powiązanej mapy wartości. |
| verify_host | integer | Pole pozycji agenta HTTP. Czy sprawdzić, czy nazwa hosta dla połączenia odpowiada tej zawartej w certyfikacie hosta. 0 - (domyślne) Nie sprawdzaj. 1 - Sprawdź. |
| verify_peer | integer | Pole pozycji agenta HTTP. Czy sprawdzić, czy certyfikat hosta jest autentyczny. 0 - (domyślne) Nie sprawdzaj. 1 - Sprawdź. |
Zauważ, że dla niektórych metod (aktualizacja, usuwanie) kombinacja wymaganych/opcjonalnych parametrów jest różna.
Item tag
Obiekt item tag ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| tag (wymagane) |
string | Nazwa znacznika pozycji. |
| value | string | Wartość znacznika pozycji. |
Item preprocessing
Obiekt item preprocessing pozycji ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| type (wymagane) |
integer | Typ opcji przetwarzania wstępnego. Możliwe wartości: 1 - Własny mnożnik; 2 - Przytnij z prawej; 3 - Przytnij z lewej; 4 - Przytnij; 5 - Wyrażenie regularne; 6 - Boolowski na dziesiętny; 7 - Ósemkowy na dziesiętny; 8 - Szesnastkowy na dziesiętny; 9 - Prosta zmiana; 10 - Zmiana na sekundę; 11 - XML XPath; 12 - Ścieżka JSONPath; 13 - W przedziale; 14 - Pasuje wyrażenie regularne; 15 - Brak dopasowania wyrażenia regularnego; 16 - Sprawdź błąd w JSON; 17 - Sprawdź błąd w XML; 18 - Sprawdź błąd przy użyciu wyrażenia regularnego; 19 - Odrzuć niezmienione; 20 - Odrzuć niezmienione z heartbeat; 21 - JavaScript; 22 - Wzorzec Prometheus; 23 - Prometheus na JSON; 24 - CSV na JSON; 25 - Zastąp; 26 - Sprawdź wartości nieobsługiwane; 27 - XML na JSON. |
| params (wymagane) |
string | Dodatkowe parametry używane przez opcję przetwarzania wstępnego. Wiele parametrów jest oddzielonych znakiem nowej linii (LF \n). |
| error_handler (wymagane) |
integer | Typ działania używany w przypadku niepowodzenia kroku przetwarzania wstępnego. Możliwe wartości: 0 - Komunikat o błędzie jest ustawiany przez serwer Zabbix; 1 - Odrzuć wartość; 2 - Ustaw niestandardową wartość; 3 - Ustaw niestandardowy komunikat o błędzie. |
| error_handler_params (wymagane) |
string | Parametry obsługi błędów. Używane z error_handler.Musi być puste, jeśli error_handler ma wartość 0 lub 1.Może być puste, jeśli error_handler ma wartość 2.Nie może być puste, jeśli error_handler ma wartość 3. |
Dla każdego typu przetwarzania wstępnego są obsługiwane następujące parametry i obsługi błędów.
| Typ przetwarzania wstępnego | Nazwa | Parametr 1 | Parametr 2 | Parametr 3 | Obsługiwane obsługi błędów |
|---|---|---|---|---|---|
| 1 | Własny mnożnik | liczba1, 6 | 0, 1, 2, 3 | ||
| 2 | Przytnij z prawej | lista znaków2 | |||
| 3 | Przytnij z lewej | lista znaków2 | |||
| 4 | Przytnij | lista znaków2 | |||
| 5 | Wyrażenie regularne | wzorzec3 | wyjście2 | 0, 1, 2, 3 | |
| 6 | Boolowski na dziesiętny | 0, 1, 2, 3 | |||
| 7 | Ósemkowy na dziesiętny | 0, 1, 2, 3 | |||
| 8 | Szesnastkowy na dziesiętny | 0, 1, 2, 3 | |||
| 9 | Prosta zmiana | 0, 1, 2, 3 | |||
| 10 | Zmiana na sekundę | 0, 1, 2, 3 | |||
| 11 | XPath XML | ścieżka4 | 0, 1, 2, 3 | ||
| 12 | JSONPath | ścieżka4 | 0, 1, 2, 3 | ||
| 13 | W przedziale | min1, 6 | maks1, 6 | 0, 1, 2, 3 | |
| 14 | Pasuje wyrażenie regularne | wzorzec3 | 0, 1, 2, 3 | ||
| 15 | Brak dopasowania wyrażenia regularnego | wzorzec3 | 0, 1, 2, 3 | ||
| 16 | Sprawdź błąd w JSON | ścieżka4 | 0, 1, 2, 3 | ||
| 17 | Sprawdź błąd w XML | ścieżka4 | 0, 1, 2, 3 | ||
| 18 | Sprawdź błąd za pomocą wyrażenia regularnego | wzorzec3 | wyjście2 | 0, 1, 2, 3 | |
| 19 | Odrzuć niezmienione | ||||
| 20 | Odrzuć niezmienione z heartbeat | sekundy5, 6 | |||
| 21 | JavaScript | skrypt2 | |||
| 22 | Wzorzec Prometheus | wzorzec6, 7 | value, label, function |
wyjście8, 9 | 0, 1, 2, 3 |
| 23 | Prometheus do JSON | wzorzec6, 7 | 0, 1, 2, 3 | ||
| 24 | CSV do JSON | znak2 | znak2 | 0,1 | 0, 1, 2, 3 |
| 25 | Zastąp | ciąg wyszukiwania2 | zastąpienie2 | ||
| 26 | Sprawdź wartości nieobsługiwane | 1, 2, 3 | |||
| 27 | XML do JSON | 0, 1, 2, 3 | |||
1 liczba całkowita bez znaku lub zmiennoprzecinkowa
2 ciąg znaków
3 wyrażenie regularne
4 JSONPath lub XPath XML
5 dodatnia liczba całkowita (z obsługą przyrostków czasu, np. 30s, 1m, 2h, 1d)
6 makro użytkownika
7 Wzorzec Prometheus zgodnie ze składnią: <nazwa metryki>{<nazwa etykiety>="<wartość etykiety>", ...} == <wartość>. Każda składowa wzorca Prometheus (metryka, nazwa etykiety, wartość etykiety i wartość metryki) może być makrem użytkownika.
8 Wyjście Prometheus zgodnie ze składnią: <nazwa etykiety> (może być makrem użytkownika), jeśli jako drugi parametr jest wybrana opcja label.
9 Jedna z funkcji agregujących: sum, min, max, avg, count, jeśli jako drugi parametr jest wybrana opcja function.