Sentry CLI

Sentry CLI ist das Kommandozeilenwerkzeug von Sentry zur Integration von Entwicklungs- und Releaseabläufen mit Sentry. Dieses Paket installiert die ausführbare Datei sentry-cli aus getsentry/sentry-cli. Es eignet sich für Entwickler und CI/CD-Verantwortliche, die Artefaktuploads, Releaseverwaltung und automatisierten Zugriff auf unterstützte Sentry-Daten benötigen.

Entwicklungs- und Releaseaufgaben

Das Werkzeug kann Debuginformationsdateien und JavaScript-Source-Maps hochladen, Releases erstellen und verwalten, Commits und Bereitstellungsinformationen zuordnen sowie unterstützte Issue- und Logdaten verarbeiten. Befehle für Builds und Snapshots dienen unterstützten Sentry-Abläufen und sind kein allgemeines lokales Anwendungsbau- oder Bildschirmaufnahmeprogramm.

Das Hochladen von Debugsymbolen und Source-Maps hilft Sentry, Stacktraces aufzulösen und Ereignisse Quellcode zuzuordnen. Die CLI ersetzt kein Sentry SDK in der überwachten Anwendung, erstellt keinen Monitoringserver und instrumentiert nicht automatisch jedes Programm auf dem Computer. Artefaktinhalte, Debugkennungen und Releasenamen müssen zur Build- und SDK-Konfiguration der Anwendung passen.

Installation und erste Verwendung

Installieren Sie dieses Paket mit brew install --cask sentry-cli. Der Cask legt die Plattformbinärdatei als sentry-cli in den ausführbaren Pfad von Homebrew; er installiert keine Desktop-App mit grafischem Arbeitsbereich. Verwenden Sie sentry-cli --version und sentry-cli --help, um installierte Version und verfügbare Befehle zu prüfen, bevor Sie einen Arbeitsablauf konfigurieren.

Wählen Sie die passende Mac-Architektur: Der erfasste Download ist Darwin arm64 für Apple Silicon, mit separater Darwin x86_64-Binärdatei für Intel. Offizielle Releases enthalten auch Linux- und Windows-Builds, und der Cask führt Linux-Varianten auf. Eine native Binärdatei benötigt nicht allein deshalb npm oder Node.js, weil auch eine npm-Installationsmethode existiert. Das Kompilieren aus Quellcode hat eigene Rust/Cargo- und native Buildwerkzeuganforderungen.

Die offizielle Darwin arm64-Binärdatei 3.8.0 ist laut HTTP HEAD 13,637,040 Byte groß. Dies ist die übertragene Binärgröße ohne hochgeladene Artefakte, lokale Buildergebnisse und Caches. Der erfasste Cask deklariert keine zusätzliche Abhängigkeit, keinen kollidierenden Cask und keine numerische macOS-Mindestversion. Prüfen Sie das jeweilige Release und die Hostkompatibilität, statt aus der Plattformliste eine universelle Mindestversion abzuleiten.

Authentifizierung und Konfiguration

Sentry-Operationen benötigen gewöhnlich eine autorisierte Sentry-Organisation bzw. ein Projekt sowie zum Befehl passende Zugangsdaten. Konfigurieren Sie Organisations- und Projekt-Slugs über die dokumentierten Optionen oder SENTRY_ORG und SENTRY_PROJECT und verwenden Sie SENTRY_AUTH_TOKEN für unterstützte Tokenauthentifizierung. SENTRY_URL kann einen unterstützten selbst gehosteten Endpunkt statt des gehosteten Dienstes wählen.

Die Konfiguration kann aus Kommandozeilenoptionen, Umgebungsvariablen, .env-Dateien und .sentryclirc-Dateien stammen. Das Werkzeug sucht vom Arbeitsverzeichnis aufwärts nach Konfiguration und liest außerdem Vorgaben aus .sentryclirc im Benutzerverzeichnis. Stellen Sie sicher, dass Token und Endpunkte zum vorgesehenen Dienst und Projekt gehören, besonders in Repositorys mit geerbter Konfiguration. Nutzen Sie Geheimnisspeicher in CI und schützen Sie jede Konfigurationsdatei mit Zugangsdaten; vermeiden Sie echte Token in eingecheckten Beispielen oder Logs.

Ein DSN identifiziert ein Ziel zur Ereignisaufnahme für unterstützte Befehle und ersetzt kein API-Token mit Release- oder Artefaktberechtigungen. Verwenden Sie nur die für die gewählte Operation nötigen Rechte und prüfen Sie die Authentifizierungsanforderungen des Befehls. Die Binärinstallation erstellt kein Konto, gewährt keine Organisationsmitgliedschaft und umgeht keine Dienstberechtigungen.

Entfernte Änderungen und Datenverarbeitung

Upload- und Releasebefehle können Source-Maps, Debugsymbole, Builddateien, Snapshots oder zugehörige Metadaten an den gewählten Sentry-Dienst senden. Diese Artefakte können Quellpfade oder andere sensible Informationen enthalten; prüfen Sie vor dem Upload die gesendeten Inhalte und das Zielkonto. Lokale Befehle laufen mit den Rechten des aufrufenden Nutzers, Serveroperationen verwenden die bereitgestellten Sentry-Zugangsdaten.

Manche Befehle erstellen, ändern oder entfernen serverseitige Releaseinformationen. Prüfen Sie Optionen und Ziele vor der Aufnahme in Automatisierungen. Dies ist ein Entwicklerwerkzeug, keine Garantie, dass jeder Befehl nur liest oder lokale Dateien und Projektmetadaten standardmäßig privat bleiben.

Serverkompatibilität und Projektstatus

Die README des Tags unterstützt Sentry SaaS und selbst gehostetes Sentry 24.11.1 oder neuer. Für ältere selbst gehostete Versionen verweist sie auf CLI 2.58.6 und weist darauf hin, dass nur offiziell unterstützte Serverversionen Support erhalten. Neuere CLI-Funktionen können serverseitige Fähigkeiten benötigen; Buildbefehle sind laut Kompatibilitätsleitfaden auf Sentry SaaS beschränkt.

Das aktuelle Projekt-Repository kündigt an, dass diese CLI nicht mehr aktiv entwickelt wird und durch die neuere CLI in getsentry/toolkit ersetzt werden soll. Funktionswünsche und die meisten neuen Issues werden an das neue Projekt verwiesen; Fehlerbehebungen des alten Projekts konzentrieren sich auf konkrete Migrationshindernisse. Dieses installierte Paket sentry-cli ist das bestehende Werkzeug; eine separate neuere CLI wird nicht automatisch installiert und ist kein garantierter befehlsgleicher Ersatz.

Kosten und Lizenz

Die CLI lässt sich ohne separates Desktop-Werkzeugabonnement herunterladen. Gehostete Sentry-Konten haben eigene Tarife, Nutzungslimits und Preise; Selbsthosting hat Infrastruktur- und Betriebsanforderungen. Eine CLI-Installation enthält weder ein gehostetes Dienstabonnement noch unbegrenzte Ereignis-, Artefakt- oder Buildkapazität.

Der Quellcode 3.8.0 steht unter Functional Source License 1.1 mit künftiger MIT-Lizenz (FSL-1.1-MIT). Sie erlaubt die darin definierten Zwecke und beschränkt konkurrierende Nutzungen; die MIT-Rechteeinräumung wird für eine Version am zweiten Jahrestag ihrer Verfügbarkeit wirksam. Behandeln Sie einen neu veröffentlichten Build nicht bereits als uneingeschränkt MIT-lizenziert und nehmen Sie nicht an, dass alle Sentry-Serverprodukte dieselbe CLI-Lizenz verwenden. Abhängigkeits- und Markenbedingungen bleiben separat.

Das Symbol ist das offizielle Markenzeichen der Sentry-Organisation. Es gibt keinen eigenständigen GUI-Screenshot: Dieses Paket wird im Terminal verwendet, und in der untersuchten CLI-Dokumentation wurde keine geeignete offizielle Terminalabbildung festgestellt.

Quellen: Projekt-Tag und Kompatibilität, CLI-Dokumentation, Authentifizierung und Konfiguration, Offizielles Änderungsprotokoll, FSL-Lizenz im Tag, Aktueller Projektstatus, Sentry-Tarife.