1 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 konieczności czekania na odebranie i wstępne przetworzenie wartości pozycji.
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ć indywidualnie, a także można testować wszystkie kroki razem. Po kliknięciu odpowiednio przycisku Test lub Test all steps w bloku Actions otwierane jest okno testowania.
Testowanie wartości hipotetycznej
| Parametr | Opis |
|---|---|
| Pobierz wartość z hosta | Jeśli chcesz przetestować wartość hipotetyczną, pozostaw to pole wyboru niezaznaczone. Zobacz także: Testowanie wartości rzeczywistej. |
| Wartość | Wprowadź wartość wejściową do przetestowania. Kliknięcie w polu parametru lub przycisku podglądu/edycji  otworzy okno obszaru tekstowego do wprowadzenia wartości lub bloku kodu. |
| Nieobsługiwane | Zaznacz to pole wyboru, aby przetestować nieobsługiwaną wartość. Ta opcja jest przydatna do testowania kroku wstępnego przetwarzania Sprawdź pod kątem nieobsługiwanej wartości. |
| Błąd | Wprowadź tekst błędu. To pole jest włączone, gdy opcja Pobierz wartość z hosta jest odznaczona, a opcja Nieobsługiwane jest zaznaczona. Jeśli opcja Pobierz wartość z hosta jest zaznaczona, to pole zostanie wypełnione rzeczywistym komunikatem błędu (tylko do odczytu) z hosta. |
| 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 wstępnego przetwarzania Zmiana i Ograniczanie. |
| Poprzedni czas | Wprowadź czas poprzedniej wartości wejściowej do porównania. Tylko dla kroków wstępnego przetwarzania Zmiana i Ograniczanie. Wartość domyślna jest oparta na wartości pola „Interwał aktualizacji” pozycji (jeśli „1m”, to to pole zostanie wypełnione wartością now-1m). Jeśli nic nie określono lub użytkownik nie ma dostępu do hosta, wartością domyślną jest now-30s. |
| Makra | Jeśli używane są jakiekolwiek makra, są one wyświetlane wraz z ich wartościami. Wartości można edytować do celów testowych, 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 wstępnego przetwarzania | Wyświetlane są kroki wstępnego przetwarzania; wynik testu jest wyświetlany 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 zostanie obcięty, wyświetlana jest ikona ostrzeżenia. Opis ostrzeżenia jest wyświetlany po najechaniu kursorem. 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 testowania, wyświetlana jest ikona błędu. Opis błędu jest wyświetlany po najechaniu kursorem. Jeśli dla kroku określono „Custom on fail” i to działanie zostało wykonane, bezpośrednio po wierszu kroku testu wstępnego przetwarzania pojawi się nowy wiersz pokazujący, jakie działanie zostało wykonane i jaki wynik zostało uzyskany (błąd lub wartość). |
| Wynik | Końcowy wynik testowania kroków wstępnego przetwarzania jest wyświetlany we wszystkich przypadkach, gdy wszystkie kroki są testowane razem (po kliknięciu przycisku Test all steps). Wyświetlany jest także 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 zostanie obcięty, wyświetlana jest ikona ostrzeżenia. Opis ostrzeżenia jest wyświetlany po najechaniu kursorem. 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 wstępnego przetwarzania.
Wartości testowe są przechowywane między sesjami testowymi zarówno dla poszczególnych kroków, jak i dla wszystkich kroków, co pozwala użytkownikowi zmieniać kroki wstępnego przetwarzania 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 oczekuje na wynik. Żądanie zawiera wartość wejściową i kroki wstępnego przetwarzania (z rozwiniętymi makrami użytkownika). Dla kroków Zmiana i Ograniczanie można opcjonalnie określić poprzednią wartość i czas. Serwer odpowiada wynikami dla każdego kroku wstępnego przetwarzania.
Wszystkie błędy techniczne lub błędy walidacji danych wejściowych są wyświetlane w polu błędów u góry okna testowania.
Testowanie rzeczywistej wartości
Aby przetestować przetwarzanie wstępne względem rzeczywistej wartości:
- Zaznacz pole wyboru Get value from host
- Wprowadź lub zweryfikuj parametry hosta (adres hosta, port, nazwa proxy/brak proxy) oraz szczegóły specyficzne dla pozycji (takie jak społeczność SNMPv2 lub poświadczenia bezpieczeństwa SNMPv3). Te pola są zależne od kontekstu:
- Wartości są wstępnie uzupełniane, gdy to możliwe, tj. dla pozycji wymagających agenta, poprzez pobranie informacji z wybranego interfejsu agenta hosta
- Wartości muszą zostać wypełnione ręcznie dla pozycji szablonu
- Wartości makr w postaci zwykłego tekstu są rozwijane
- Jeśli wartość pola (lub część wartości) jest sekretem lub makrem Vault, pole będzie puste i trzeba je będzie wypełnić ręcznie. Jeśli którykolwiek parametr pozycji zawiera wartość sekretnego makra, 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)
- Kliknij Get value and test, aby przetestować przetwarzanie wstępne
Jeśli w formularzu konfiguracji pozycji określono mapowanie wartości (pole „Show value”), okno dialogowe testu pozycji wyświetli po wyniku końcowym dodatkowy wiersz o nazwie „Result with value map applied”.
Parametry specyficzne dla pobierania rzeczywistej wartości z hosta:
| Parameter | Description |
|---|---|
| Get value from host | Zaznacz to pole wyboru, aby pobrać rzeczywistą wartość z hosta. |
| Host address | 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. |
| Additional fields for SNMP interfaces (SNMP version, SNMP community, Context name, etc.) |
Zobacz Configuring SNMP monitoring, aby uzyskać dodatkowe informacje na temat konfiguracji interfejsu SNMP (v1, v2 i v3). Pola te 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). |
| Value | Wartość pobrana z hosta. Kliknięcie w polu parametru lub przycisku podglądu/edycji otworzy okno obszaru tekstowego z wartością lub blokiem kodu.Wartości są obcinane do maksymalnego rozmiaru 512KB i tylko we frontendzie. Jeśli wynik zostanie obcięty, wyświetlana jest ikona ostrzeżenia. Opis ostrzeżenia jest wyświetlany po najechaniu kursorem. Należy pamiętać, że dane większe niż 512KB są nadal w pełni przetwarzane przez serwer Zabbix. |
Dla pozostałych parametrów zobacz Testing hypothetical value powyżej.