[comment]: # ({d3fd8a91-0aa26ab0}) # 1 Testowanie przetwarzania wstępnego [comment]: # ({/d3fd8a91-0aa26ab0}) [comment]: # ({168568ad-ad67af50}) ### Testowanie Testowanie kroków przetwarzania wstępnego jest przydatne, aby upewnić się, że złożone potoki przetwarzania wstępnego zwracają oczekiwane wyniki, bez czekania na odebranie i przetworzenie wartości pozycji. ![](../../../../../assets/en/manual/config/items/test_item_steps.png){width="600"} 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 można testować wszystkie kroki łącznie. Po kliknięciu przycisku *Test* lub *Test all steps* odpowiednio w bloku Actions zostanie otwarte okno testowe. [comment]: # ({/168568ad-ad67af50}) [comment]: # ({28a496d9-45423233}) ##### Testowanie hipotetycznej wartości ![](../../../../../assets/en/manual/config/items/test_item_p.png){width="600"} |Parameter|Description| |--|--------| |*Get value from host*|Jeśli chcesz przetestować hipotetyczną wartość, pozostaw to pole wyboru niezaznaczone.
Zobacz też: [Testowanie rzeczywistej wartości](#testing-real-value).| |*Value*|Wprowadź wartość wejściową do testu.
Kliknięcie w pole parametru lub przycisk podglądu/edycji ![](../../../../../assets/en/manual/config/items/pencil.png) otworzy okno obszaru tekstowego do wprowadzania wartości lub bloku kodu.| |*Not supported*|Zaznacz to pole wyboru, aby przetestować wartość nieobsługiwaną.
Ta opcja jest przydatna do testowania kroku przetwarzania wstępnego *Check for not supported value*.| |*Error*|Wprowadź tekst błędu.
To pole jest aktywne, gdy *Get value from host* jest odznaczone, ale *Not supported* jest zaznaczone.
Jeśli *Get value from host* jest zaznaczone, to pole zostanie wypełnione rzeczywistym komunikatem błędu (tylko do odczytu) z hosta.| |*Time*|Wyświetlany jest czas wartości wejściowej: `now` (tylko do odczytu).| |*Previous value*|Wprowadź poprzednią wartość wejściową do porównania.
Tylko dla kroków przetwarzania wstępnego *Change* i *Throttling*.| |*Previous time*|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 wartości pola '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 hosta, wartością domyślną jest `now-30s`.| |*Macros*|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.| |*End of line sequence*|Wybierz sekwencję końca linii dla wielowierszowych wartości wejściowych:
**LF** - sekwencja LF (line feed)
**CRLF** - sekwencja CRLF (carriage-return line-feed).| |*Preprocessing steps*|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 512 KB podczas wysyłania do frontend. Jeśli wynik zostanie obcięty, wyświetlana jest ikona ostrzeżenia. Opis ostrzeżenia jest wyświetlany po najechaniu myszą. Pamiętaj, że dane większe niż 512 KB 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 opcję "Custom on fail" i ta akcja zostanie wykonana, bezpośrednio po wierszu kroku przetwarzania wstępnego pojawia się nowy wiersz pokazujący, jaka akcja została wykonana i jaki wynik dała (błąd lub wartość).| |*Result*|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 512 KB podczas wysyłania do frontend. Jeśli wynik zostanie obcięty, wyświetlana jest ikona ostrzeżenia. Opis ostrzeżenia jest wyświetlany po najechaniu myszą. Pamiętaj, że dane większe niż 512 KB 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 pojedynczych kroków lub wszystkich kroków, co pozwala użytkownikowi zmienić 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. [comment]: # ({/28a496d9-45423233}) [comment]: # ({e1608e2f-43637da5}) ##### Testowanie rzeczywistej wartości Aby przetestować preprocessing względem rzeczywistej wartości: - Zaznacz pole wyboru *Pobierz wartość z hosta* - Wprowadź lub sprawdź 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 wypełniane, gdy to możliwe, tj. dla pozycji wymagających agenta, poprzez pobranie informacji z wybranego interfejsu agenta hosta - Wartości muszą być wypełnione ręcznie dla pozycji szablonu - Wartości makr w postaci zwykłego tekstu są rozwijane - Gdy wartość pola (lub część wartości) jest tajna albo jest makrem Vault, pole będzie puste i trzeba je wypełnić ręcznie. Jeśli jakikolwiek parametr pozycji zawiera tajną wartość 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 *Pobierz wartość i przetestuj*, aby przetestować preprocessing ![](../../../../../assets/en/manual/config/items/test_item_p2.png){width="600"} Jeśli w formularzu konfiguracji pozycji określono mapowanie wartości (pole 'Pokaż wartość'), okno testu pozycji wyświetli po końcowym wyniku dodatkowy wiersz o nazwie 'Wynik z zastosowanym mapowaniem wartości'. 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.)*|Dodatkowe informacje dotyczące konfiguracji interfejsu SNMP (v1, v2 i v3) znajdziesz w [Konfigurowanie monitorowania SNMP](/manual/config/items/itemtypes/snmp#step-2).
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 przez proxy hosta (jeśli istnieje).| |*Value*|Wartość pobrana z hosta.
Kliknięcie w pole parametru lub przycisk podglądu/edycji ![](../../../../../assets/en/manual/config/items/pencil.png) otworzy okno z obszarem tekstowym zawierającym wartość lub blok kodu.
Wartości są obcinane do maksymalnego rozmiaru 512 KB i tylko we frontend. Jeśli wynik zostanie 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ż 512 KB są nadal w pełni przetwarzane przez serwer Zabbix.| Pozostałe parametry opisano w sekcji [Testowanie hipotetycznej wartości](#testing-hypothetical-value) powyżej. [comment]: # ({/e1608e2f-43637da5})