> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal CLI

> Fragen Sie Ihre AppSignal-Daten vom Terminal aus ab: Logs verfolgen, Vorfälle inspizieren und Trigger verwalten, ohne Ihre Shell zu verlassen.

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](/cli/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`.

<Note>
  Die CLI spricht dieselben AppSignal-Daten an wie die App-UI und [AppSignal MCP](/mcp-server). Sie ist ein Gateway zu Daten, die AppSignal bereits hat. Wenn Ihre App keine Logs sendet, zeigt `logs tail` keine an.
</Note>

## Was Sie tun können

* **Logs:** Logzeilen verfolgen, sobald sie eintreffen, oder über einen Zeitraum mit der [Abfragesyntax](/logging/query-syntax) 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](/cli/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](/cli/configuration), 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:

| Flag                      | Beschreibung                                                                                                  |
| ------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `--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.

<Tabs>
  <Tab title="Homebrew">
    Installieren Sie die Formula. Homebrew bindet `appsignal/appsignal-cli` automatisch ein:

    ```sh theme={null}
    brew install appsignal/appsignal-cli/appsignal-cli
    ```

    Um später zu aktualisieren, führen Sie aus:

    ```sh theme={null}
    brew upgrade appsignal-cli
    ```
  </Tab>

  <Tab title="Installationsskript (macOS & Linux)">
    Installieren Sie die neueste Version mit dem untenstehenden Einzeiler. Er benötigt Superuser-Rechte, um die Binary in den Systempfad zu installieren, und überprüft den Download anhand des veröffentlichten `SHA256SUMS`-Manifests vor der Installation:

    ```sh theme={null}
    curl -sSL https://github.com/appsignal/appsignal-cli/releases/latest/download/install.sh | sudo sh
    ```

    Führen Sie denselben Befehl jederzeit erneut aus, um auf die neueste Version zu aktualisieren.
  </Tab>
</Tabs>

<Note>
  Möchten Sie lieber kein Skript in Ihre Shell pipen? Laden Sie die Binary für Ihre Plattform direkt aus dem [neuesten Release](https://github.com/appsignal/appsignal-cli/releases/latest/) herunter.
</Note>

### Installation überprüfen

Überprüfen Sie, ob die CLI in Ihrem `PATH` ist:

```sh Shell theme={null}
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:

```sh Shell theme={null}
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](/cli/authentication), um die CLI mit Ihrem AppSignal-Konto zu verbinden.