AppSignal für Ruby: Install - AppSignal Documentation

Diese Dokumentation sagt Ihnen alles, was Sie über die Installation von AppSignal über das Kommandozeilen-Tool wissen müssen.

Beschreibung

Das Kommandozeilen-Tool hilft Ihnen beim Einrichten der Konfiguration für Ihre Anwendung. Die Integration mit Ruby-Anwendungen, die nicht das Rails-Framework verwenden, erfordert zusätzliche Schritte, da der AppSignal-Installer nicht weiß, wie Ihre Anwendung eingerichtet ist. Wir empfehlen unseren Installationsleitfaden, wenn Sie eine neue Anwendung zu AppSignal hinzufügen. Bei Rails-Anwendungen erfolgt die vollständige Integration automatisch. Für andere Frameworks beachten Sie bitte unsere Integrationsdokumentation. Sobald die Installation abgeschlossen ist, führen Sie den Befehl Demo-Tool aus, um zu überprüfen, ob die Installation erfolgreich war. Der Demo-Tool-Befehl sendet Beispieldaten aus Ihrer Anwendung an die AppSignal-Server, was Ihnen hilft zu überprüfen, ob alles richtig funktioniert.

Konfigurationsmethoden

Es gibt zwei Konfigurationsmethoden, die vom Kommandozeilen-Installer bereitgestellt werden:

Konfiguration über eine Konfigurationsdatei
Konfiguration über Umgebungsvariablen.

1. Konfigurationsdatei

AppSignal kann über eine Konfigurationsdatei namens appsignal.rb oder appsignal.yml konfiguriert werden, die sich in Ihrer Anwendung im Verzeichnis config/ befindet. Wenn Sie diese Option wählen, schreibt unser Installer Ihre Konfiguration in diese Datei. Wenn Sie Ihre AppSignal-Integration über die Konfigurationsdatei konfigurieren, wird der Push API-Schlüssel, den Sie dem Installer angeben, in die Konfigurationsdatei appsignal.yml geschrieben. Wir empfehlen nicht, diesen Schlüssel zu Versionskontrollsystemen wie Git, SVN oder Mercurial hinzuzufügen. Verwenden Sie stattdessen die Umgebungsvariable APPSIGNAL_PUSH_API_KEY, um Ihren API-Schlüssel zu speichern. Mehr über die Konfiguration Ihrer Anwendung erfahren Sie in unserer Konfigurationsdokumentation.

2. Umgebungsvariablen

AppSignal kann über System-Umgebungsvariablen konfiguriert werden. Wenn Sie diese Option wählen, wird keine Konfigurationsdatei generiert. Mehr über die Konfiguration Ihrer Anwendung erfahren Sie in unserer Konfigurationsdokumentation.

Verwendung

Um appsignal über die Kommandozeile zu installieren, navigieren Sie zu Ihrem Projektverzeichnis und führen Sie folgenden Befehl aus:

appsignal install <Push API key>
# For example
appsignal install 1234-1234-1234-1234

Der “Push API-Schlüssel” Ihrer Anwendung wird im Installations-Wizard angezeigt und ist auch im Administrationsbereich der Einstellungen Ihrer Organisation oder über diesen Link verfügbar.