Observability / sygnały operacyjne
Cztery sygnały, wspólny odczyt
Observability przyjmuje uporządkowane zdarzenia, kieruje je do właściwych modeli i udostępnia przez HTTP. Znaczenie danych pochodzi z kontraktu, a nie z odgadywania treści tekstowego loga.
| Sygnał | Pytanie | Odczyt |
|---|---|---|
| Log | Co technicznie zgłosił komponent? | /logs |
| Audit | Kto zgłosił jaką operację i z jakim skutkiem? | /audit |
| Health | Jaki stan i okres aktualności zgłaszano? | /health/current |
| Telemetry | Jaką wartość zmierzono? | /telemetry |
Przyjmowanie i powiązania
POST /ingress/events przyjmuje wspólną strukturę CanonicalEventEnvelope. Zawiera ona m.in. rodzaj sygnału, producenta, czas, identyfikator zdarzenia oraz właściwy payload. Identyfikatory build, bundle, sesji i trace mogą pomagać zestawiać informacje, jeżeli producent je dostarczy.
Ingress waliduje wymagane dane, normalizuje obsługiwany payload i kieruje go do odpowiedniego magazynu. Rozpoznaje przyjęte ponowienie tego samego eventId; konflikt treści pod tym identyfikatorem jest odrzucany. Ta ewidencja pozostaje w pamięci procesu.
Zapytania i obraz sesji
API pozwala filtrować dane według parametrów obsługiwanych przez dany endpoint. Na przykład audyt można odczytać według działania i Build ID, a logi według korelacji. GET /sessions/{sessionId} zestawia cztery rodzaje danych dotyczących sesji.
Ten obraz powstaje z otrzymanych wpisów. Nie jest pełnym snapshotem pamięci aplikacji, sesją debuggera ani dowodem, że wszystkie komponenty odpowiedziały.
Health i aktualność
Sygnał health określa scope, subject, status, czas obserwacji i okres świeżości. Projektor pozwala odczytać stan z uwzględnieniem wskazanego czasu. Znaczenie statusu zależy od producenta: warto sprawdzić, co on rzeczywiście obserwuje.
Retencja i administracja
Można skonfigurować okna retencji logów i telemetrii oraz okresowe usuwanie starych danych. Opcjonalne operacje administracyjne pozwalają odczytać lub usunąć watermarki pollerów. Mają własną kontrolę dostępu.
Retencja nie zapewnia trwałości. Plik watermarków zapisuje informacje o odczycie źródła, nie kopię zaimportowanych sygnałów. Poznaj ograniczenia.
Zakres sprawdzenia
W lokalnym przeglądzie przeszły 44 testy repozytorium. Dodatkowo rzeczywisty Query API przyjął i udostępnił cztery klasy kontrolowanych sygnałów, rozpoznał duplikaty i zwrócił agregat sesji. To nie jest odbiór całej platformy ani deklaracja gotowości produkcyjnej.