Skip to main content
Een project is de toegangsgrens voor telemetrie. Elk geaccepteerd signaal hoort bij één project, en elke leesopdracht kan op project filteren. Gebruik een apart project als telemetrie een aparte eigenaar of toegangsgrens nodig heeft. Voor de meeste teams is dat één app, service of productgebied. Een repository hoeft niet overeen te komen met één project. Een monorepo kan meerdere services naar één project verzenden. Gebruik servicenamen om ze uit elkaar te houden.

​
Project, service, omgeving

​
Een project instellen

Installeer de CLI. Voer logbrew status --json uit om de toegang van je account te lezen. Is de toegang niet geldig? Dan voert een mens logbrew login uit. Met een ingest-sleutel van een project kun je niet inloggen.
1

Maak of kies een project

Bekijk eerst de lijst met je projecten. Maak alleen een project als het nog niet bestaat.
De CLI schrijft de ingest-sleutel naar een nieuw bestand dat alleen de eigenaar kan openen. De CLI toont nooit de sleutel of het bestandspad. Is het resultaat niet duidelijk? Voer dan exact dezelfde opdracht opnieuw uit. Wijzig de projectnaam en het sleutelbestand niet. De CLI hergebruikt de identiteit van het openstaande request. De Snelstart laat zien hoe je het project-ID uit het resultaat leest.Registreer voor een bestaand project de installatiestatus:
Gebruik logbrew projects keys create om nog een ingest-sleutel voor een bestaand project te maken. De handleiding voor het roteren van ingest-sleutels toont de opdracht.logbrew setup --create-project toont alleen de helptekst. De opdracht maakt geen project.
2

Stel servicenamen in de SDK in

Gebruik namen uit je repository en deployment, zoals api, worker, web, ios of checkout-api. Een servicenaam is een label en kiest geen project. De ingest-sleutel bepaalt het project. Een service hernoemen verplaatst geen opgeslagen events. Vind je een event niet? Controleer dan het project en de ingest-sleutel die de applicatie gebruikt, voordat je nog een project maakt.
3

Gebruik standaardomgevingen

Gebruik production, staging, preview en local. Gebruikt je deployment andere namen? Gebruik die dan consequent. Een omgevingsnaam mag geen spaties, / of backslash bevatten.
4

Verzend een testevent en lees het

Configureer de SDK met de ingest-sleutel van het project, zoals de handleiding voor SDK-integratie beschrijft. Een project maken installeert geen SDK in je applicatie. Houd de sleutel buiten versiebeheer. Stel de service, de omgeving en de release in de applicatie in. Verzend één veilig event en lees het daarna:
Elk signaal heeft een eigen lijst. Een lege lijst met logs betekent niet dat het project geen issues of traces heeft.Kies in het dashboard hetzelfde project en een tijdsbereik waarin het testevent valt. Controleer of de filters voor service, omgeving en release bij het event passen.

​
Projectinstallatie diagnosticeren

Lees de installatiestatus met de projectdoctor. Leid de installatiestatus niet af uit lokale bestanden of een lege logquery.
De CLI geeft een rapport terug met status, checks en next. Exitcode 0 toont niet aan dat alle controles zijn geslaagd. Lees elk item in checks. Zie Een doctor-rapport van een project lezen.

​
Directe response van de API

API-clients roepen GET /api/projects/{project_id}/doctor aan met accountauthenticatie. Het endpoint heeft geen queryparameters en geen requestbody. Gebruik voor deze leesactie nooit een ingest-sleutel van een project. Een response met 200 heeft deze velden: project_id, state, setup_status, setup_acknowledged, has_active_ingest_key, first_telemetry_seen_at, last_seen_at, last_signal, next en next_action. Tijdstempels zijn RFC3339 of null. last_signal is een samenvatting die veilig te tonen is, geen ruw signaal. De doctor controleert eerst de ingest-sleutel. Een project zonder actieve ingest-sleutel krijgt needs_ingest_key, ongeacht de installatiestatus. setup_status is created, setup_started, sdk_seen, first_telemetry_seen of active. setup_acknowledged is alleen true bij de laatste drie waarden. created geeft needs_setup. setup_started en sdk_seen geven needs_telemetry. first_telemetry_seen en active geven ready. Mislukt het lezen nog steeds? Meld dan een probleem. Voeg geen toegangsgegevens, headers, inhoud van signalen, klantgegevens, lokale paden of broncode toe.

​
Een project archiveren of verwijderen

Archiveer een project om het uit de lijst met actieve projecten te halen:
De opdracht vereist --yes. Na het archiveren accepteren de ingest-sleutels van het project geen nieuwe telemetrie meer. De API-route is DELETE /api/projects/{project_id}. Die geeft 204 terug zonder body. Vraag gearchiveerde projecten op met GET /api/projects/archived. Herstel een project met POST /api/projects/{project_id}/restore. Ook die route geeft 204 terug. Verwijder een project alleen definitief als je het zeker weet:
Herhaal het exacte project-ID na --confirm. Een geaccepteerd request maakt het project direct inactief en plant de definitieve verwijdering in. Daarna kun je het project niet meer herstellen.

​
Een ingest-sleutel roteren

De handleiding voor het roteren van ingest-sleutels beschrijft hoe je de sleutel vervangt, deployt, test en intrekt.