Woordenlijst voor observability en LogBrew-termen

LogBrew gebruikt één term per productconcept. API-velden, CLI-opties, enumwaarden, eventnamen en attribuutsleutels blijven in elke taal ongewijzigd.

Observability en monitoring

Term	Betekenis
Observability	Inzicht in het gedrag van een applicatie op basis van het bewijs dat ze produceert.
Telemetrie	De signalen die een applicatie rapporteert, zoals logs, traces en metrics.
Monitoring	Bekende situaties controleren, zoals een gemeten waarde tegenover een drempelwaarde.
`o11y`	Een afkorting van observability. Het getal telt de 11 letters tussen `o` en `y`.

Lees Telemetrie voor het kiezen van signalen en uitgewerkte voorbeelden.

AI-agents

Term	Betekenis
MCP-server	De gehoste LogBrew-server voor het Model Context Protocol. AI-agents gebruiken die server om goedgekeurde projecten te lezen.
MCP-client	Een applicatie die een AI-agent met een MCP-server verbindt, zoals Claude Code.
Goedgekeurd project	Een project dat je hebt gekozen toen je een MCP-client toegang gaf. De client kan alleen goedgekeurde projecten lezen.
Verbinding	De toegang die je 1 MCP-client geeft als je die client goedkeurt. De verbinding eindigt na 30 dagen zonder gebruik, na 90 dagen of als je die intrekt. De CLI noemt dit een grant.

Lees Een AI-agent via MCP verbinden om een client te verbinden.

Observability-signalen

Issue

Een gegroepeerd probleem dat meerdere voorvallen kan bevatten. Een voorval is één vastgelegd exemplaar van dat issue. first_seen_at is het tijdstip van het eerste voorval. last_seen_at is het tijdstip van het meest recente voorval.

Log

Eén eventrecord met een tijdstempel. Een log kan ernst, service, release, omgeving, tracecontext en attributen binnen privacygrenzen bevatten.

Trace en span

Een trace volgt werk binnen een request of bewerking. Een span is één bewerking met een gemeten duur binnen die trace. Een correlatie met een trace is bewijs van gedeelde context, geen bewijs van een oorzaak.

Metric

Een runtimemeting met een gedefinieerde eenheid, soort, aggregatie en tijdvenster. Datapunten van metrics zijn niet uitwisselbaar met aantallen logs, traces of issues.

Release

Een gedeployde versie van een applicatie of service die met telemetrie wordt gemeld. Een release is niet hetzelfde object als een project of repository.

Actie

Een geclassificeerd productevent, zoals een aanmelding, afrekening, import of mislukte taak. Analytics deelt een actie in als paginaweergave, schermweergave of interactie. Een actie is geen geautomatiseerde opdracht die LogBrew uitvoert.

Issueonderzoek

Niet elk voorval bevat elk veld.

Term	Betekenis
Ernst	De urgentie van een signaal: `info`, `warning`, `error` of `critical`. Staat los van de issuestatus.
Issuestatus	De workflowstatus van een gegroepeerd issue: `unresolved`, `resolved` of `archived`. Het is niet de uitkomst van één request.
Gearchiveerd issue	Een issue dat het team uit de actieve triage heeft gehaald. Oudere responses noemen deze status `ignored`.
Issueprioriteit	De triagevolgorde van een gegroepeerd issue: `high`, `medium` of `low`. De prioriteit volgt de ernst totdat een persoon haar instelt.
Prioriteitsbron	Waar de prioriteit vandaan komt. `derived` volgt de ernst: `error` en `critical` worden `high`, `warning` wordt `medium` en `info` wordt `low`. `manual` is een prioriteit die een persoon heeft ingesteld.
Toegewezen aan	Precies 1 account of 1 team dat verantwoordelijk is voor de volgende stap bij een gegroepeerd issue. Een account moet het project kunnen lezen. Een team moet bij de organisatie van het project horen.
Team	Een groep leden van een organisatie, met een naam. Je kunt issues aan een team toewijzen, en eigenaarsregels kunnen het team noemen. Een team geeft zijn leden geen toegang tot projecten.
Eigenaarsregel	Een regel van een project die een pad van een stackframe, een module, een route, een service of een tag koppelt aan de accounts of teams die eigenaar zijn van passende issues.
Voorgestelde eigenaar	Een account of team dat LogBrew voorstelt voor een issue, op basis van een eigenaarsregel, een tekstregel in CODEOWNERS of recente activiteit. Het is een voorstel, geen toewijzing.
Inbox	De lijst met issues die anderen aan jou of je teams hebben toegewezen. LogBrew stuurt hiervoor geen e-mail.
Stacktrace	Vastgelegd bewijs van functieaanroepen bij een fout. Het is iets anders dan een distributed trace.
Stackframe	Eén item in een stacktrace. Kan een functie, module, bestand, regel of kolom aanduiden.
Exceptionketen	Gekoppelde exceptions die samen worden gemeld, zoals een fout en de oorzaak ervan. Ontbrekende, afgeschermde of afgekapte items beperken het bewijs.
Applicatieframe	Een stackframe dat als applicatiecode is gemarkeerd. Het toont code om te bekijken. Het bewijst niet waar de fout zit.
Breadcrumb	Een kort vastgelegd event vóór een voorval van een issue. Breadcrumbs zijn geen volledige opname van een sessie.
Afgehandelde exception	Een exception die de applicatie als afgehandeld heeft gemeld. Dat bewijst niet dat de bewerking is geslaagd.
Source map	Een buildartefact dat gegenereerde JavaScript-locaties koppelt aan de oorspronkelijke bronlocaties.
Gesymboliseerd frame	Een frame waarvan de gegenereerde locatie is omgezet naar informatie over de oorspronkelijke broncode.
Basisvoorval	Het vastgelegde voorval dat als referentie voor reproductie dient.
Herkomst	Waar een beoordeling vandaan komt. `backend_observed` betekent dat LogBrew het heeft waargenomen. `application_reported` betekent dat de app het heeft gemeld en dat LogBrew het niet heeft gecontroleerd.
Klaar voor reproductie	Of het basisvoorval het bewijs heeft dat nodig is om een reproductie te proberen. Het is geen geslaagde reproductietest.

Gebruik de handleiding voor issueonderzoek voor de leesvolgorde en de velden van de response.

Identiteit en correlatie

Een ontbrekende waarde bewijst niet dat de bijbehorende activiteit niet heeft plaatsgevonden.

Term	Betekenis
Tracecontext	De trace- en span-ID’s die werk over signalen heen verbinden.
Rootspan	De span die een trace start en geen bovenliggende span heeft. De vroegste teruggegeven span is niet per se de rootspan.
Onderliggende span	Een span met een bovenliggende span in dezelfde trace.
Correlatie	Een exacte relatie die LogBrew teruggeeft, zoals een gedeeld trace-ID. Bewijst geen oorzaak.
Geïdentificeerde gebruiker	Een subject dat de app aanlevert, met een vast ID en soort `user`.
Anoniem subject	Een subject dat de app aanlevert, met soort `anonymous`. Aantallen houden het gescheiden van geïdentificeerde gebruikers.
Onbekende identiteitssoort	Een subject zonder bekende soort. Telt niet als geïdentificeerde gebruiker.
Ontbrekend subject	Een event zonder subject. Dit is iets anders dan een subject met een onbekende soort.

De identiteitssoort laat zien hoe de app het subject heeft ingedeeld. Ze bewijst niet dat de gegevens anoniem zijn. Een vast ID kan activiteit nog steeds koppelen.

Bereik en datakwaliteit

Term	Betekenis
Project	De belangrijkste afbakening van een product, met een eigenaar. Eén project kan meerdere services of repositorycomponenten bevatten.
Service	Een runtime of component binnen een project die gegevens rapporteert.
Omgeving	Een exacte context waarin gerapporteerd wordt, zoals productie of staging.
Opgenomen	Geaccepteerd via de ingest-API, volgens het opnamecontract. Belooft niet dat gegevens onbeperkt worden bewaard.
Geïndexeerd	Beschikbaar voor de opgegeven index of query. Geen synoniem van opgenomen.
Bewaard	Aanwezig in het beoordeelde gegevensvenster.
Gesampled	Een deel van de telemetrie is vóór of tijdens het verzamelen geselecteerd.
Dekking	Een gemeten aandeel met een expliciete teller en noemer.
Afgekapt	De response heeft een grens bereikt. Weggelaten gegevens ontbreken niet per se.
Bij benadering	Geschat volgens de gedocumenteerde methode in plaats van exact geteld.
Tijdvenster	De exacte periode die een query beoordeelt.

Metingen en tijd

Term	Betekenis
Datapunt	Eén waarde op een gemeld tijdstip. Lees de naam en de eenheid van de metric voordat je datapunten vergelijkt.
Tijdreeks	Waarden van dezelfde meting, gesorteerd op tijd. Een gat betekent niet dat de waarde nul was.
Duur	De verstreken tijd van een bewerking. Iets anders dan het tijdstip waarop de bewerking plaatsvond.
Aggregatie	Een vooraf bepaalde berekening over metingen, zoals een som of een gemiddelde.
Tijdsinterval	Eén interval in een grafiek of gegroepeerd resultaat. Het begin en het einde bepalen het bereik.
Onvolledige periode	Een periode die nog niet voorbij is. Het is geen afgeronde periode zonder activiteit.

Tel de duur van overlappende onderliggende spans niet op om de totale requesttijd te krijgen. Vergelijk een aantal events niet met een aantal geïdentificeerde gebruikers.

Bewijsstatussen

Deze statussen zijn niet uitwisselbaar:

Vastgelegd: het bewijs is aanwezig.
Ontbreekt: het bewijs is niet vastgelegd.
Afgeschermd: het bewijs is bewust verborgen.
Afgekapt: het bewijs overschreed een grens van de response of van het vastleggen.
Niet beschikbaar: de leesactie kon het bewijs niet leveren.

Likely cause (waarschijnlijke oorzaak) en likely fix area (waarschijnlijke herstelplek) beschrijven begrensd diagnostisch bewijs, geen bewezen grondoorzaak. Reported impact (gemelde impact) komt van de rapporterende applicatie, tenzij een contract expliciet een meting van LogBrew beschrijft.

Productanalyse

Term	Betekenis
Event	Geclassificeerde productactiviteit met een exacte, vaste naam.
Eigenschap	Een contextsleutel om een event te beschrijven of te filteren.
Sessie	Een bezoek of app-sessie, geen persoon.
Cohort	Een afgebakende groep, bepaald door exacte criteria.
Trechter	Geordende stappen om voortgang of conversie te meten.
Retentie	Terugkeergedrag, gemeten met een expliciete periode en noemer.
Paden	Routes binnen sessies vóór of na een gekozen event.
Levenscyclus	Deelt geïdentificeerde subjecten per periode in als nieuw in de waargenomen geschiedenis, terugkerend, opnieuw actief of inactief.
Nieuw in de waargenomen geschiedenis	Actief zonder eerder gekozen event binnen het begrensde geschiedenisvenster. Het betekent niet dat het om een nieuwe klant gaat.

Onvolledige perioden, ontbrekende identiteit, onvolledig vastgelegde eigenschappen, sampling en afkappen beperken wat het resultaat zegt. LogBrew toont die grenzen in plaats van ze om te zetten in nul of zekerheid. Lees Productanalyse voor de telregels. Gebruik Productevents vastleggen om geclassificeerde activiteit en getypeerde identiteit te verzenden.

​Observability en monitoring

​AI-agents

​Observability-signalen

​Issueonderzoek

​Identiteit en correlatie

​Bereik en datakwaliteit

​Metingen en tijd

​Bewijsstatussen

​Productanalyse