Zum Hauptinhalt springen
Bevor die CLI auf Ihre Daten zugreifen kann, müssen Sie sich anmelden. Sie verwendet OAuth, eine browserbasierte Anmeldung, sodass Sie niemals einen Token von Hand kopieren oder speichern müssen. Sie können jederzeit mit appsignal-cli auth status überprüfen, ob Sie angemeldet sind.

​
Anmelden

Führen Sie aus:
Shell
appsignal-cli auth login
Dies öffnet Ihren Browser, um die CLI mit Ihrem AppSignal-Konto zu autorisieren, und übergibt dann die Kontrolle über einen lokalen Callback unter http://127.0.0.1:9789/callback zurück. Sobald Sie zustimmen, speichert die CLI die Tokens und erneuert sie für Sie, sodass Sie sich nicht erneut anmelden müssen.
Der Browser-Flow benötigt einen Browser auf derselben Maschine wie die CLI.

​
Eine Standard-Organisation festlegen

Wenn Sie zu mehr als einer Organisation gehören, legen Sie während der Anmeldung eine Standard-Organisation fest, sodass Sie sie nicht bei jedem Befehl übergeben müssen:
Shell
appsignal-cli auth login --org <YOUR_ORG_SLUG>
Ihr Organisations-Slug ist der Kurzname in Ihrer AppSignal-URL: appsignal.com/<org-slug>. Das Ausführen von appsignal-cli apps list nach Ihrer Anmeldung speichert ebenfalls die Organisation Ihres Kontos als Standard.

​
Ihren Status prüfen

Um zu sehen, ob Sie angemeldet sind und welche Konfiguration die CLI liest, führen Sie aus:
Shell
appsignal-cli auth status
appsignal-cli about zeigt denselben Authentifizierungsstatus zusammen mit Ihrer Version, Ihrem Endpoint und Ihrer Standard-Organisation.

​
Abmelden

Um Ihre gespeicherten Anmeldedaten zu entfernen:
Shell
appsignal-cli auth logout

​
Wo Ihre Anmeldedaten gespeichert werden

Die CLI speichert Ihre Anmeldedaten in einer globalen Konfigurationsdatei im Standard-Konfigurationsverzeichnis Ihres Betriebssystems. Der genaue Pfad variiert je nach Betriebssystem, führen Sie also appsignal-cli auth status aus, um den Pfad zu sehen, den die CLI verwendet.

​
Projektlokale Konfiguration

Sie können die Konfiguration auch neben einem Projekt aufbewahren, in einer .appsignal.toml-Datei im Projektverzeichnis. Erstellen Sie eine mit:
Shell
appsignal-cli project init
Eine projektlokale Konfiguration ist praktisch, um ein Repository an eine bestimmte Organisation zu binden. Um die Standard-Organisation für das Projekt beim Erstellen festzulegen:
Shell
appsignal-cli project init --org <YOUR_ORG_SLUG>
Wenn eine projektlokale .appsignal.toml vorhanden ist, verwendet die CLI die nächstliegende als einzige Konfiguration für Befehle, die in diesem Verzeichnis oder seinen Unterverzeichnissen ausgeführt werden. Für die vollständige Liste der Konfigurationsschlüssel und wie sie aufgelöst werden, siehe Konfiguration.
project init kopiert Ihre globalen OAuth-Anmeldedaten nicht in die Projektkonfiguration. Führen Sie nach dem Erstellen appsignal-cli auth login erneut innerhalb des Projekts aus, um projektspezifische Anmeldedaten einzurichten.

​
Nächste Schritte

Sie sind angemeldet. Listen Sie als Nächstes Ihre Anwendungen auf, um die Apps zu finden, die Sie abfragen werden.