Soorten projectsleutels
Elke projectsleutel hoort bij één project. Het soort bepaalt wat de sleutel kan. Je kiest het soort met--kind als je logbrew projects keys create
uitvoert.
De soorten
sdk, server, cli en browser zijn ingest-sleutels. Kies het
soort dat aangeeft waar de sleutel draait. Gebruik browser voor code die in
een browser draait. Zet een leessleutel nooit in browsercode, een mobiele app
of een openbare bundle.
Accounttoegang is iets anders. logbrew login geeft de CLI de toegang van je
account. Gebruik accounttoegang nooit als SDK-configuratie. Met een
leessleutel kun je niet inloggen op de CLI of het dashboard.
Je testevent teruglezen
1
Maak een leessleutel
Voor deze stap heb je accounttoegang nodig. Voer De CLI schrijft de sleutel naar een nieuw bestand dat alleen de eigenaar
kan lezen. De CLI toont nooit de sleutel of het bestandspad.
logbrew status --json
uit en controleer of het geauthenticeerde accounttoegang meldt.--ingest-key-file is de bestandsoptie voor elk soort sleutel. Het
doelbestand mag nog niet bestaan.Controlepunt: het resultaat bevat status: "created" en
ingest_key.kind: "read". Noteer ingest_key.id. Die heb je nodig om de
sleutel in te trekken.2
Verzend een testevent
Verzend één veilige testlog vanuit je app met de ingest-sleutel van het
project. Volg de stappen voor je runtime in de snelstart
of de handleiding voor SDK-integratie. Wil je
ook issues testen? Verzend dan één afgehandelde testfout.Controlepunt: de SDK meldt een
2xx-status. Dit laat zien dat LogBrew
het request heeft geaccepteerd. Ga door naar de volgende stap.3
Lees het event terug
Laad de leessleutel in Elke leesopdracht geeft alleen gegevens van het project van de sleutel
terug. Je hebt
LOGBREW_TOKEN, alleen voor deze shell. Lees daarna
het project:--project dus niet nodig. Voeg --service,
--environment of --release toe zodat het resultaat bij het testevent
past.Controlepunt: de testlog verschijnt met je service, omgeving en
release. Een testfout verschijnt als issue. Dit laat zien dat LogBrew de
events heeft opgeslagen en dat je ze kunt lezen.Voer unset LOGBREW_TOKEN uit als je klaar bent. De CLI gebruikt dan weer
je accounttoegang.4
Trek de leessleutel in
Trek de sleutel in als je hem niet meer nodig hebt. Voor deze stap heb je
accounttoegang nodig. Verwijder Controlepunt: het resultaat bevat
LOGBREW_TOKEN dus eerst.status: "revoked". De sleutel werkt
niet meer vanaf het volgende request.Een CI-job of agent leestoegang geven
Houd een leessleutel aan voor een CI-job of een coding agent die één project leest. Bewaar de sleutel in de secretmanager van het CI-systeem of de agentomgeving. Stel hem beschikbaar alsLOGBREW_TOKEN. Zet de sleutel niet
in een prompt, een repository of de uitvoer van een opdracht.
De job of agent kan dan leesopdrachten uitvoeren zoals
logbrew issues --json, logbrew issue "<issue_id>" --json en
logbrew read trace "<trace_id>". Opdrachten voor projecten, sleutels en
accounts hebben accounttoegang nodig. API-clients sturen de sleutel als
bearer-token mee naar de telemetrie-leesroutes in de
Telemetrie-API.
Gebruik één sleutel per job of agent. Dan kun je één sleutel intrekken zonder
dat de andere er last van hebben.
Een mislukte leesopdracht oplossen
Ontbreekt de telemetrie nog steeds? Gebruik dan de
controles voor de eerste telemetrie.
Zie Een ingest-sleutel roteren om een ingest-sleutel te vervangen.
