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 OKPolecenie 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).
| Adres | Do czego |
|---|---|
/healthz | czy proces żyje |
/readyz | czy serwer jest gotowy przyjmować ruch |
/metrics | metryki w formacie Prometheus |
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:9090/readyzWynik 200 oznacza gotowość.
Wybrane metryki
| Metryka | Co mierzy |
|---|---|
gadka_gwp_connections | otwarte połączenia aplikacji |
gadka_gwp_transport_connections | połączenia według transportu (QUIC, WebSocket) |
gadka_gwp_slow_consumers_total | połączenia zamknięte, bo klient nie nadążał z odbiorem |
gadka_http_request_duration_seconds | czas obsługi żądań HTTP |
gadka_link_safety_updated_timestamp_seconds | kiedy ostatnio odświeżono Listę Ostrzeżeń CERT Polska |
gadka_link_blocked_total | zablokowane linki |
gadka_workflow_webhook_rejected_total | odrzucone 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 100Logi 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ć
| Wpis | Znaczenie |
|---|---|
| błąd zaraz po starcie | błędna konfiguracja; serwer nie uruchamia się z niepoprawnym plikiem |
read secret: … | brak pliku sekretu albo złe uprawnienia |
link safety: list update failed | nie udało się pobrać Listy Ostrzeżeń |
link_blocked | zablokowano link (zapisywana jest tylko nazwa hosta) |
LICENSE_SERVER_ID_CHANGED | zmienił się Server ID |
Śledzenie żądań
Serwer wysyła ślady OpenTelemetry, gdy ustawisz adres kolektora:
telemetry:
otlp:
endpoint: http://otel.example.com:4318