1 Tworzenie pozycji

Przegląd

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

  • Przejdź do: Data collection > Hosts
  • Kliknij Items w wierszu hosta
  • Kliknij Create item w prawym górnym rogu ekranu
  • Wprowadź parametry pozycji w formularzu

Możesz również utworzyć pozycję, otwierając istniejącą, klikając przycisk Clone, a następnie 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ć unikatowy 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 serwer Zabbix.
Zobacz także: prawidłowy format klucza.
Typ informacji Typ danych przechowywanych w bazie danych po wykonaniu konwersji, jeśli jest wymagana.
Liczbowe (bez znaku) - 64-bitowa liczba całkowita bez znaku.
Należy pamiętać, że wartość zmiennoprzecinkowa odebrana dla pozycji całkowitej zostanie pozbawiona części dziesiętnej.
Liczbowe (zmiennoprzecinkowe) - 64-bitowa liczba zmiennoprzecinkowa.
Ten typ zapewnia precyzję około 15 cyfr oraz zakres od około -1.79E+308 do 1.79E+308 (z wyjątkiem PostgreSQL 11 i wcześniejszych wersji).
Obsługiwane jest także odbieranie wartości w notacji naukowej, np. 1.23E+7, 1e308, 1.1E-4.
Znakowe - krótkie dane tekstowe.
Dziennik - długie dane tekstowe z opcjonalnymi właściwościami związanymi z dziennikiem (znacznik czasu, źródło, ważność, logeventid).
Tekstowe - długie dane tekstowe. Zobacz także ograniczenia danych tekstowych.
Binarne - liczba binarna (obsługiwana tylko dla pozycji zależnych).
Pozycje zwracające wartości binarne nie są obsługiwane w formułach pozycji obliczanych ani w wyrażeniach wyzwalaczy.
Dla kluczy pozycji zwracających dane tylko w jednym określonym formacie odpowiedni typ informacji jest wybierany automatycznie.
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 z użyciem maksymalnie trzech największych niezerowych jednostek czasu (881764 → 10d 4h 56m)
uptime - czas działania w formacie hh:mm:ss lub N days, 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).
Dla 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 symbol jednostki jest poprzedzony znakiem !, konwersja jednostek i dodawanie przedrostków są wyłączone (1024 !B → 1024 B, 61 !s → 61 s).
Więcej przykładów i informacji o symbolach jednostek oraz ich konwersji można znaleźć w sekcji 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 polu ani makra połączone z tekstem nie są obsługiwane.
Uwaga: Interwał aktualizacji można ustawić na „0” tylko wtedy, gdy istnieją interwały niestandardowe 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ć, naciskając przycisk Wykonaj teraz.
Interwały niestandardowe Możesz utworzyć niestandardowe reguły sprawdzania pozycji:
Elastyczny - utworzenie wyjątku dla Interwału aktualizacji (interwału o innej częstotliwości).
Planowanie - utworzenie niestandardowego harmonogramu odpytywania.
Szczegółowe informacje można znaleźć w sekcji Interwały niestandardowe.
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 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 lub proxy (wyświetlany w wyszarzonym polu Limit czasu).
Nadpisanie - używany jest niestandardowy limit czasu (ustawiony 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żywane). Łą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 historię muszą zachowywać tylko pozycje zależne.
To ustawienie nie może zostać nadpisane 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 nadpisać w sekcji Administracja > Housekeeping.
Jeśli istnieje globalne ustawienie nadpisujące, wyświetlana jest pomarańczowa ikona informacji . Po umieszczeniu na niej wskaźnika myszy zostanie wyświetlony komunikat ostrzegawczy, np. Nadpisane 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ć nadpisane przez globalne ustawienia housekeepera.
Przechowuj przez - określ czas przechowywania zagregowanej historii (minimalna, maksymalna i średnia wartość godzinowa oraz 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 nadpisać w sekcji Administracja > Housekeeping.
Jeśli istnieje globalne ustawienie nadpisujące, wyświetlana jest pomarańczowa ikona informacji . Po umieszczeniu na niej wskaźnika myszy zostanie wyświetlony komunikat ostrzegawczy, np. Nadpisane 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.
Przykładem jest „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 roku.
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)."
Wiersz zaczyna się od sześciu pozycji znakowych zawierających 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 inwentarza hosta Możesz wybrać pole inwentarza hosta, które zostanie wypełnione wartością pozycji. Będzie to działać, jeśli dla hosta włączono automatyczne wypełnianie inwentarza.
To pole nie jest dostępne, jeśli Typ informacji ustawiono na „Dziennik”.
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 dla 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 z poziomu 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. W przypadku gdy 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ływa jednak na wynik testu.

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

Testowanie jest dostępne dla pozycji hosta i szablonu, prototypów pozycji oraz reguł niskopoziomowego wykrywania. Testowanie nie jest dostępne dla aktywnych pozycji.

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

  • Zabbix agent
  • SNMP agent (v1, v2, v3)
  • IPMI agent
  • SSH checks
  • Telnet checks
  • JMX agent
  • Simple checks (except icmpping*, vmware.* items)
  • Zabbix internal
  • Calculated items
  • External checks
  • Database monitor
  • HTTP agent
  • Script
  • Browser

Aby przetestować pozycję, kliknij przycisk Test u dołu formularza konfiguracji pozycji. Należy pamiętać, że przycisk Test będzie wyłączony dla pozycji, których nie można testować (takich jak aktywne sprawdzenia, wykluczone proste sprawdzenia).

Formularz testowania pozycji zawiera pola wymaganych parametrów hosta (adres hosta, port, test z serwerem/proxy (nazwa proxy)) oraz szczegóły specyficzne dla pozycji (takie jak community SNMPv2 lub dane uwierzytelniające bezpieczeństwa SNMPv3). Pola te są zależne od kontekstu:

  • Wartości są wstępnie wypełniane, gdy to możliwe, tj. dla pozycji wymagających agenta, na podstawie informacji z wybranego interfejsu agenta hosta.
  • Wartości muszą zostać wprowadzone ręcznie dla pozycji szablonu.
  • 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 muszą zostać wprowadzone ręcznie. Jeśli dowolny parametr pozycji zawiera wartość makra sekretnego, 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. pole adresu hosta i pole proxy są wyłączone dla pozycji obliczanych)

Aby przetestować pozycję, kliknij Get value. Jeśli wartość zostanie pobrana pomyślnie, zostanie wpisana do pola Value, a bieżąca wartość (jeśli istnieje) zostanie przeniesiona do pola Previous value, przy jednoczesnym obliczeniu pola Prev. time, tj. różnicy czasu między dwiema wartościami (kliknięciami), oraz próbie wykrycia sekwencji EOL i przełączenia na CRLF, jeśli w pobranej wartości zostanie wykryte "\n\r".

Kliknij Get value and test, aby przetestować preprocessing.

Wartości pobrane z hosta oraz wyniki testów są przycinane do maksymalnego rozmiaru 512 KB podczas wysyłania do frontend. Jeśli wynik zostanie przycięty, wyświetlana jest ikona ostrzeżenia. Opis ostrzeżenia jest wyświetlany po najechaniu myszą. Należy pamiętać, że dane większe niż 512 KB są nadal w pełni przetwarzane przez serwer Zabbix.

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

Pomyślnie pobrana wartość z hosta może być również użyta do testowania kroków preprocessing.

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 informacji).
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 tekstowych

Limity danych tekstowych zależą od backendu bazy danych. Przed zapisaniem wartości tekstowych w bazie danych są one przycinane, aby odpowiadały limitowi typu wartości w bazie danych:

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

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 jako nieudanego.

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 staje się niewspierana, a w dzienniku zostaje zapisany komunikat o błędzie (na przykład, jeśli dane zostały pomyślnie pobrane tylko dla jednego z wielu OID-ów 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 jednocześnie niskie limity czasu dla innych pozycji.

Priorytet limitów czasu

  1. Limit czasu pojedynczej pozycji ma pierwszeństwo przed innymi limitami czasu.
  2. Limity czasu na poziomie proxy mają pierwszeństwo przed globalnymi limitami czasu.

Limit czasu z konfiguracji Zabbix serwer lub proxy nie ma żadnego znaczenia w przypadku sprawdzeń, dla których ustawiono elastyczne limity czasu.

Obsługa elastycznego limitu czasu

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

Niewspierane pozycje

Niewspierane pozycje są zgłaszane ze statusem Not supported i nadal są ponownie sprawdzane zgodnie ze standardowym Update interval.

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

Podobnie jak problemy, niewspierane pozycje są ponownie oceniane tylko wtedy, gdy zostaną odebrane 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. Jeśli jednak wyrażenie wyzwalacza zawiera funkcję date and time i/lub nodata(), wyzwalacz będzie przeliczany co 30 sekund (szczegóły: triggers calculation time).