Tworzenie pozycji

Przegląd

Aby utworzyć pozycję w frontend Zabbix, wykonaj następujące czynności:

  1. Przejdź do Data collection > Hosts.
  2. Kliknij Items w wierszu host.
  3. Kliknij Create item w prawym górnym rogu ekranu.
  4. Wprowadź parametry pozycji w formularzu.

Alternatywnie możesz utworzyć pozycję, otwierając istniejącą pozycję, klikając przycisk Clone i zapisując ją pod inną nazwą.

Konfiguracja

Karta Pozycja zawiera ogólne atrybuty pozycji.

Wszystkie wymagane pola wejściowe są oznaczone czerwoną gwiazdką.

Parametr Opis
Nazwa Nazwa pozycji.
Obsługiwane są makra użytkownika.
Typ Typ pozycji. Zobacz poszczególne sekcje dotyczące typów pozycji.
Klucz Klucz pozycji (do 2048 znaków).
Obsługiwane klucze pozycji można znaleźć w poszczególnych sekcjach dotyczących typów pozycji.
Klucz musi być unikalny w obrębie pojedynczego hosta.
Jeśli typ klucza to „Zabbix agent”, „Zabbix agent (active)” lub „Simple check”, wartość klucza musi być obsługiwana przez Zabbix agent lub Zabbix server.
Zobacz także: prawidłowy format klucza.
Typ informacji Typ danych używany do sprawdzania wartości pozycji i przechowywania jej w bazie danych, również po wykonaniu dowolnych konwersji:
Liczbowe (bez znaku) - 64-bitowa liczba całkowita bez znaku;
Liczbowe (zmiennoprzecinkowe) - 64-bitowa liczba zmiennoprzecinkowa;
Znakowe - krótki tekst;
Dziennik - długi tekst z właściwościami dziennika lub bez nich (znacznik czasu, źródło, ważność, identyfikator zdarzenia dziennika);
Tekstowe - długi tekst;
Binarne - liczba binarna (obsługiwana tylko dla pozycji zależnych);
JSON - strukturyzowane dane JSON, przechowywane natywnie w bazie danych (nieobsługiwane dla pozycji obliczanych).
Pozycje zwracające wartości typu binarnego lub JSON nie są obsługiwane w formułach pozycji obliczanych ani wyrażeniach wyzwalaczy.
Limity przechowywania dla poszczególnych typów danych i backendów baz danych opisano w sekcji Limity danych pozycji.
W przypadku pozycji zwracających dane w jednym określonym formacie odpowiedni typ danych jest wybierany automatycznie — na przykład system.cpu.load i system.cpu.util zwracają 64-bitową liczbę zmiennoprzecinkową, dlatego automatycznie wybierany jest typ Liczbowe (zmiennoprzecinkowe).
Interfejs hosta Wybierz interfejs hosta. To pole jest dostępne podczas edycji pozycji na poziomie hosta.
Jednostki Jeśli ustawiono symbol jednostki, Zabbix stosuje przetwarzanie końcowe do odebranej wartości pozycji i wyświetla ją z określonym przyrostkiem jednostki.
Obsługiwane symbole jednostek ze specjalnym formatowaniem (oraz przykłady: odebrana wartość → wyświetlana wartość):
B - bajty (1024 → 1 KB)
Bps - bajty na sekundę (1024 → 1 KBps)
s - sekundy, wyświetlane przy użyciu maksymalnie trzech największych niezerowych jednostek czasu (881764 → 10d 4h 56m)
uptime - czas działania w formacie hh:mm:ss lub N dni, hh:mm:ss (881764 → 10 days, 04:56:04)
unixtime - znacznik czasu Unix, formatowany jako yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); aby formatowanie było prawidłowe, odebrana wartość pozycji musi mieć typ Liczbowe (bez znaku).
W przypadku innych jednostek (takich jak Hz, W itd.), jeśli odebrana wartość przekracza 1000, jest dzielona przez 1000 i wyświetlana z odpowiednim przedrostkiem (5000 → 5 KHz, 881764 → 881.76 KW).
Jeśli przed symbolem jednostki znajduje się !, konwersja jednostki i dodawanie przedrostka są wyłączone (1024 !B → 1024 B, 61 !s → 61 s).
Więcej przykładów i informacji o symbolach jednostek oraz konwersji jednostek zawiera sekcja Przyrostki wartości pozycji.
Interwał aktualizacji Pobieraj nową wartość tej pozycji co N sekund. Maksymalny dozwolony interwał aktualizacji wynosi 86400 sekund (1 dzień).
Obsługiwane są przyrostki czasu, np. 30s, 1m, 2h, 1d.
Obsługiwane są makra użytkownika.
Pojedyncze makro musi wypełniać całe pole. Wiele makr w jednym polu ani makra połączone z tekstem nie są obsługiwane.
Uwaga: Interwał aktualizacji można ustawić na „0” tylko wtedy, gdy istnieją niestandardowe interwały z wartością różną od zera. Jeśli ustawiono „0” i istnieje niestandardowy interwał (elastyczny lub zaplanowany) z wartością różną od zera, odpytywanie pozycji będzie odbywać się przez czas trwania niestandardowego interwału.
Uwaga: pierwsze odpytywanie pozycji po jej aktywowaniu lub po zmianie interwału aktualizacji może nastąpić wcześniej niż wynika to ze skonfigurowanej wartości.
Nowe pozycje zostaną sprawdzone w ciągu 60 sekund od ich utworzenia, chyba że mają zaplanowany lub elastyczny interwał aktualizacji, a Interwał aktualizacji jest ustawiony na 0.
Istniejącą pasywną pozycję można natychmiast odpytać o wartość, klikając przycisk Wykonaj teraz button.
Niestandardowe interwały Możesz utworzyć niestandardowe reguły sprawdzania pozycji:
Elastyczny - utworzenie wyjątku dla Interwału aktualizacji (interwał z inną częstotliwością).
Planowanie - utworzenie niestandardowego harmonogramu odpytywania.
Szczegółowe informacje zawiera sekcja Niestandardowe interwały.
W polu Interwał obsługiwane są przyrostki czasu, np. 30s, 1m, 2h, 1d.
Obsługiwane są makra użytkownika.
Pojedyncze makro musi wypełniać całe pole. Wiele makr w jednym polu ani makra połączone z tekstem nie są obsługiwane.
Limit czasu Ustaw limit czasu sprawdzania pozycji (dostępny dla obsługiwanych typów pozycji). Wybierz opcję limitu czasu:
Globalny - używany jest globalny limit czasu serwera proxy (wyświetlany w wyszarzonym polu Limit czasu).
Zastąpienie - używany jest niestandardowy limit czasu (ustawiany w polu Limit czasu; dozwolony zakres: 1 - 600s). Obsługiwane są przyrostki czasu, np. 30s, 1m, oraz makra użytkownika.
Kliknięcie łącza Limity czasu umożliwia skonfigurowanie limitów czasu proxy lub globalnych (jeśli proxy nie jest używany). Łącze Limity czasu jest widoczne tylko dla użytkowników typu Super admin z uprawnieniami do sekcji frontend Administracja > Ogólne lub Administracja > Proxy.
Historia Wybierz jedną z opcji:
Nie przechowuj - historia pozycji nie jest przechowywana. Przydatne w przypadku pozycji głównych, jeśli tylko pozycje zależne muszą zachowywać historię.
To ustawienie nie może zostać zastąpione przez globalne ustawienia housekeepera.
Przechowuj przez - określ czas przechowywania szczegółowej historii w bazie danych (od 1 godziny do 25 lat). Starsze dane zostaną usunięte przez housekeepera. Wartość jest przechowywana w sekundach.
Obsługiwane są przyrostki czasu, np. 2h, 1d. Obsługiwane są makra użytkownika.
Wartość Przechowuj przez można globalnie zastąpić w sekcji Administracja > Housekeeping.
Jeśli istnieje globalne ustawienie zastępujące, wyświetlana jest pomarańczowa ikona informacji . Po umieszczeniu na niej wskaźnika myszy wyświetlany jest komunikat ostrzegawczy, np. Zastąpione przez globalne ustawienia housekeepera (1d).
Zaleca się przechowywanie zarejestrowanych wartości przez możliwie najkrótszy czas, aby zmniejszyć rozmiar historii wartości w bazie danych. Zamiast przechowywać długą historię wartości, można przechowywać dane trendów przez dłuższy czas.
Zobacz także Historia i trendy.
Trendy Wybierz jedną z opcji:
Nie przechowuj - trendy nie są przechowywane.
To ustawienie nie może zostać zastąpione przez globalne ustawienia housekeepera.
Przechowuj przez - określ czas przechowywania zagregowanej historii (godzinowe wartości min, maks., średnia, liczba) w bazie danych (od 1 dnia do 25 lat). Starsze dane zostaną usunięte przez housekeepera. Wartość jest przechowywana w sekundach.
Obsługiwane są przyrostki czasu, np. 24h, 1d. Obsługiwane są makra użytkownika.
Wartość Przechowuj przez można globalnie zastąpić w sekcji Administracja > Housekeeping.
Jeśli istnieje globalne ustawienie zastępujące, wyświetlana jest pomarańczowa ikona informacji . Po umieszczeniu na niej wskaźnika myszy wyświetlany jest komunikat ostrzegawczy, np. Zastąpione przez globalne ustawienia housekeepera (7d).
Uwaga: Przechowywanie trendów nie jest dostępne dla danych nieliczbowych - znakowych, dziennika i tekstowych.
Zobacz także Historia i trendy.
Mapowanie wartości Zastosuj mapowanie wartości do tej pozycji. Mapowanie wartości nie zmienia odebranych wartości, służy wyłącznie do wyświetlania danych.
Działa z pozycjami typu Liczbowe (bez znaku), Liczbowe (zmiennoprzecinkowe) i Znakowe.
Na przykład „Stany usług Windows”.
Format czasu dziennika Dostępne tylko dla pozycji typu Dziennik. Obsługiwane symbole zastępcze:
y: Rok (1970-2038).
M: Miesiąc (01-12).
d: Dzień (01-31).
h: Godzina (00-23).
m: Minuta (00-59).
s: Sekunda (00-59).
Jeśli pole pozostanie puste, znacznik czasu zostanie ustawiony na 0 w czasie Unix, co oznacza 1 stycznia 1970 r.
Rozważmy na przykład następujący wiersz z pliku dziennika Zabbix agent:
„ 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211).”
Rozpoczyna się on sześcioma pozycjami znaków zawierającymi PID, po których następują data, czas i pozostała część komunikatu.
Format czasu dziennika dla tego wiersza to „pppppp:yyyyMMdd:hhmmss”.
Należy pamiętać, że znaki „p” i „:” są symbolami zastępczymi i mogą być dowolnymi znakami z wyjątkiem „yMdhms”.
Wypełnia pole inwentaryzacji hosta Możesz wybrać pole inwentaryzacji hosta, które będzie wypełniane wartością pozycji. Będzie to działać, jeśli dla hosta włączono automatyczne wypełnianie inwentaryzacji oraz w przypadku pozycji typu Liczbowe (bez znaku), Liczbowe (zmiennoprzecinkowe), Znakowe i Tekstowe.
Opis Wprowadź opis pozycji. Obsługiwane są makra użytkownika.
Włączona Zaznacz pole wyboru, aby włączyć pozycję i umożliwić jej przetwarzanie.
Po wyłączeniu pozycji jest ona natychmiast usuwana z pamięci podręcznej historii (z wyjątkiem jej ostatniej wartości, która jest zachowywana dla dzienników).
Najnowsze dane Kliknij łącze, aby wyświetlić najnowsze dane pozycji.
To łącze jest dostępne tylko podczas edycji już istniejącej pozycji.

Pola specyficzne dla typów pozycji opisano na odpowiednich stronach.

Podczas edycji istniejącej pozycji na poziomie szablonu na poziomie hosta niektóre pola są tylko do odczytu. Możesz użyć łącza w nagłówku formularza, przejść na poziom szablonu i edytować je tam, pamiętając, że zmiany na poziomie szablonu zmienią pozycję dla wszystkich hostów, z którymi szablon jest połączony.

Karta Znaczniki umożliwia zdefiniowanie znaczników na poziomie pozycji.

Wstępne przetwarzanie wartości pozycji

Karta Wstępne przetwarzanie umożliwia zdefiniowanie reguł transformacji dla odebranych wartości.

Testowanie pozycji

Aby przeprowadzić testowanie pozycji, upewnij się, że czas systemowy na serwerze i proxy jest zsynchronizowany. Jeśli czas serwera jest opóźniony, testowanie pozycji może zwrócić komunikat o błędzie „The task has been expired.” Ustawienie różnych stref czasowych na serwerze i proxy nie wpłynie jednak na wynik testu.

Możliwe jest przetestowanie pozycji i, jeśli została poprawnie skonfigurowana, uzyskanie w zamian rzeczywistej wartości. Testowanie może odbyć się nawet przed zapisaniem pozycji.

Testowanie jest dostępne dla pozycji, prototypów pozycji, reguł niskopoziomowego wykrywania oraz prototypów wykrywania, zarówno na hostach, jak i w szablonach.

Testowanie pozycji jest dostępne dla następujących pasywnych typów pozycji:

  • Zabbix agent
  • SNMP agent (v1, v2, v3)
  • IPMI agent (tylko na poziomie hosta)
  • Kontrole SSH
  • Kontrole Telnet
  • JMX agent
  • Proste kontrole (z wyjątkiem pozycji icmpping*, vmware.*)
  • Wewnętrzne pozycje Zabbix
  • Pozycje obliczane
  • Kontrole zewnętrzne
  • Monitor bazy danych
  • HTTP agent
  • Skrypt
  • Przeglądarka
  • Zapytanie telemetryczne

Aby przetestować pozycję, kliknij przycisk Test u dołu formularza konfiguracji pozycji. Pamiętaj, że przycisk Test jest wyłączony dla typów pozycji niewymienionych powyżej (np. Zabbix agent (aktywny), Zabbix trapper, pozycja zależna). Jest również wyłączony dla wykluczonych prostych kontroli oraz dla pozycji IPMI agent na poziomie szablonu.

Formularz testowania pozycji zawiera pola wymaganych parametrów hosta (adres hosta, port, testowanie za pomocą serwera/proxy (nazwa proxy)) oraz szczegóły specyficzne dla pozycji (takie jak społeczność SNMPv2 lub dane uwierzytelniające bezpieczeństwa SNMPv3). Pola te uwzględniają kontekst:

  • Wartości są wstępnie wypełniane, gdy jest to możliwe, np. dla pozycji wymagających agenta informacje są pobierane z wybranego interfejsu agenta hosta.
  • Wartości dla pozycji szablonu należy wprowadzić ręcznie.
  • Wartości makr w postaci zwykłego tekstu są rozwijane.
  • Pola, w których wartość (lub jej część) jest sekretem albo makrem Vault, są puste i należy je wypełnić ręcznie. Jeśli dowolny parametr pozycji zawiera wartość makra sekretu, wyświetlany jest następujący komunikat ostrzegawczy: „Item contains user-defined macros with secret values. Values of these macros should be entered manually.”
  • Pola są wyłączone, gdy nie są potrzebne w kontekście typu pozycji (np. pola adresu hosta i proxy są wyłączone dla pozycji obliczanych).

Aby przetestować pozycję, kliknij Get value. Jeśli wartość zostanie pomyślnie pobrana, wypełni ona pole Value, przenosząc bieżącą wartość (jeśli istnieje) do pola Previous value i jednocześnie obliczając pole Prev. time, czyli różnicę czasu między dwiema wartościami (kliknięciami), oraz próbując wykryć sekwencję EOL i przełączyć się na CRLF po wykryciu "\n\r" w pobranej wartości.

Kliknij Get value and test, aby przetestować wstępne przetwarzanie.

Wartości pobrane z hosta i wyniki testów są obcinane do maksymalnego rozmiaru 512 KB podczas wysyłania do frontend. Jeśli wynik testu został obcięty, wyświetlana jest ikona ostrzeżenia; najedź na nią kursorem, aby wyświetlić szczegóły. Jeśli wartość została obcięta, może nie przejść walidacji typu danych w kolejnych testach porównujących duże wartości (np. JSON); w takich przypadkach wyświetlany jest komunikat o błędzie. Pamiętaj, że dane większe niż 512 KB są nadal w całości przetwarzane przez serwer Zabbix.

Jeśli konfiguracja jest nieprawidłowa, wyświetlany jest komunikat o błędzie opisujący możliwą przyczynę.

Pomyślnie pobraną wartość z hosta można również wykorzystać do przetestowania kroków wstępnego przetwarzania.

Przyciski formularza

Przyciski u dołu formularza umożliwiają wykonanie kilku operacji.

Dodaj pozycję. Ten przycisk jest dostępny tylko dla nowych pozycji.
Zaktualizuj właściwości pozycji.
Utwórz kolejną pozycję na podstawie właściwości bieżącej pozycji.
Natychmiast wykonaj sprawdzenie nowej wartości pozycji. Obsługiwane tylko w przypadku sprawdzeń pasywnych (zobacz więcej szczegółów).
Uwaga: podczas natychmiastowego sprawdzania wartości pamięć podręczna konfiguracji nie jest aktualizowana, dlatego wartość nie będzie odzwierciedlać najnowszych zmian w konfiguracji pozycji.
Sprawdź, czy konfiguracja pozycji jest prawidłowa, pobierając wartość.
Usuń historię i trendy pozycji.
Usuń pozycję.
Anuluj edycję właściwości pozycji.

Limity danych pozycji

Limity danych pozycji zależą od typu danych pozycji oraz backendu bazy danych.

Wartości numeryczne (bez znaku) są przechowywane bez zmian. Jeśli zostanie odebrana wartość zmiennoprzecinkowa, zapisywana jest tylko część całkowita (np. 1.23 → 1).

Wartości numeryczne (float) są przechowywane bez zmian i obsługują około 15 do 17 cyfr precyzji, w zakresie około -1.79E+308 do 1.79E+308. Obsługiwane są również wartości w notacji naukowej (np. 1.23E+7, 1e308, 1.1E-4).

Wartości tekstowe są obcinane przed zapisaniem, aby odpowiadały limitowi typu wartości w bazie danych:

Database Type of information
Character Log Text
MySQL 255 characters 65536 bytes 65536 bytes
PostgreSQL 255 characters 65536 characters 65536 characters
SQLite (only Zabbix proxy) 255 characters 65536 characters 65536 characters

Wartości binarne są ograniczone do 16 MiB (16777216 bajtów). Wartości przekraczające ten limit są odrzucane, a odpowiedni błąd jest wyświetlany we frontendzie.

Wartości typu JSON są ograniczone do 128 MiB (134217728 bajtów). Wartości przekraczające ten limit są odrzucane, a odpowiedni błąd jest wyświetlany we frontendzie. W przypadku MySQL/MariaDB warto rozważyć skonfigurowanie dziennych partycji dla tabeli history_json (używanej do przechowywania wartości JSON), ponieważ może ona szybko się rozrastać i blokować housekeeper na dłuższy czas. Jeśli Twój przypadek użycia obejmuje duże wartości JSON (1 MiB lub więcej), zobacz, jak skonfigurować system pod kątem obsługi dużych wartości JSON.

Gdy Zabbix zapisuje dowolne dane pozycji do bazy danych, używa zapytań INSERT i rejestruje je (jeśli DebugLevel ma ustawioną wartość 4 lub 5). Duże wpisy dziennika są obcinane do 64 KB.

Limit skryptu niestandardowego

Dostępna długość skryptu niestandardowego zależy od używanej bazy danych:

Baza danych Limit znaków Limit bajtów
MySQL 65535 65535
PostgreSQL 65535 bez ograniczeń
SQLite (tylko Zabbix proxy) 65535 bez ograniczeń

Limit czasu pozycji

Limit czasu pozycji określa, jak długo Zabbix powinien czekać przed przerwaniem sprawdzania i uznaniem go za nieudane.

Po osiągnięciu limitu czasu sprawdzanie zostaje przerwane, nawet jeśli pobieranie danych nie zostało zakończone. Jeśli dane zostaną odebrane częściowo, pozycja otrzymuje status nieobsługiwana, a w dzienniku zapisywany jest komunikat o błędzie (na przykład gdy dane zostaną pomyślnie zebrane tylko dla jednego z wielu OID w sprawdzaniu SNMP).

W przypadku wielu typów pozycji można ustawić elastyczne limity czasu pozycji:

  • dla pojedynczej pozycji
  • dla typu pozycji (na poziomie proxy)
  • dla typu pozycji (na poziomie globalnym)

Niestandardowy limit czasu dla pojedynczej pozycji jest przydatny, jeśli chcesz określić dłuższy limit czasu dla konkretnej pozycji, zachowując krótkie limity czasu dla pozostałych pozycji.

Priorytet limitów czasu

  1. Limit czasu pojedynczej pozycji zastępuje wszystkie inne limity czasu.
  2. Limity czasu na poziomie proxy zastępują limity globalne.

Limit czasu określony w konfiguracji serwera Zabbix lub proxy nie ma wpływu na sprawdzanie, dla którego ustawiono elastyczne limity czasu.

Obsługa elastycznego limitu czasu

Elastyczne limity czasu dla pozycji są obsługiwane dla następujących typów pozycji:

  • Zabbix agent (zarówno dla kontroli pasywnych, jak i aktywnych)
  • SNMP agent (z wyjątkiem starszych kontroli SNMP1)
  • Simple check (z wyjątkiem icmpping* i pozycji VMware2)
  • SSH agent
  • Telnet agent
  • External check
  • Database monitor
  • Script
  • HTTP agent
  • Browser

    1 W przypadku starszych kontroli SNMP (odpytywanie pojedynczego OID) obowiązują ustawienia limitu czasu z konfiguracji serwer lub proxy.
    2 Dla pozycji icmpping* wartość limitu czasu jest określana bezpośrednio w kluczu pozycji; obowiązuje również zakodowany na stałe maksymalny możliwy limit czasu wynoszący 600 sekund. Pozycje monitorowania VMware używają własnego parametru VMwareTimeout z konfiguracji serwer lub proxy.

Nieobsługiwane pozycje

Nieobsługiwane pozycje są zgłaszane ze statusem Nieobsługiwane i nadal są ponownie sprawdzane zgodnie z ich standardowym Interwałem aktualizacji.

Pozycja staje się nieobsługiwana, jeśli z jakiegoś powodu nie można pobrać jej wartości (np. błąd połączenia, brak skonfigurowanych pollerów do przetwarzania pozycji). Dodatkowo pozycje, które nie otrzymują danych historycznych, pozostają w statusie Nieobsługiwane. Jest to oczekiwane zachowanie — pozycja przechodzi do statusu Normalny dopiero wtedy, gdy otrzyma nowe, prawidłowe dane historyczne.

Podobnie jak problemy, nieobsługiwane pozycje są ponownie oceniane tylko wtedy, gdy nadejdą nowe dane — nawet jeśli dla danej pozycji nie są już dostępne żadne dane historyczne. Innymi słowy, pozycje i wyzwalacze zmieniają swój stan wyłącznie po otrzymaniu nowych danych. Jednak jeśli wyrażenie wyzwalacza zawiera funkcję date and time i/lub nodata(), wyzwalacz będzie przeliczany co 30 sekund (szczegóły znajdują się w czasie obliczania wyzwalaczy).