HostBase

Platforma

Obserwowalność: Issues, monitory i OTLP

Grupowanie błędów z Functions i Workerów, doradcy stanu na żywo, monitory HTTP z SLO, eksport OpenTelemetry i rekomendacje indeksów.

Moduł Observability (Panel → projekt → Observability) zbiera w jednym miejscu to, co mówi o zdrowiu aplikacji: logi, błędy, dostępność i wydajność zapytań.

Issues

HostBase czyta logi Edge Functions i Workerów co 2 minuty i grupuje błędy według odcisku: typ błędu, znormalizowany komunikat (bez identyfikatorów, liczb i adresów) oraz trzy górne ramki stosu w Twoim kodzie (bez numerów linii, więc nowy deploy nie rozbija grupy). Issue ma licznik, pierwsze i ostatnie wystąpienie oraz status: open, resolved lub ignored. Rozwiązany issue otwiera się ponownie, gdy błąd wróci.

  • Powiadomienia — nowy i powracający issue trafia do powiadomień panelu oraz kanałów organizacji (Slack, Discord, e-mail, webhook).
  • Kopiuj kontekst dla agenta — markdown ze stack trace, logami przed błędem i ostatnim deployem (sekrety i tokeny są zamazywane), gotowy do wklejenia w Claude Code, Cursor lub Codex.
  • Webhook projektu — ładunek JSON z polem agent_prompt; zdarzenia issue.created i issue.regressed.

Health Check Advisors

Zakładka Doradcy pokazuje reguły na żywo: odsetek błędów 5xx w API (ostrzeżenie od 1%, krytyczne od 5%), saturacja połączeń (70% / 90%), opóźnienie replik (30 s / 5 min), zapełnienie miejsca na dane (80% / 90%) oraz nieudana lub nieświeża kopia zapasowa. Każdy wynik ma poziom severity i link „Zbadaj”, a ostrzeżenia i problemy krytyczne generują powiadomienia.

Monitory HTTP

Syntetyczne sprawdzanie adresów (domeny własne, endpointy) co 1, 5, 15, 30 lub 60 minut z oczekiwanym statusem, historią, celem SLO (7 lub 30 dni) i budżetem błędów. Alert po dwóch kolejnych niepowodzeniach. Monitory oznaczone jako publiczne pojawiają się na stronie /status/project/{ref}. Sondy działają z serwera panelu.

OpenTelemetry (OTLP/HTTP)

W Ustawienia → Log Drains wybierz cel „OpenTelemetry (OTLP/HTTP)”: podaj adres bazowy kolektora (np. Grafana Cloud, Honeycomb, SigNoz), nagłówki autoryzacji i sygnały: logi, metryki (liczniki wpisów i żądań) oraz ślady (żądania API jako spany). Przycisk „Testuj połączenie” wysyła testowy rekord. Wpisy trafiają do kolektora przez przekaźnik HostBase w formacie OTLP JSON (/v1/logs, /v1/metrics, /v1/traces).

Rekomendacje indeksów

W Baza danych → Przegląd HostBase analizuje pg_stat_statements i wskazuje zapytania filtrujące po kolumnach bez pasującego indeksu. Przy zainstalowanym hypopg najlepsze propozycje są weryfikowane symulacją kosztu bez tworzenia indeksu. Indeks budowany jest przez CREATE INDEX CONCURRENTLY.

Management API i MCP

GET   /api/v1/projects/{ref}/issues?status=open
GET   /api/v1/projects/{ref}/issues/{id}          # w tym agent_context (markdown)
PATCH /api/v1/projects/{ref}/issues/{id}          {"status":"resolved"}
GET|POST /api/v1/projects/{ref}/monitors          DELETE .../monitors/{id}
GET   /api/v1/projects/{ref}/runtime-advisors

Narzędzia MCP: list_issues, get_issue, set_issue_status, list_monitors, create_monitor, delete_monitor, get_runtime_advisors.

PoprzedniAI GatewayNastępny Koszty, kredyty i limity