Log jest rejestrem zdarzeń, chronologicznym zapisem zawierającym informację o działaniach terminala płatniczego i jego komunikacji z fizycznym automatem. Log tworzony jest automatycznie przez urządzenie w wbudowanej pamięci. Logi są używane do analizowania pracy urządzenia, śledzenia przebiegu transakcji oraz wykrywania wszelkich błędów i nieprawidłowości pracy urządzenia. W przypadku Nayax logi są nazywane także jako Gtrace.
Typowy wpis w logu zawiera m.in. następujące informacje:
- numer wpisu w pojedynczym logu
- typ i podtyp zdarzenia
- czas zdarzenia
- tekstowy opis zdarzenia
Logi mogą być przesłane z pamięci urządzenia do systemu informatycznego Nayax. Następnie z poziomu systemu można je przeglądać i analizować. Jeśli zaistnieje potrzeba logi w postaci przetworzonej lub surowej można zapisać do pliku tekstowego i przesłać poza system Nayax. Taka sytuacja może się wydarzyć w przypadku jeśli chcemy dostarczyć logi urządzenia dla producenta maszyny, gdy podejrzewamy niewłaściwą implementację protokołu MDB.
Poniższy materiał przedstawia jak w praktyce wygląda pobieranie logów przez system Nayax:
Logi mogą mieć różną wartość, która wpływa na to ile wierszy z dziennika zdarzeń zostanie pobranych. Wartość logów wskazujemy w parametrze Gtrace Request w sekcji Ustawienia modułu wybranego automatu w systemie Nayax:
- Request Gtrace and Reset Buffer pobierze ostatnie zdarzenie z pamięci zdarzenia. Zważywszy, że sama transakcja generuje ponad 30 zdarzeń w dzienniku, nie dostaniemy praktycznie żadnej informacji. Dodatkowo logi w urządzeniu zostaną wymazane. Nie zalecamy pobierać logów z tym ustawieniem
- Request Gtrace działa identycznie jak powyższy parametr ale nie wymazuje pamięci urządzenia
- Dump 15 / 1000 / 3000 / 10k / 60k records from flash Gtrace pobrane zostanie odpowiednia ilość zdarzeń z pamięci urządzenia. Wartość 60k (60 tys. zdarzeń) wystarczy, żeby prześledzić pracę urządzenia nawet kilka dni wstecz
- Dump All records from Flash Gtrace wysłanie takiego parametru do urządzenia spowoduje przesłanie do systemu Nayax wszystkich zdarzeń zarejestrowanych w pamięci urządzenia
Rys.1 Wartości parametru Gtrace Request w systemie Nayax
Pamięć urządzenia będzie przechowywała informacje o zdarzeniach do momentu wyczyszczenia pamięci (Reset Buffer wraz z poleceniem przesłania ostatniego zdarzenia), przywrócenia urządzenia do ustawień domyślnych lub zaniku napięcia (reset urządzenia przez odłączenia źródła zasilania tzw. prądowy). Dlatego ważne jest, w przypadku zaobserwowania nieprawidłowego działania urządzenia lub przebiegu transakcji, pobranie logów przed jakimikolwiek dalszymi działaniami.
Inne sposoby na pobranie logów z urządzenia
Zaprezentowany na filmie podstawowy sposób z zaznaczeniem parametru Gtrace Request w sekcji Ustawienia modułu, wybraniem wartości logu oraz wysłaniem polecenia z menu Czynności > Wyślij parametr to nie jedyny sposób, aby przesłać logi z urządzenia do systemu.
- z menu Czyności wybieramy Pobierz logi. Ilość pobranych zdarzeń z pamięci urządzenia będzie zależna od wartości parametru Gtrace Request w Ustawieniach modułu. Przed wysłaniem upewnijmy się, że znajduje się tam wartość nie mniejsza niż Dump 60k records from Flash Gtrace.
Rys. 2 Menu czynności w wirtualnym automacie
- bezpośrednio z poziomu urządzenia. W przypadku obu typów urządzeń musimy pamiętać, że pobranie logów jest równoznaczne z wysyłaniem parametru z pola Gtrace Request. Przed wysłaniem upewnijmy się, że urządzenie ma ustawiony dostarczenie dużą wartość.
AMIT– na urządzeniu klikamy przyciski: MENU > żółty przycisk zatowarowania > ENTER
- Rys. 3 Wysyłanie logów (Gtrace) z poziomu menu AMIT 3.0VPOS Touch / Onyx – obecnie taka opcja nie jest dostępna
- poprzez aplikację MoMa. Po wybraniu interesującego nas automatu klikamy na symbol „+” i wybieramy Pobierz GTRACE
Rys. 4 Wysyłanie logów za pomocą opcji automatu w mobilnej aplikacji do zarządzania – MoMa