Spis treści dokumentacji

Monitoring i logi

Sprawdzisz, czy serwer działa, podłączysz monitoring i znajdziesz przyczynę problemu w logach.

Szybkie sprawdzenie

systemctl status gadka gadka-proxy
gadka healthcheck && echo OK

Polecenie gadka healthcheck odpytuje http://127.0.0.1:9090/readyz i kończy się kodem 0, gdy serwer jest gotowy. Inny adres podasz flagą --url.

Punkty kontrolne

Serwer udostępnia je na porcie telemetrii, domyślnie 127.0.0.1:9090 (klucz telemetry.listen).

AdresDo czego
/healthzczy proces żyje
/readyzczy serwer jest gotowy przyjmować ruch
/metricsmetryki w formacie Prometheus
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:9090/readyz

Wynik 200 oznacza gotowość.

Wybrane metryki

MetrykaCo mierzy
gadka_gwp_connectionsotwarte połączenia aplikacji
gadka_gwp_transport_connectionspołączenia według transportu (QUIC, WebSocket)
gadka_gwp_slow_consumers_totalpołączenia zamknięte, bo klient nie nadążał z odbiorem
gadka_http_request_duration_secondsczas obsługi żądań HTTP
gadka_link_safety_updated_timestamp_secondskiedy ostatnio odświeżono Listę Ostrzeżeń CERT Polska
gadka_link_blocked_totalzablokowane linki
gadka_workflow_webhook_rejected_totalodrzucone wywołania webhooków workflow

Przykład alertu: lista CERT nieodświeżona od doby, czyli time() - gadka_link_safety_updated_timestamp_seconds > 86400.

Logi serwera

Usługi piszą do dziennika systemowego.

journalctl -u gadka -n 100
journalctl -u gadka -f
journalctl -u gadka-proxy -n 100

Logi serwera mają format JSON. Poziom i format zmienisz w /etc/gadka/gadka.yaml:

log: { level: debug, format: text }

Po zmianie: sudo systemctl restart gadka. Po zakończeniu diagnozy wróć do poziomu info.

Wpisy, na które warto patrzeć

WpisZnaczenie
błąd zaraz po starciebłędna konfiguracja; serwer nie uruchamia się z niepoprawnym plikiem
read secret: …brak pliku sekretu albo złe uprawnienia
link safety: list update failednie udało się pobrać Listy Ostrzeżeń
link_blockedzablokowano link (zapisywana jest tylko nazwa hosta)
LICENSE_SERVER_ID_CHANGEDzmienił się Server ID

Śledzenie żądań

Serwer wysyła ślady OpenTelemetry, gdy ustawisz adres kolektora:

telemetry:
  otlp:
    endpoint: http://otel.example.com:4318

Co dalej