Logi
Logi - jak interpretować?
Logi są najprostszym sposobem na debugowanie urządzenia. W przypadku jakichkolwiek problemów z samym urządzeniem, pierwszym miejscem w którym mozemy znaleźć informacje o źródle problemu są właśnie logi. Konfiguracji loggera dokonujemy w menu ustawienia w jego sekcji.
Przeglądarka logów
Przeglądarka logów w aplikacji boneIO oferuje zaawansowane funkcje ułatwiające analizę i diagnostykę sterownika.
Filtrowanie po poziomie logów
Logi można filtrować według poziomu ważności. Dostępne poziomy to:
| Poziom | Opis |
|---|---|
| ERROR | Błędy krytyczne wymagające natychmiastowej uwagi. |
| WARNING | Ostrzeżenia o potencjalnych problemach. |
| INFO | Informacje o normalnym działaniu sterownika. |
| DEBUG | Szczegółowe informacje diagnostyczne — widoczne tylko po włączeniu trybu debug. |
Filtrowanie odbywa się po stronie serwera — oznacza to że pobierane są tylko logi na wybranym poziomie, co znacząco przyspiesza przeglądanie.
Filtrowanie po module
Logi można filtrować również po module źródłowym (np. boneio.webui.app, boneio.core.manager). Dzięki temu możemy skupić się na logach z konkretnego komponentu sterownika. Lista dostępnych modułów jest automatycznie wykrywana z napływających logów.
Filtrowanie po dacie
Możliwość wyboru zakresu dat pozwala zawęzić wyświetlane logi do konkretnego przedziału czasowego. Przydatne do analizy zdarzeń historycznych.
Nieskończone przewijanie
Przeglądarka logów wykorzystuje paginację kursorową z nieskończonym przewijaniem. Nowe logi są automatycznie doładowywane w miarę przewijania — bez konieczności ręcznego przechodzenia między stronami.
Zaznaczanie i kopiowanie
Logi można zaznaczać klikając na poszczególne wiersze. Zaznaczenie wielu logów odbywa się poprzez:
- Kliknięcie z przytrzymanym klawiszem Shift — zaznaczenie zakresu
- Przeciąganie myszką — zaznaczenie wielu wierszy metodą "drag selection"
Zaznaczone logi można:
- Skopiować do schowka — przycisk kopiowania umożliwia skopiowanie zaznaczonych logów w formacie tekstowym
- Udostępnić na Discord — przycisk Discord kopiuje logi w formacie bloku kodu (
```log ```) gotowym do wklejenia na kanale Discord boneIO
Przełącznik trybu Debug
Przycisk Debug umożliwia tymczasową zmianę poziomu logowania w runtime — bez konieczności restartu sterownika. Po włączeniu trybu debug, logi na poziomie DEBUG zaczynają napływać natychmiast. Tryb debug jest tymczasowy — zostanie zresetowany po restarcie sterownika.
Zmiana poziomu logowania odbywa się poprzez API: GET/POST /api/log-level.