Testowanie przetwarzania wstępnego
Testowanie
Testowanie kroków przetwarzania wstępnego jest przydatne, aby upewnić się, że złożone potoki przetwarzania wstępnego dają oczekiwane wyniki, bez czekania na odebranie i przetworzenie wartości pozycja.
Możliwe jest testowanie:
- względem hipotetycznej wartości
- względem rzeczywistej wartości z hosta
Każdy krok przetwarzania wstępnego można testować osobno, a także wszystkie kroki można testować razem. Po kliknięciu przycisku Test lub Test all steps odpowiednio w bloku Actions zostanie otwarte okno testowania.
Testowanie hipotetycznej wartości
| Parameter | Description |
|---|---|
| Pobierz wartość z host | Jeśli chcesz przetestować hipotetyczną wartość, pozostaw to pole wyboru niezaznaczone. Zobacz też: Testowanie rzeczywistej wartości. |
| Wartość | Wprowadź wartość wejściową do testu. Kliknięcie w pole parametru lub przycisk podglądu/edycji  spowoduje otwarcie okna obszaru tekstowego do wprowadzania wartości lub bloku kodu. |
| Nieobsługiwane | Zaznacz to pole wyboru, aby przetestować nieobsługiwaną wartość. Ta opcja jest przydatna do testowania kroku przetwarzania wstępnego Sprawdź wartość nieobsługiwaną. |
| Błąd | Wprowadź tekst błędu. To pole jest aktywne, gdy Pobierz wartość z host jest odznaczone, ale Nieobsługiwane jest zaznaczone. Jeśli Pobierz wartość z host jest zaznaczone, to pole zostanie wypełnione rzeczywistym komunikatem błędu (tylko do odczytu) z host. |
| Czas | Wyświetlany jest czas wartości wejściowej: now (tylko do odczytu). |
| Poprzednia wartość | Wprowadź poprzednią wartość wejściową do porównania. Tylko dla kroków przetwarzania wstępnego Change i Throttling. |
| Poprzedni czas | Wprowadź czas poprzedniej wartości wejściowej do porównania. Tylko dla kroków przetwarzania wstępnego Change i Throttling. Wartość domyślna jest oparta na polu 'Update interval' pozycji (jeśli '1m', to to pole zostanie wypełnione now-1m). Jeśli nic nie zostanie określone lub użytkownik nie ma dostępu do host, domyślna wartość to now-30s. |
| Makra | Jeśli używane są jakiekolwiek makra, są one wyświetlane wraz z ich wartościami. Wartości można edytować na potrzeby testu, ale zmiany zostaną zapisane tylko w kontekście testowania. |
| Sekwencja końca linii | Wybierz sekwencję końca linii dla wielowierszowych wartości wejściowych: LF - sekwencja LF (line feed) CRLF - sekwencja CRLF (carriage-return line-feed). |
| Kroki przetwarzania wstępnego | Wyświetlane są kroki przetwarzania wstępnego; wynik testu jest pokazywany dla każdego kroku po kliknięciu przycisku Test. Wyniki testu są obcinane do maksymalnego rozmiaru 512KB podczas wysyłania do frontend. Wyniki testu można kopiować (nie więcej niż obcięte 512KB). Jeśli wynik został obcię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ż 512KB są nadal w pełni przetwarzane przez serwer Zabbix. Jeśli krok zakończył się niepowodzeniem podczas testu, wyświetlana jest ikona błędu. Opis błędu jest wyświetlany po najechaniu myszą. W przypadku gdy dla kroku określono "Custom on fail" i ta akcja zostanie wykonana, bezpośrednio po wierszu kroku testu przetwarzania wstępnego pojawia się nowy wiersz pokazujący, jaka akcja została wykonana i jaki wynik wygenerowała (błąd lub wartość). |
| Wynik | Końcowy wynik testowania kroków przetwarzania wstępnego jest wyświetlany we wszystkich przypadkach, gdy wszystkie kroki są testowane razem (po kliknięciu przycisku Test all steps). Wyświetlany jest również typ konwersji do typu wartości pozycji, na przykład Result converted to Numeric (unsigned).Wyniki testu są obcinane do maksymalnego rozmiaru 512KB podczas wysyłania do frontend. Końcowy wynik można kopiować (nie więcej niż obcięte 512KB). Jeśli wynik został obcię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ż 512KB są nadal w pełni przetwarzane przez serwer Zabbix. |
Kliknij Test, aby zobaczyć wynik po każdym kroku przetwarzania wstępnego.
Wartości testowe są przechowywane między sesjami testowymi dla poszczególnych kroków lub wszystkich kroków, co pozwala użytkownikowi zmieniać kroki przetwarzania wstępnego lub konfigurację pozycji, a następnie wrócić do okna testowania bez konieczności ponownego wprowadzania informacji. Wartości są jednak tracone po odświeżeniu strony.
Testowanie jest wykonywane przez serwer Zabbix. frontend wysyła odpowiednie żądanie do serwera i czeka na wynik. Żądanie zawiera wartość wejściową i kroki przetwarzania wstępnego (z rozwiniętymi makrami użytkownika). Dla kroków Change i Throttling można określić opcjonalną poprzednią wartość i czas. Serwer zwraca wyniki dla każdego kroku przetwarzania wstępnego.
Wszystkie błędy techniczne lub błędy walidacji danych wejściowych są wyświetlane w polu błędu u góry okna testowania.
Testowanie rzeczywistej wartości
Aby przetestować preprocessing na rzeczywistej wartości:
- Zaznacz pole wyboru Pobierz wartość z hosta
- Wprowadź lub sprawdź parametry hosta (adres hosta, port, nazwę proxy/brak
proxy) oraz szczegóły specyficzne dla pozycji (takie jak community SNMPv2 lub
dane uwierzytelniające SNMPv3). Te pola uwzględniają kontekst:
- Wartości są wstępnie wypełniane, gdy jest to możliwe, tj. w przypadku pozycji wymagających agenta informacje są pobierane z wybranego interfejsu agenta hosta
- Wartości pozycji szablonu należy wprowadzić ręcznie
- Wartości makr w postaci zwykłego tekstu są rozwiązywane
- Jeśli wartość pola (lub jej część) jest sekretem lub makrem Vault, pole będzie 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: „Pozycja zawiera makra zdefiniowane przez użytkownika z wartościami sekretów. Wartości tych makr należy wprowadzić ręcznie.”
- 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)
- Kliknij Pobierz wartość i przetestuj, aby przetestować preprocessing
Jeśli w formularzu konfiguracji pozycji określono mapowanie wartości (pole Pokaż wartość), okno dialogowe testu pozycji wyświetli po wyniku końcowym dodatkowy wiersz o nazwie Wynik z zastosowaną mapą wartości.
Parametry specyficzne dla pobierania rzeczywistej wartości z hosta:
| Parametr | Opis |
|---|---|
| Pobierz wartość z hosta | Zaznacz to pole wyboru, aby pobrać rzeczywistą wartość z hosta. |
| Adres hosta | Wprowadź adres hosta. To pole jest automatycznie wypełniane adresem interfejsu hosta pozycji. |
| Port | Wprowadź port hosta. To pole jest automatycznie wypełniane portem interfejsu hosta pozycji. |
| Dodatkowe pola dla interfejsów SNMP (wersja SNMP, community SNMP, nazwa kontekstu itp.) |
Więcej informacji na temat konfigurowania interfejsu SNMP (v1, v2 i v3) zawiera sekcja Konfigurowanie monitorowania SNMP. Te pola są automatycznie wypełniane na podstawie interfejsu hosta pozycji. |
| Proxy | Określ proxy, jeśli host jest monitorowany przez proxy. To pole jest automatycznie wypełniane proxy hosta (jeśli istnieje). |
| Wartość | Wartość pobrana z hosta. Kliknięcie pola parametru lub przycisku wyświetlania/edycji otworzy okno obszaru tekstowego z wartością lub blokiem kodu.Wartości są skracane do maksymalnego rozmiaru 512 KB wyłącznie w frontendzie. Jeśli wynik zostanie skrócony, wyświetlana jest ikona ostrzeżenia. Opis ostrzeżenia jest wyświetlany po najechaniu kursorem myszy. Należy pamiętać, że dane większe niż 512 KB nadal są w całości przetwarzane przez serwer Zabbix. |
Pozostałe parametry opisano powyżej w sekcji Testowanie hipotetycznej wartości.