Arten von Projektschlüsseln
Jeder Projektschlüssel gehört zu genau einem Projekt. Seine Art legt fest, was er kann. Sie wählen die Art mit--kind, wenn Sie
logbrew projects keys create ausführen.
Die Arten
sdk, server, cli und browser sind Ingest-Schlüssel. Wählen
Sie die Art, die nennt, wo der Schlüssel läuft. Verwenden Sie browser für
Code, der im Browser läuft. Legen Sie einen Leseschlüssel nie in Browser-Code,
eine mobile App oder ein öffentliches Bundle.
Kontozugriff ist etwas anderes. logbrew login gibt der CLI den Zugriff Ihres
Kontos. Verwenden Sie Kontozugriff nie als SDK-Konfiguration. Ein
Leseschlüssel kann sich nicht bei der CLI oder im Dashboard anmelden.
Testereignis zurücklesen
1
Leseschlüssel erstellen
Für diesen Schritt brauchen Sie Kontozugriff. Führen Sie
Die CLI schreibt den Schlüssel in eine neue Datei, die nur der Eigentümer
lesen kann. Sie gibt weder den Schlüssel noch den Dateipfad aus.
logbrew status --json aus. Prüfen Sie, dass der Status einen
authentifizierten Kontozugriff meldet.--ingest-key-file ist die Dateioption für jede Schlüsselart. Die
Zieldatei darf noch nicht existieren.Kontrollpunkt: Das Ergebnis enthält status: "created" und
ingest_key.kind: "read". Notieren Sie ingest_key.id. Sie brauchen
den Wert, um den Schlüssel zu widerrufen.2
Testereignis senden
Senden Sie aus Ihrer Anwendung ein sicheres Test-Log mit dem
Ingest-Schlüssel des Projekts. Folgen Sie den Schritten für Ihre Laufzeit
im Schnellstart oder im
Leitfaden zur SDK-Integration. Um auch Issues
zu testen, senden Sie einen behandelten Testfehler.Kontrollpunkt: Das SDK meldet einen
2xx-Status. Das zeigt, dass
LogBrew die Anfrage angenommen hat. Fahren Sie mit dem nächsten Schritt
fort.3
Ereignis zurücklesen
Laden Sie den Leseschlüssel nur für diese Shell in Jeder Lesezugriff liefert nur Daten aus dem Projekt des Schlüssels. Sie
brauchen also kein
LOGBREW_TOKEN. Lesen
Sie dann das Projekt:--project. Fügen Sie --service, --environment
oder --release hinzu, damit das Ergebnis zum Testereignis passt.Kontrollpunkt: Das Test-Log erscheint mit Ihrem Dienst, Ihrer
Umgebung und Ihrem Release. Ein Testfehler erscheint als Issue. Das
zeigt, dass LogBrew die Ereignisse gespeichert hat und dass Sie sie lesen
können.Führen Sie danach unset LOGBREW_TOKEN aus. Die CLI verwendet dann
wieder Ihren Kontozugriff.4
Leseschlüssel widerrufen
Widerrufen Sie den Schlüssel, wenn Sie ihn nicht mehr brauchen. Dieser
Schritt braucht Kontozugriff. Entfernen Sie deshalb zuerst
Kontrollpunkt: Das Ergebnis enthält
LOGBREW_TOKEN.status: "revoked". Der
Schlüssel funktioniert ab seiner nächsten Anfrage nicht mehr.Einem CI-Job oder Agent Lesezugriff geben
Verwenden Sie einen eigenen Leseschlüssel für einen CI-Job oder einen Coding-Agenten, der ein Projekt liest. Speichern Sie den Schlüssel im Secret-Speicher des CI-Systems oder der Agent-Umgebung. Stellen Sie ihn alsLOGBREW_TOKEN bereit. Legen Sie den Schlüssel nicht in einen Prompt, ein
Repository oder eine Befehlsausgabe.
Der Job oder Agent kann dann Lesebefehle wie logbrew issues --json,
logbrew issue "<issue_id>" --json und logbrew read trace "<trace_id>"
ausführen. Projekt-, Schlüssel- und Kontobefehle brauchen Kontozugriff.
API-Clients senden den Schlüssel als Bearer-Token an die Telemetrie-Lesezugriffe
der Telemetrie-API.
Verwenden Sie einen Schlüssel pro Job oder Agent. Dann können Sie einen
Schlüssel widerrufen, ohne die anderen zu beeinträchtigen.
Fehlgeschlagenen Lesezugriff beheben
Fehlt die Telemetrie weiterhin, nutzen Sie die
Prüfungen für die erste Telemetrie.
Wie Sie einen Ingest-Schlüssel ersetzen, steht unter
Ingest-Schlüssel rotieren.