1 Tworzenie pozycji

Przegląd

Aby utworzyć pozycję w interfejsie Zabbix, wykonaj następujące kroki:

  • Przejdź do: KonfiguracjaHosty
  • Kliknij na Pozycje w wierszu hosta
  • Kliknij na Utwórz pozycję w prawym górnym rogu ekranu
  • Wprowadź parametry pozycji w formularzu

Możesz również utworzyć pozycję, otwierając istniejącą, naciskając przycisk Powiel, a następnie zapisując pod inną nazwą.

Konfiguracja

Zakładka Pozycja zawiera ogólne atrybuty pozycji.

Wszystkie obowiązkowe pola wejściowe są oznaczone czerwoną gwiazdką.

Parametr Opis
Nazwa Nazwa pozycji.
Typ Typ pozycji. Zobacz poszczególne sekcje typu pozycji.
Klucz Klucz pozycji (do 2048 znaków).
Obsługiwane klucze pozycji można znaleźć w poszczególnych sekcjach typów pozycji.
Klucz musi być unikalny w obrębie jednego hosta.
Jeśli typ klucza to 'Agent Zabbix', 'Agent Zabbix (aktywny)' lub 'Proste sprawdzenie', wartość klucza musi być obsługiwana przez agenta Zabbix lub serwer Zabbix.
Zobacz także: prawidłowy format klucza.
Typ informacji Typ danych przechowywanych w bazie danych po wykonaniu konwersji, jeśli jest taka potrzeba.
Liczba (całkowita bez znaku) - liczba całkowita 64-bitowa bez znaku
Liczba (zmiennoprzecinkowa) - liczba zmiennoprzecinkowa 64-bitowa
Ten typ pozwoli na precyzję około 15 cyfr i zakres od około -1.79E+308 do 1.79E+308 (z wyjątkiem PostgreSQL 11 i starszych wersji).
Odbieranie wartości w notacji naukowej jest również obsługiwane. Na przykład, 1.23E+7, 1e308, 1.1E-4.
Znak - krótkie teksty
Log - długie teksty z opcjonalnymi właściwościami dziennika (znacznik czasu, źródło, poziom, id zdarzenia dziennika)
Tekst - długie teksty. Zobacz także limity danych tekstowych.
Dla kluczy pozycji, które zwracają dane tylko w jednym określonym formacie, automatycznie wybierany jest pasujący typ informacji.
Interfejs hosta Wybierz interfejs hosta. To pole jest dostępne podczas edycji pozycji na poziomie hosta.
Jednostki Jeśli ustawiony jest symbol jednostki, Zabbix doda przetwarzanie końcowe do otrzymanej wartości i wyświetli ją z ustawionym sufiksem jednostki.
Domyślnie, jeśli otrzymana wartość przekracza 1000, jest ona dzielona przez 1000 i odpowiednio wyświetlana. Na przykład, jeśli ustawisz bps i otrzymasz wartość 881764, zostanie wyświetlona jako 881.76 Kbps.
Standard pamięci JEDEC jest używany do przetwarzania jednostek B (bajt), Bps (bajty na sekundę), które są dzielone przez 1024. Dlatego, jeśli jednostki są ustawione na B lub Bps, Zabbix wyświetli:
1 jako 1B/1Bps
1024 jako 1KB/1KBps
1536 jako 1.5KB/1.5KBps
Specjalne przetwarzanie jest używane, jeśli używane są następujące jednostki związane z czasem:
unixtime - przetłumaczony na "yyyy.mm.dd hh:mm:ss". Aby przetłumaczyć poprawnie, otrzymana wartość musi być typu Liczba (całkowita bez znaku).
uptime - przetłumaczony na "hh:mm:ss" lub "N dni, hh:mm:ss"
Na przykład, jeśli otrzymasz wartość jako 881764 (sekundy), zostanie wyświetlona jako "10 dni, 04:56:04"
s - przetłumaczony na "yyy mmm ddd hhh mmm sss ms"; parametr jest traktowany jako liczba sekund.
Na przykład, jeśli otrzymasz wartość jako 881764 (sekundy), zostanie wyświetlona jako "10d 4g 56m"
Wyświetlane są tylko 3 górne jednostki główne, jak "1m 15d 5g" lub "2g 4m 46s". Jeśli nie ma dni do wyświetlenia, wyświetlane są tylko dwie warstwy - "1m 5g" (nie pokazują minuty, sekundy ani milisekundy). Zostanie przetłumaczony na "< 1 ms", jeśli wartość jest mniejsza niż 0.001.
Uwaga, jeśli jednostka jest poprzedzona !, wówczas nie są stosowane prefiksy jednostek/przetwarzanie dla wartości pozycji. Zobacz konwersję jednostek.
Interwał aktualizacji Pobierz nową wartość dla tej pozycji co N sekund. Maksymalny dozwolony interwał aktualizacji wynosi 86400 sekund (1 dzień).
Są obsługiwane przyrostki czasu, np. 30s, 1m, 2g, 1d.
Obsługiwane są makra użytkownika.
Jedno makro musi wypełniać całe pole. Wiele makr w polu lub makra mieszane z tekstem nie są obsługiwane.
Uwaga: Interwał aktualizacji może być ustawiony na '0' tylko wtedy, gdy istnieją niestandardowe interwały o wartości różnej od zera. Jeśli ustawiony jest na '0', a istnieje okres użytkownika (elastyczny lub Harmonogramowanie) o wartości różnej od zera, pozycja będzie sprawdzana podczas trwania niestandardowego interwału.
Uwaga: Pierwsze sprawdzenie pozycji po jej aktywacji lub po zmianie interwału aktualizacji może wystąpić wcześniej niż skonfigurowana wartość.
Istniejąca pasywna pozycja może być natychmiast sprawdzana pod kątem wartości przez naciśnięcie przycisku Wykonaj teraz.
Okresy użytkownika Możesz tworzyć niestandardowe reguły dla sprawdzania pozycji:
Elastyczny - tworzenie wyjątku dla Interwału aktualizacji (interwał o innej częstotliwości)
Harmonogramowanie - tworzenie niestandardowego harmonogramu sprawdzania.
Aby uzyskać szczegółowe informacje, zobacz Okresy użytkownika.
Są obsługiwane przyrostki czasu w polu Interwał, np. 30s, 1m, 2g, 1d.
Obsługiwane są makra użytkownika.
Jedno makro musi wypełniać całe pole. Wiele makr w polu lub makra mieszane z tekstem nie są obsługiwane.
Harmonogramowanie jest obsługiwane od Zabbix 3.0.0.
Uwaga: niestandardowe interwały dla aktywnych sprawdzeń są obsługiwane tylko przez agenta Zabbix 2.
Historia Wybierz jedną z opcji:
Nie przechowuj historii - historia pozycji nie jest przechowywana. Przydatne dla pozycji głównych, jeśli tylko pozycje zależne muszą przechowywać historię.
To ustawienie nie może być zastąpione przez globalne ustawienia porządkowania.
Okres przechowywania - określ czas przechowywania szczegółowej historii w bazie danych (od 1 godziny do 25 lat). Starsze dane będą usuwane przez porządkowanie. Przechowywane w sekundach.
Są obsługiwane przyrostki czasu, np. 2g, 1d. Makra użytkownika są obsługiwane.
Wartość Okresu przechowywania może być nadpisana globalnie w Administracja → Ogólne → Porządkowanie.
Jeśli istnieje globalne ustawienie nadpisujące, wyświetlana jest zielona ikona informacji. Jeśli najedziesz na nią kursorem, wyświetli się komunikat ostrzegawczy, np. Nadpisane przez globalne ustawienia porządkowania (1d).
Zaleca się przechowywanie zapisanych wartości przez jak najkrótszy czas, aby zmniejszyć rozmiar historii wartości w bazie danych. Zamiast przechowywać długą historię wartości, można przechowywać dłużej dane trendów.
Zobacz także Historia i trendy.
Okres przechowywania trendów Wybierz jedną z opcji:
Nie przechowuj trendów - trendy nie są przechowywane.
To ustawienie nie może być zastąpione przez globalne ustawienia porządkowania.
Okres przechowywania - określ czas przechowywania skumulowanej historii (godzinny minimum, maksimum, średnia, ilość) w bazie danych (od 1 dnia do 25 lat). Starsze dane będą usuwane przez porządkowanie. Przechowywane w sekundach.
Są obsługiwane przyrostki czasu, np. 24g, 1d. Makra użytkownika są obsługiwane.
Wartość Okresu przechowywania może być nadpisana globalnie w Administracja → Ogólne → Porządkowanie.
Jeśli istnieje globalne ustawienie nadpisujące, wyświetlana jest zielona ikona informacji. Jeśli najedziesz na nią kursorem, wyświetli się komunikat ostrzegawczy, np. Nadpisane przez globalne ustawienia porządkowania (7d).
Uwaga: Przechowywanie trendów nie jest dostępne dla danych nie-liczbowych - znak, log i tekst.
Zobacz także Historia i trendy.
Mapowanie wartości Zastosuj mapowanie wartości do tej pozycji. Mapowanie wartości nie zmienia otrzymywanych wartości, służy tylko do wyświetlania danych.
Działa z pozycjami Liczba (całkowita bez znaku), Liczba (zmiennoprzecinkowa) oraz Znak.
Np. "Stany usług systemu Windows".
Format czasu dla logowania Dostępny tylko dla pozycji typu Log. 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 jest puste, znacznik czasowy nie będzie parsowany.
Np. rozważmy następującą linię z pliku dziennika agenta Zabbix:
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
Zaczyna się od sześciu pozycji znakowych dla PID, a następnie daty, czasu i reszty linii.
Format czasu dziennika dla tej linii to "pppppp:yyyyMMdd:hhmmss".
Zauważ, że znaki "p" i ":" to tylko symbole zastępcze i mogą być czymkolwiek innym niż "yMdhms".
Powielaj pola inwentarza hosta Możesz wybrać pole inwentarza hosta, które zostanie wypełnione wartością pozycji. To zadziała, jeśli inwentaryzacja automatyczne jest włączona dla hosta.
To pole nie jest dostępne, jeśli Typ informacji jest ustawiony na 'Log'.
Opis Wprowadź opis pozycji. Obsługiwane są makra użytkownika.
Włączony Zaznacz pole wyboru, aby włączyć pozycję, dzięki czemu zostanie przetwarzana.
Najnowsze dane Kliknij na link, aby zobaczyć najnowsze dane dotyczące pozycji.
Ten link jest dostępny tylko podczas edycji już istniejącej pozycji.

Specyficzne dla typu pozycji pola opisane są na odpowiadających stronach.

Podczas edycji istniejącej pozycji z szablonu na poziomie hosta, wiele pól jest tylko do odczytu. Możesz użyć linku w nagłówku formularza i przejść do poziomu szablonu, aby edytować je tam, pamiętając, że zmiany na poziomie szablonu zmienią pozycję dla wszystkich hostów, do których szablon jest podłączony.

Zakładka Znaczniki pozwala zdefiniować tagi na poziomie pozycji.

Przetwarzanie wstępne wartości pozycji

Zakładka Przetwarzanie wstępne pozwala zdefiniować reguły transformacji dla otrzymywanych wartości.

Testowanie

Aby przeprowadzić test pozycji, upewnij się, że czas systemowy na serwerze i w proxy jest zsynchronizowany. W przypadku gdy czas na serwerze jest opóźniony, testowanie pozycji może zwrócić komunikat o błędzie "Zadanie wygasło". Ustawienie różnych stref czasowych na serwerze i w proxy nie wpłynie jednak na wynik testu.

Możliwe jest przetestowanie pozycji i, jeśli skonfigurowano ją poprawnie, otrzymanie rzeczywistej wartości. Testowanie może nastąpić nawet przed zapisaniem pozycji.

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

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

  • Agent Zabbix
  • Agent SNMP (v1, v2, v3)
  • Agent IPMI
  • Agent SSH
  • Agent Telnet
  • Agent JMX
  • Proste sprawdzenie (za wyjątkiem pozycji icmpping*, vmware.*)
  • Wewnętrzny Zabbix
  • Obliczona
  • Test zewnętrzny
  • Monitor bazy danych
  • Agent HTTP
  • Skrypt

Aby przetestować pozycję, kliknij przycisk Testuj na dole formularza konfiguracji pozycji. Zauważ, że przycisk Testuj będzie wyłączony dla pozycji, które nie mogą być testowane (takich jak sprawdzenia aktywne, wyłączone proste sprawdzenia).

Formularz testowania pozycji ma pola dla wymaganych parametrów hosta (adres hosta, port, nazwa proxy/brak proxy) oraz szczegóły specyficzne dla pozycji (takie jak hałso SNMPv2 lub poświadczenia bezpieczeństwa SNMPv3). Te pola mają znajomość kontekstu:

  • Wartości są wstępnie wypełniane, jeśli to możliwe, tj. dla pozycji wymagających agenta, poprzez pobranie informacji z wybranej interfejsu agenta hosta
  • Wartości muszą być wprowadzone ręcznie dla pozycji szablonów
  • Wartości makr w formie zwykłego tekstu są rozwiązywane
  • Pola, w których wartość (lub część wartości) jest tajna lub jako sekret Vault, są puste i muszą być wprowadzone ręcznie. Jeśli którykolwiek parametr pozycji zawiera wartość makra tajnego, wyświetlany jest następujący komunikat ostrzegawczy: "Pozycja zawiera makra użytkownika z sekretnymi wartościami. Wartości takich makr powinny być wpisywane ręcznie."
  • 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 Pobierz wartość. Jeśli wartość zostanie pomyślnie pobrana, wypełni pole Wartość, przenosząc bieżącą wartość (jeśli istnieje) do pola Poprzednia wartość, obliczając jednocześnie pole Czas poprzedni, tj. różnicę czasu między dwoma wartościami (kliknięciami), a także próbując wykryć sekwencję EOL i przełączyć na CRLF w przypadku wykrycia " \ n \ r" w pobranej wartości.

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

Pomyślnie pobrana wartość z hosta może również być użyta do przetestowania kroków przetwarzania wstępnego.

Przyciski formularza

Przyciski na dole formularza pozwalają na wykonanie kilku operacji.

Dodaj pozycję. Ten przycisk jest dostępny tylko dla nowych pozycji.
Aktualizuj właściwości pozycji.
Utwórz inną pozycję na podstawie właściwości bieżącej pozycji.
Wykonaj natychmiastowe sprawdzenie nowej wartości pozycji. Obsługiwane tylko dla pasywnych sprawdzeń (zobacz więcej szczegółów).
Uwaga: Podczas natychmiastowego sprawdzania wartości, pamięć podręczna konfiguracji nie jest aktualizowana, więc wartość nie będzie odzwierciedlać bardzo niedawnych zmian w konfiguracji pozycji.
Przetestuj, czy konfiguracja pozycji jest poprawna, pobierając wartość.
Usuń historię i trendy pozycji.
Usuń pozycję.
Anuluj edycję właściwości pozycji.

Ograniczenia danych tekstowych

Ograniczenia danych tekstowych zależą od backendu bazy danych. Przed zapisaniem wartości tekstowych do bazy danych są one ucięte, aby dopasować się do limitu typu wartości bazy danych:

Baza danych Rodzaj informacji
Znak Log Tekst
MySQL 255 znaków 65536 bajtów 65536 bajtów
PostgreSQL 255 znaków 65536 znaków 65536 znaków
Oracle 255 znaków 65536 znaków 65536 znaków
SQLite
(tylko Zabbix proxy)
255 znaków 65536 znaków 65536 znaków

Konwersja jednostek

Domyślnie określenie jednostki dla pozycji skutkuje dodaniem prefiksu mnożnika - na przykład wartość wejściowa '2048' z jednostką 'B' zostanie wyświetlona jako '2KB'.

Aby zapobiec konwersji jednostki, użyj prefiksu !, na przykład !B. Aby lepiej zrozumieć, jak działa konwersja z i bez znaku wykrzyknika, zobacz poniższe przykłady wartości i jednostek:

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

Przed wersją Zabbix 4.0 istniała zakodowana na stałe lista jednostek, składająca się z ms, rpm, RPM, %. Ta lista jednostek została uznana za przestarzałą, dlatego prawidłowy sposób zapobiegania konwersji takich jednostek to !ms, !rpm, !RPM, !%.

Limit własnych skryptów

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

Baza danych Limit w znakach Limit w bajtach
MySQL 65535 65535
Oracle Database 2048 4000
PostgreSQL 65535 nieograniczony
SQLite (tylko proxy Zabbix) 65535 nieograniczony

Pozycje nieobsługiwane

Pozycja może stać się nieobsługiwana, jeśli jej wartość nie może być pobrana z jakiegoś powodu. Takie pozycje są wciąż ponownie sprawdzane w ich standardowym Interwale aktualizacji.

Nieobsługiwane pozycje są raportowane jako mające stan NIEOBSŁUGIWANY.