Zum Hauptinhalt springen
Die AppSignal CLI bringt Ihre Monitoring-Daten in das Terminal, sodass Sie aus derselben Shell arbeiten können, in der Sie auch Ihre Tests und Deploys ausführen. Verfolgen Sie Logs in Echtzeit, durchsuchen Sie Vorfälle und schließen Sie sie ab, und verwalten Sie Trigger der Anomalie-Erkennung – alles ohne die Web-UI zu öffnen. Es handelt sich um eine einzelne, in Rust geschriebene Binary, sodass nichts weiter installiert werden muss. Die CLI ist für zwei Arten von Nutzern konzipiert: Menschen und KI-Agenten. Standardmäßig gibt jeder Befehl menschenlesbare Ausgaben aus; mit --output json gibt er stattdessen maschinenlesbares JSON zurück. Mit anderen Worten: Dasselbe Werkzeug, zu dem Sie während eines Vorfalls greifen, kann auch strukturierte Daten an einen Coding-Agenten liefern. Es enthält sogar einen AppSignal Agent Skill: eine Reihe von Anweisungen, die einem Agenten wie Claude oder Codex beibringen, wie die CLI zu verwenden ist. Installieren Sie ihn mit appsignal-cli skill install.
Die CLI spricht dieselben AppSignal-Daten an wie die App-UI und AppSignal MCP. Sie ist ein Gateway zu Daten, die AppSignal bereits hat. Wenn Ihre App keine Logs sendet, zeigt logs tail keine an.

​
Was Sie tun können

  • Logs: Logzeilen verfolgen, sobald sie eintreffen, oder über einen Zeitraum mit der Abfragesyntax von AppSignal suchen. Filtern Sie nach Schweregrad oder Quelle, wenden Sie gespeicherte Log-Ansichten an und listen Sie die Ansichten und Quellen einer App auf. Erstellen und verwalten Sie log-basierte Metriken und log-basierte Trigger aus Ihren Logdaten.
  • Vorfälle: Listen Sie Exception-, Performance- und Anomalie-Vorfälle auf und durchsuchen Sie die Exception- und Performance-Vorfälle nach Name oder Nachricht; öffnen Sie die Details eines Vorfalls; aktualisieren Sie seinen Zustand, Schweregrad oder die Zuständigen; und fügen Sie Notizen hinzu.
  • Trigger: Listen, erstellen, aktualisieren und archivieren Sie Trigger der Anomalie-Erkennung.
  • Dashboards: Listen, erstellen und aktualisieren Sie die Dashboards Ihrer App.
  • Apps: Listen Sie Ihre Anwendungen auf, finden Sie eine App nach Namen und inspizieren Sie ihre Benutzer, Notifier, Namespaces, Dashboards und Deploy-Marker.
  • Projekt-Konfiguration: Erstellen Sie eine projektlokale Konfiguration, damit Befehle, die in einem Repository ausgeführt werden, standardmäßig auf die richtige Organisation verweisen.
  • Agent Skill: Installieren Sie das mitgelieferte AppSignal-Skill in Ihrem KI-Agenten, aktualisieren Sie es und prüfen Sie, ob es aktuell ist.

​
Globale Flags

Diese Flags funktionieren bei jedem Befehl:
FlagBeschreibung
--output <value> (-o)Ergebnisse als human (Standard) oder json ausgeben. --format ist ein Synonym.
--help (-h)Zeigt Nutzung, Unterbefehle und Optionen für jeden Befehl an (zum Beispiel appsignal-cli logs tail --help).
Sie können --output (oder --format) vor oder nach dem Unterbefehl angeben. Befehlsergebnisse gehen in dem von Ihnen gewählten Format an die Standardausgabe; Statusmeldungen gehen immer an die Standardfehlerausgabe, sodass ein --output json-Stream gültiges JSON bleibt, das Sie in ein anderes Tool weiterleiten können.

​
Installation

Die CLI läuft unter macOS und Linux, sowohl auf Intel- (x86_64) als auch auf Apple-Silicon-/ARM-Maschinen (arm64). Auf musl basierende Linux-Distributionen wie Alpine werden ebenfalls unterstützt.
Installieren Sie die Formula. Homebrew bindet appsignal/appsignal-cli automatisch ein:
brew install appsignal/appsignal-cli/appsignal-cli
Um später zu aktualisieren, führen Sie aus:
brew upgrade appsignal-cli
Möchten Sie lieber kein Skript in Ihre Shell pipen? Laden Sie die Binary für Ihre Plattform direkt aus dem neuesten Release herunter.

​
Installation überprüfen

Überprüfen Sie, ob die CLI in Ihrem PATH ist:
Shell
appsignal-cli --version
Führen Sie dann appsignal-cli about aus, um eine Übersicht über Ihre Einrichtung zu erhalten, einschließlich Version, Endpunkt, Standardorganisation und Authentifizierungsstatus:
Shell
appsignal-cli about
Bevor Sie sich authentifizieren, zeigt es Auth: Not authenticated an und verweist Sie auf die als Nächstes auszuführenden Befehle.

​
Nächste Schritte

Sie haben die CLI installiert, aber sie kann Ihre Daten erst erreichen, wenn Sie sich anmelden. Gehen Sie zu Authentifizierung, um die CLI mit Ihrem AppSignal-Konto zu verbinden.