Zum Hauptinhalt springen
Die meisten CLI-Befehle wirken auf eine einzelne Anwendung in einer einzelnen Umgebung, daher müssen Sie, bevor Sie Logs verfolgen oder Incidents auflisten, wissen, welche Apps Sie haben und wie Sie sie benennen. Diese Seite behandelt das Auflisten Ihrer Anwendungen, das Festlegen einer Standard-Organisation und das Inspizieren der Ressourcen einer App.

​
Organisationen

Ihre Anwendungen befinden sich unter einer Organisation, die durch ihren Slug identifiziert wird: der Kurzname in Ihrer AppSignal-URL, appsignal.com/<org-slug>. Die CLI arbeitet mit der Organisation, die mit Ihrem angemeldeten Konto verknüpft ist.

​
Eine Standard-Organisation festlegen

Die meisten Befehle fallen auf eine Standard-Organisation zurück, sodass Sie nicht jedes Mal --org übergeben müssen. Das Ausführen von appsignal-cli apps list ermittelt die Organisation Ihres Kontos und speichert sie als Standard. Um sie selbst festzulegen oder zu ändern:
Shell
appsignal-cli apps set-org --org <YOUR_ORG_SLUG>
So sehen Sie den aktuellen Standard:
Shell
appsignal-cli apps show-org
Sie können den Standard auch während der Anmeldung mit appsignal-cli auth login --org <YOUR_ORG_SLUG> festlegen oder pro Projekt mit appsignal-cli project init --org <YOUR_ORG_SLUG>. Siehe Authentifizierung für die Beziehung zwischen den globalen und projektlokalen Konfigurationen.

​
Anwendungen

Um die Anwendungen für die Organisation Ihres Kontos aufzulisten:
Shell
appsignal-cli apps list
Dies speichert auch Ihre Organisation als Standard für spätere Befehle, sodass Sie ihnen --org nicht übergeben müssen.

​
Eine App anhand des Namens finden

Um eine bestimmte App anhand des Namens zu suchen, optional eingeschränkt auf eine Umgebung:
Shell
appsignal-cli apps find --name "MyApp" --environment production
Name und Umgebung sind beide case-insensitive. Dies ist der schnellste Weg, den genauen App-Namen und die Umgebung zu bestätigen, die andere Befehle erwarten.

​
Details zu einer App anzeigen

Wenn Sie die ID einer App kennen, können Sie ihre Details direkt abrufen:
Shell
appsignal-cli apps info --app-id <APP_ID>

​
Wie Befehle eine App identifizieren

Befehle, die auf eine einzelne App wirken, akzeptieren sie auf zwei Arten:
  • Über den Namen: --app "MyApp". Fügen Sie --environment production nur hinzu, wenn mehr als eine App den Namen teilt.
  • Über die ID: --app-id <APP_ID>, der Wert aus der Spalte ID von appsignal-cli apps list (eine lange hexadezimale Zeichenkette). Eine ID identifiziert eine bestimmte App und Umgebung für sich allein, daher übergeben Sie damit kein --environment.
Verwenden Sie das, was Sie haben. Ein Name ist leichter zu lesen und zu tippen; die ID ist eindeutig und in Skripten praktisch.

​
Ressourcen einer App inspizieren

Die apps resources-Befehle zeigen die Konfiguration und Metadaten, die einer App zugeordnet sind:
BefehlZeigt
apps resources allJede Ressource unten, in einem Aufruf
apps resources usersBenutzer mit Zugriff auf die App
apps resources notifiersKonfigurierte Notifiers
apps resources namespacesDie Namespaces der App
apps resources dashboardsCustom Dashboards
apps resources deploy-markersLetzte Deploy Marker
Jeder akzeptiert denselben App-Selektor wie andere Befehle, entweder --app mit --environment oder --app-id, und verwendet Ihre Standard-Organisation, sofern Sie nicht --org übergeben. Zum Beispiel, um die Namespaces für eine App zu sehen:
Shell
appsignal-cli apps resources namespaces --app "MyApp" --environment production
Um alles auf einmal als JSON abzurufen, zur Weitergabe an ein anderes Tool:
Shell
appsignal-cli apps resources all --app "MyApp" --environment production --output json

​
Nächste Schritte

Sobald Sie den Namen und die Umgebung einer App kennen, können Sie damit beginnen, sie abzufragen. Inspizieren Sie ihre Incidents oder verfolgen Sie ihre Logs vom Terminal aus.