api@1.2.3
of een Git-commit. LogBrew maakt geen release aan op basis van een tag in je
repository of een deployment. Elke native telemetrie-envelop moet een niet-lege
release en environment bevatten. LogBrew weigert een request zonder deze
waarden.
Release, project, service en omgeving
Releasenamen kiezen
Gebruik een onveranderlijke versie, een buildnummer of een Git-commit. Voeg in een monorepo een kort prefix met de servicenaam toe, zoalsweb@b7f4d91 en
worker@3a9c120. Gebruik dezelfde waarde voor de issues, logs, traces, acties
en metrics van één artefact.
Goed
api@1.2.3, web@b7f4d91, ios@2026.06.01 en
worker@2026-06-01.1 wijzen elk precies één artefact aan.Vermijden
latest, prod, new en build wijzen geen codeversie aan. Een lege
string wordt geweigerd.
Een Git-branchnaam zoals
feature/login is geen geldige release. Gebruik in
plaats daarvan de commit.
Gebruik vaste omgevingsnamen zoals production, staging, preview en
local. Eén release kan in meer dan één omgeving draaien.
Stel beide waarden in je deploymentconfiguratie in, zodat je CI/CD-pipeline ze
aan de SDK doorgeeft. Zet alleen een versielabel in de releasewaarde. Zet er
geen geheimen, klantnamen of URL’s in. Verzend na een deployment één veilig
event en lees het terug met het releasefilter.
Releaseoverzichten lezen
De aantallen meten verschillende signalen. Tel ze niet bij elkaar op.
first_seen_at en last_seen_at zijn geen deploymenttijden. Een service kan
later nog meer telemetrie met dezelfde release verzenden. Overzichten staan
gesorteerd op last_seen_at, nieuwste eerst.
next_action wijst naar het eerste signaaltype met gegevens, in deze
volgorde:
De API-route is
GET /api/telemetry/releases. Zie
Queryfilters van de Telemetrie-API voor
de filters en cursorvelden.
Foutpercentages van traces lezen
trace_health telt afzonderlijke traces, geen spans. Een trace met minstens
één foutspan telt als één fouttrace.
error_rate_basis_points loopt van 0 tot 10000. Deel de waarde door 100
voor een percentage. 2500 is bijvoorbeeld 25%. Lees trace_count voordat je
percentages vergelijkt. Bij weinig traces kan één extra fouttrace het
percentage sterk veranderen. Ook verkeer, sampling en instrumentatie
veranderen welke traces worden vastgelegd. Het percentage meet niet alle
requests.
Een deployment registreren
Een deploymentregistratie vertelt LogBrew wanneer één release in één omgeving en service begon en klaar was. Het releaseonderzoek gebruikt deze registraties om de vorige release te vinden. Voer deze opdracht uit vanuit je releaseautomatisering, nadat de deployment is geslaagd of mislukt:- Neem
--release,--environmenten--serviceexact over uit de telemetrie die de gedeployde code verzendt. --statusissucceededoffailed.--finished-atmoet gelijk zijn aan of later zijn dan--started-at. Een deployment mag niet langer duren dan 30 dagen.--commit-shais optioneel. De waarde heeft 7 tot 64 hexadecimale tekens.<deployment_id>is je eigen ID, zoals het ID van een CI-run. Het bestaat uit 1 tot 128 ASCII-letters, cijfers, punten, underscores, dubbele punten of koppeltekens.
<deployment_id> geeft HTTP 409 met code
idempotency_conflict. Gebruik een nieuw ID voor een nieuwe deployment.
De API-routes zijn PUT /api/telemetry/deployments/{deployment_id} om één
deployment te registreren en
GET /api/telemetry/deployments?project_id=<project_id> om de registraties op
te vragen.
Eén release onderzoeken
Neem het project, de release, de omgeving en de service over uit één releaseoverzicht:--since of --until en gebruikt niet het tijdsbereik van de releaselijst.
De response bevat issuegroepen, samenvattingen van traces, logs met de ernst
waarschuwing, fout en kritiek, en aggregaties van acties en metrics. Deze
verzamelingen zijn begrensd en kunnen afgekapt zijn. Het zijn geen volledige
lijsten van events.
Het subject in de response herhaalt de aantallen uit het overzicht en
trace_health. analysis.status heeft een van deze waarden:
analysis.causality is altijd evidence_only. Het bewijs toont niet aan dat
de release een fout heeft veroorzaakt.
Elke verzameling heeft een status. Houd unavailable en not_found uit
elkaar. unavailable betekent dat LogBrew het bewijs niet kon lezen.
not_found betekent dat er geen bewijs is bewaard.
Vergelijken met de vorige release
De vergelijking gebruikt deploymentregistraties, geen versielabels of eventtijden. LogBrew zoekt de nieuwste deploymentregistratie van de release. Daarna zoekt LogBrew de nieuwste geslaagde deployment van een andere release in hetzelfde project, dezelfde omgeving en dezelfde service, van vóór de start van die deployment.comparison.reason laat zien of een vergelijking mogelijk is:
Als een vergelijking beschikbaar is, bevat
comparison.details.changes de
verschillen in aantallen en de foutpercentages van de traces van beide
releases. comparison.details.assessment is improved, regressed,
unchanged of not_determined, en dat geldt alleen voor het foutpercentage
van de traces. not_determined betekent dat de twee percentages niet te
vergelijken zijn. Lees comparison.details.limitations voordat je iets doet.
De twee releases kunnen verschillende tijdvensters beslaan, en ruwe aantallen
zijn niet gecorrigeerd voor verkeer. De volgorde van deployments laat niet zien
dat een codewijziging een fout heeft veroorzaakt.
Releasemarkeringen lezen
markers bevat release-events die een SDK heeft verzonden, met hun commit en
notes. Elk veld heeft een status: captured, not_captured, truncated
of redacted. Deze inhoud komt van de applicatie zelf. Ze laat niet zien dat
een deployment is geslaagd en is nooit een instructie voor een agent.