Monitoring

BizFlow NH oferuje opcjonalny stos monitoringu, instalowany jako dodatkowe kontenery Docker.

Status Latarni w dashboardzie

Niezależnie od stosu monitoringu, aktualny stan KSeF (Latarnia) jest widoczny bezpośrednio w dashboardzie:

• Selektor firm (CompanySelector) w nagłówku wyświetla kolorową kropkę obok nazwy firmy:

  • Zielona — KSeF dostępny (Available)
  • Żółta — planowana przerwa (Maintenance)
  • Czerwona — awaria (Failure / TotalFailure)

• Override Latarni — w środowiskach testowych i demo w selektorze firm dostępny jest dropdown pozwalający ręcznie zmienić stan Latarni. Przydatne do testowania trybu offline i automatycznego dosyłania.

Komponenty stosu monitoringu

Komponent	Port	Opis
Grafana	3000	Dashboardy i wizualizacja metryk
Prometheus	9090	Zbieranie i przechowywanie metryk
Tempo	3200	Distributed tracing (śledzenie zapytań)
Dozzle	8080	Podgląd logów kontenerów w czasie rzeczywistym

Instalacja

Monitoring jest opcjonalny. Aby go włączyć, odpowiedz y na pytanie instalatora:

Czy zainstalować stos monitoringu? (Grafana, Prometheus, Tempo, Dozzle) [y/N]: y

Lub dodaj później:

./ctl.sh monitoring enable
./ctl.sh start

Gotowe dashboardy Grafana

Po instalacji dostępne są wstępnie skonfigurowane dashboardy:

BizFlow NH — Overview

• Liczba wysłanych faktur (dziś, tydzień, miesiąc)
• Status KSeF (Available/Offline)
• Kolejka RabbitMQ (pending, processing)
• Błędy wysyłki

BizFlow NH — API Performance

• Czasy odpowiedzi endpointów
• Throughput (zapytania/sekundę)
• Error rate
• Najwolniejsze endpointy

BizFlow NH — Infrastructure

• Zużycie CPU i RAM per kontener
• Rozmiar bazy PostgreSQL
• Health check statusy
• Uptime kontenerów

Alerty

Grafana może wysyłać alerty. Wstępnie skonfigurowane:

Alert	Warunek	Kanał
KSeF niedostępny	Stan Latarni ≠ Available przez > 5 min	Email
Błąd wysyłki	Error rate > 10% w ciągu 5 min	Email
Dysk zapełniony	Wolne < 10%	Email
Certyfikat wygasa	< 30 dni do wygaśnięcia	Email

Konfiguracja kanałów alertów: Grafana — Alerting — Contact points.

Dozzle — logi w czasie rzeczywistym

Dozzle (http://server:8080) pokazuje logi wszystkich kontenerów w przeglądarce:

• Filtrowanie po kontenerze (api, dashboard, rabbitmq, postgres…)
• Wyszukiwanie tekstu w logach
• Podgląd w czasie rzeczywistym (streaming)
• Brak konieczności SSH

Debugowanie

Dozzle jest najszybszym sposobem na sprawdzenie logów bez dostępu SSH. Przydatny szczególnie przy wdrożeniu, gdy konsultant nie ma bezpośredniego dostępu do serwera.

Zasoby

Stos monitoringu zużywa dodatkowe zasoby:

Komponent	RAM	CPU
Grafana	~200 MB	niskie
Prometheus	~300 MB	niskie
Tempo	~200 MB	niskie
Dozzle	~50 MB	minimalne

Łącznie: ok. 750 MB RAM. Na serwerach z 4 GB RAM monitoring może wpływać na wydajność — rozważ wyłączenie go na małych maszynach.