Problemen oplossen bij ontbrekende applicatielogs

Gebruik deze pagina als telemetrie ontbreekt, onvolledig is of te breed is. Controleer eerst de toegang. Houd daarna het project, de service, de release, de omgeving en het tijdsbereik vast terwijl je de oorzaak zoekt.

Voeg --json toe voor workflows met agents. Een mislukte controle geeft een stabiel next-veld terug.

Met de snelle controles beginnen

Symptoom	Eerste controle	Volgende stap
De CLI is niet ingelogd	`logbrew status --json`	Een persoon voert `logbrew login` uit.
Een project ontbreekt	`logbrew projects --json`	Gebruik een ID uit de projectlijst.
De installatiestatus is onduidelijk	`logbrew doctor --project "<project_id>" --json`	Volg de teruggegeven waarde van `next`.
Logs zijn leeg	Lees de logs voor precies het project en het tijdsbereik	Controleer andere signaaltypen apart.
Resultaten zijn te breed	Voeg filters toe voor project, service, release en omgeving	Houd bij elke leesactie dezelfde scope aan.
Een trace ontbreekt	Lees de details van het issue	Lees een trace alleen als de response een trace-ID bevat.
JavaScript-frames tonen gebouwde code	Controleer of build en source map bij elkaar horen	Volg Source maps voor JavaScript.
Een MCP-agent kan een project niet lezen	Controleer de goedgekeurde projecten	Volg Verbindingsproblemen met MCP.

Ontbrekende eerste telemetrie herstellen

Voer deze opdrachten uit voordat je de SDK-configuratie wijzigt. Ze lezen alleen:

logbrew version --json
logbrew status --json
logbrew projects --json
logbrew doctor --project "<project_id>" --json

logbrew doctor controleert API-toegang, authenticatie, het project, de ingest-sleutel, de installatie, telemetrie en de zichtbaarheid van logs. Het wijzigt het project niet. Lees de algemene status en elke controle in het doctor-rapport. Exitcode 0 betekent niet dat elke controle is geslaagd.

Doctor-status	Volgende stap
`needs_ingest_key`	Maak een projectgebonden ingest-sleutel. Zie Een ingest-sleutel roteren.
`needs_setup`	Rond de SDK-installatie af. Zie SDK-integratie.
`needs_telemetry`	Verstuur één veilig testevent vanuit de app en voer de doctor daarna opnieuw uit.
`ready`	Lees recente logs, issues, releases of traces.

Het rapport kan ook de status auth_invalid, project_missing, api_unreachable of check_failed hebben. Het doctor-rapport geeft voor elk daarvan de volgende stap. Een project dat ready is, kan toch geen logs hebben, omdat elk signaaltype apart staat. De controle logs kan empty of unavailable zijn. Een mislukte leesactie is geen leeg resultaat.

Eén veilig testevent versturen

Verstuur vanuit de geïnstalleerde SDK één testlog met een uniek bericht. Neem geen token, gebruikersgegevens of request-body op. Noteer het project-ID, de service, de omgeving, de release, de UTC-starttijd en de SDK-versie. Wacht op de aflevering en lees daarna een kort tijdsbereik in hetzelfde project. Verstuur geen extra testevents zolang de aflevering nog loopt.

Ontbrekende logs vinden

Lees eerst een kleine, exacte scope:

logbrew read releases --project "<project_id>" --environment production --json
logbrew read logs --project "<project_id>" --environment production \
  --release checkout@1 --since 1h --limit 20 --json

Controleer deze punten op volgorde:

Het project-ID hoort bij de app die het event verstuurde.
Service, release en omgeving komen exact overeen, inclusief hoofdletters en spaties.
Het tijdsbereik bevat de eventtijd. LogBrew geeft eventtijden terug in UTC. --until is een exclusieve bovengrens.
Geen zoek- of ernstfilter verbergt het event.
De app heeft het signaaltype verstuurd dat je leest. Een log maakt geen issue of trace aan.

Ontbreekt het event nog steeds, verwijder dan één filter tegelijk:

Houd het project aan en verbreed het tijdsbereik.
Verwijder het releasefilter.
Verwijder het omgevingsfilter.
Verwijder het servicefilter.
Verwijder zoek- en ernstfilters.

Stop zodra het event verschijnt. Het laatste filter dat je verwijderde, komt niet overeen met de appconfiguratie. Lees niet alle projecten in plaats van het geconfigureerde project.

Resultaat	Wat het laat zien	Volgende controle
Geen rijen in één project	Geen match in die scope	Controleer tijd en filters.
Logs, maar geen issues	Geen gegroepeerde fout past bij de filters	Controleer of de app een fout heeft verstuurd.
Issue zonder trace	Het voorval heeft geen bruikbare tracelink	Lees de tracestatus in het issueonderzoek.
Een release, maar geen logs	De release heeft andere signalen, maar geen logs in die scope	Vergelijk de aantallen in `logbrew read releases`. Lees elk signaaltype in hetzelfde project.
Event verschijnt nadat je een filter verwijdert	Dat filter sloot het event uit	Corrigeer het filter of de waarde in de app.

Een resultaatpagina is geen totaal. Ga met --pagination cursor verder met de teruggegeven next_cursor en houd dezelfde filters aan. Zie Cursorpaginering.

De dashboardweergave controleren

Het dashboard toont van elke lijst een momentopname. Zet in de logweergave Live aan om nieuwe logs toe te voegen zodra ze binnenkomen. Andere weergaven worden niet live bijgewerkt. Laad de pagina opnieuw voor een nieuwe momentopname. Een verouderde momentopname is iets anders dan een leeg resultaat. LogBrew bewaart alleen de telemetrie die de app verstuurt. Verwijder toegangsgegevens, request-body’s, querywaarden en persoonsgegevens vóór de aflevering. Gebruik Vastgelegde gegevens beheren om je veldselectie te controleren.

Issues en traces controleren

Gebruik een issue-ID of trace-ID dat LogBrew heeft teruggegeven. Verzin er nooit een.

logbrew read issues --project "<project_id>" --environment production \
  --status unresolved --since 24h --json
logbrew read issue "<issue_id>" --json
logbrew read trace "<trace_id>" --project "<project_id>" --json
logbrew read logs --trace "<trace_id>" --project "<project_id>" --json

--status accepteert unresolved, resolved en archived. ignored selecteert dezelfde issues als archived. Issuestatus en tracestatus zijn verschillende dingen. De tracestatussen not_linked, not_found en unavailable betekenen elk iets anders. Zie Een issue onderzoeken voor elke waarde. Lees het issue en de bijbehorende logs voordat je het oplost, archiveert of heropent.

CLI- en API-fouten afhandelen

In JSON-modus bevat een CLI-fout ok, error, message en next:

{
  "ok": false,
  "error": "not_logged_in",
  "message": "not logged in: run logbrew login",
  "next": "run logbrew login"
}

Geeft de API een fout terug, dan is error gelijk aan api_error. De fout heeft dan ook status (de HTTP-status), api_code (de API-code), api_error en api_next. Bij een rate_limited-fout heeft hij ook retry_after_seconds. De CLI probeert het niet automatisch opnieuw.

Status of fout	Herstel
`not_logged_in` of HTTP `401`	Een persoon voert `logbrew login` uit. Probeer daarna de leesactie opnieuw.
HTTP `403`	Gebruik de juiste toegangsgegevens voor het project. Voor een wijziging aan een issue heb je ook toestemming nodig om issues in het project te beheren. Toon de waarde van de toegangsgegevens niet.
HTTP `404`	Gebruik een actueel project-, issue- of trace-ID uit een response.
HTTP `422`	Corrigeer het genoemde veld.
HTTP `429` met `rate_limited`	Wacht `retry_after_seconds` en probeer het daarna één keer opnieuw.
HTTP `429` met een andere code	Stop automatische nieuwe pogingen. Volg `api_next`.
HTTP `5xx`	Wacht, probeer één leesactie opnieuw en meld het probleem als het blijft.

Zie API-fouten voor elke foutcode.

Een gecompromitteerd account beveiligen

Heeft iemand anders mogelijk een toegangstoken, vernieuwingstoken of sessiecookie van je account, log dan alle LogBrew-clients uit. Volg de procedure voor accountbreed uitloggen. Een persoon moet deze actie goedkeuren. logbrew logout en uitloggen in de browser beëindigen maar één client, dus dat is niet genoeg. Accountbreed uitloggen stopt ook elke MCP-verbinding die daarvoor is goedgekeurd. Is het uitloggen gelukt, wis dan de lokale LogBrew-toegangsgegevens op elke client en log opnieuw in vanaf een vertrouwde client. Keur MCP-clients pas opnieuw goed als je ze vertrouwt. Gaat de response verloren, meld dan niet dat alle clients zijn uitgelogd en herhaal het request niet automatisch. Accountbreed uitloggen roteert de ingest-sleutels van projecten niet. Is een ingest-sleutel uitgelekt, roteer dan de ingest-sleutel.

Veilig problemen oplossen

Gebruik toegangsgegevens van je account voor leesacties met de CLI. Gebruik projectgebonden ingest-toegangsgegevens alleen voor schrijfacties van de SDK. Zet geen tokens, autorisatieheaders, ruwe logs, klantgegevens, request-body’s, lokale paden of broncode in een opdracht, chat of supportticket. Herhaal één leesactie met de kleinste scope die nog steeds mislukt, voordat je een probleem meldt. Noteer de opdracht zonder de waarden van toegangsgegevens, de foutcode, het project-ID en de filterwaarden. Lossen de controles het probleem niet op, meld dan een probleem.

Gerelateerde pagina’s

Snelstart

Verstuur en lees het eerste veilige event.

CLI-handleiding

Gebruik exacte filters en JSON-uitvoer.

Een issue onderzoeken

Lees het issuebewijs voordat je de status wijzigt.

API-fouten

Herstel na elke foutcode.

Aan de slag

Concepten

Installeren en verzenden

Onderzoeken

CLI en agents

Ondersteuning

Problemen oplossen bij ontbrekende applicatielogs

Met de snelle controles beginnen

Ontbrekende eerste telemetrie herstellen

Eén veilig testevent versturen

Ontbrekende logs vinden

De dashboardweergave controleren

Issues en traces controleren

CLI- en API-fouten afhandelen

Een gecompromitteerd account beveiligen

Veilig problemen oplossen

Gerelateerde pagina’s

Snelstart

CLI-handleiding

Een issue onderzoeken

API-fouten

​Met de snelle controles beginnen

​Ontbrekende eerste telemetrie herstellen

​Eén veilig testevent versturen

​Ontbrekende logs vinden

​De dashboardweergave controleren

​Issues en traces controleren

​CLI- en API-fouten afhandelen

​Een gecompromitteerd account beveiligen

​Veilig problemen oplossen

​Gerelateerde pagina’s

Snelstart

CLI-handleiding

Een issue onderzoeken

API-fouten

Met de snelle controles beginnen

Ontbrekende eerste telemetrie herstellen

Eén veilig testevent versturen

Ontbrekende logs vinden

De dashboardweergave controleren

Issues en traces controleren

CLI- en API-fouten afhandelen

Een gecompromitteerd account beveiligen

Veilig problemen oplossen

Gerelateerde pagina’s