Pobieranie logów z urządzenia

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.0
  
  VPOS 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