Een signaal kiezen
Begin een foutonderzoek met issues of logs. Gebruik een beschikbare trace om
één uitvoering te onderzoeken. Gebruik een trend in een metric om de bredere
periode te onderzoeken. Lees Productanalyse
voor activiteit en retentie.
Leg alleen de velden vast die een onderzoek nodig heeft. Gebruik stabiele namen
voor services, bewerkingen en metrics. Verzend geen toegangsgegevens,
betaalgegevens of ruwe requestbody’s. De handleiding
Vastgelegde gegevens beheren beschrijft de
instellingen.
Logs
Een log is een record van de applicatie op één moment. Een bruikbare log heeft:- Het brontijdstip van het event.
- Een canonieke ernst.
- Een project- en servicebereik.
- Omgeving en release.
- Trace- en span-ID’s als de log een actieve tracecontext heeft.
- Kleine, benoemde attributen met context voor het event.
occurred_at, severity, project_id,
service_name, environment, release, trace_id, span_id en
attributes. Zet context in benoemde attributen, niet in de berichttekst.
Logs van meerdere services in één weergave hebben geen tracerelatie. Alleen
tracecontext legt die relatie.
Traces
Een trace bevat de spans van één request of bewerking. Een rootspan heeft geen bovenliggende span. Een onderliggende span verwijst naar zijn bovenliggende span. Alle spans in een trace hebben hetzelfde trace-ID en verschillende span-ID’s. Zie Distributed tracing. Een log, issue, actie of metric die zonder actieve tracecontext is verzonden, krijgt een vastleggingstrace. Die trace bevat alleen vastleggingsspans. Een requestpad toont hij niet. Zie Vastleggingsspans.Metrics
Een metric legt een gemeten waarde in de tijd vast. Lees elke metric samen met de naam, de eenheid, de dimensies, het project, het tijdsbereik en het interval. LogBrew bepaalt devalue van elk punt op basis van kind en
temporality van de metric:
Drie metingen van een deltacounter met de waarden
2, 3 en 5 in één
interval geven bijvoorbeeld een value van 10 en een sample_count van 3
voor dat punt. Drie gaugemetingen met dezelfde waarden, in die volgorde, geven
een value van 5. Een p95-waarde is geen gemiddelde. Ongeveer 95% van de
vastgelegde waarnemingen ligt op of onder die waarde.
Bij status: "ready" is de afgeleide aggregatie beschikbaar. Lees bij
status: "limited" het veld aggregation.limitation en gebruik alleen de
ruwe waarden. Tel een gauge of een cumulatieve stream niet op. Een interval
zonder punt is geen gemeten nul. Lees
Queryfilters van de Telemetrie-API voor de
queryvelden.
GET /api/telemetry/metrics/series geeft deze punten terug. Het endpoint
vereist project_id, name en since. Elke reeks heeft één identity met
een kind, unit en temporality. Reeksen met verschillende identiteiten
blijven gescheiden. Elk punt kan ook deze velden bevatten:
coverage.truncated is true als series_limit reeksen met een lager volume
heeft weggelaten. Voer dit uit om een tijdvenster van een metric te vergelijken
met het vorige tijdvenster van dezelfde lengte:
Issues
Een issue groepeert herhaalde fouten op basis van een stabiele vingerafdruk. Het heeft een ernst, een status, een aantal voorvallen, een tijdstip ‘Eerst gezien’ en een tijdstip ‘Laatst gezien’. De details van een issue kunnen exceptionketens, stackframes, breadcrumbs, gerelateerde logs en een tracerelatie toevoegen.last_seen_at is het nieuwste voorval in de groep. Het voorval dat je kiest,
kan ouder zijn. Lees beide tijdstippen.
De status van een issue is unresolved, resolved of archived. Versie 1
van de API-response toont archived als ignored. Responseversies 2 en 3
voegen priority (high, medium of low) en priority_source toe. Versie 3
voegt ook assignee toe. Zie
Statuswaarden en
Prioriteit.
Acties
Een actie legt productactiviteit vast. Een ondersteunde classificatie markeert die activiteit als paginaweergave, schermweergave of interactie. Een eventnaam alleen bepaalt de classificatie niet. Gebruik Productevents vastleggen om deze context toe te voegen. Sessies zijn geen gebruikers. Anonieme subjecten zijn geen geïdentificeerde gebruikers.Ernstwaarden
LogBrew accepteert de aliassen als invoer, ongeacht hoofd- of kleine letters.
De API, de CLI en live-events gebruiken de canonieke waarden. Onbekende
ernstwaarden worden geweigerd. De ernst is de vastgelegde urgentie. Die toont
geen zakelijke impact of grondoorzaak.
Een gebruiker kan de getoonde ernst van een issue of log wijzigen. De response
bevat dan een object
triage met effective_severity. Het veld severity
behoudt de vastgelegde waarde.
Live lezen en momentopnamen
logbrew read geeft een momentopname terug voor het gekozen project, het gekozen
tijdsbereik en de gekozen filters. Voer de opdracht opnieuw uit om nieuwe
events te lezen. logbrew watch streamt nieuwe logs, issues en acties zolang
de verbinding open is. Traces en metrics streamt de opdracht niet. Een
verbindingsfout toont niet aan dat het project leeg is.
Bewijsstatussen
Responses houden deze statussen gescheiden: ‘Vastgelegd’, ‘Ontbreekt’, ‘Afgeschermd’, ‘Afgekapt’ en ‘Niet beschikbaar’. Tracebewijs heeft vier statussen:available, not_linked, not_found en unavailable. Zie de
introductie voor hun betekenis
en Grenzen van het bewijs
voor de dekkingsvelden. Een nieuwere SDK voegt geen velden toe aan events die
hij eerder heeft verzonden.
Eén project onderzoeken
1
Zoek onopgeloste issues
2
Lees één issue
Dit leest de bewaarde geschiedenis van het issue. De filter
--since uit
de lijst geldt hier niet.3
Open een beschikbare trace
Gebruik het trace-ID alleen als het gekozen voorval er een teruggeeft.
4
Lees gerelateerd bewijs
Filter logs, acties en metrics op hetzelfde project en dezelfde service,
omgeving en release. Koppel signalen niet alleen op basis van tijd.