Zum Hauptinhalt springen
Diese Dokumentation beschreibt, wie Sie den AppSignal Standalone Agent über ein Linux-Paket auf dem Host installieren, den Sie überwachen möchten, z. B. einer Datenbank oder einem Host ohne eine instrumentierte App, die darauf läuft. Wir sind dabei, den Standalone Agent auf Linux-Distributionen zu testen und zu paketieren, die bei unseren Kunden am beliebtesten sind. Lassen Sie es uns wissen, wenn Sie den Agenten auf einer Distribution ausführen möchten, die noch nicht unterstützt wird.

​
Betriebssystem

​
Debian und Ubuntu

Der Agent wurde auf Ubuntu LTS 14.04/16.04/18.04/20.04/22.04/24.04 und Debian 8/9/10/11/12 getestet. Stellen Sie zunächst sicher, dass die folgenden Pakete installiert sind. Alle folgenden Befehle benötigen Root-Berechtigungen; möglicherweise müssen Sie sudo verwenden. 
apt-get install curl gnupg apt-transport-https
Importieren Sie dann den GPG-Schlüssel von Packagecloud. Dies ist ein Dienst, den wir zum Hosten der Repositorys für uns verwenden. 
curl -L https://packagecloud.io/appsignal/agent/gpgkey | sudo apt-key add -
Erstellen Sie eine Datei namens /etc/apt/sources.list.d/appsignal_agent.list, die die Repository-Konfiguration unten für das von Ihnen verwendete Betriebssystem enthält.

​
Ubuntu

Stellen Sie sicher, dass Sie lunar in der appsignal_agent.list-Konfigurationsdatei unten durch den Namen Ihres Ubuntu-Releases ersetzen. Verwenden Sie die folgenden Release-Namen:
  • noble für Ubuntu 24.04
  • jammy für Ubuntu 22.04
  • focal für Ubuntu 20.04
  • bionic für Ubuntu 18.04
  • xenial für Ubuntu 16.04
  • trusty für Ubuntu 14.04
deb https://packagecloud.io/appsignal/agent/ubuntu/ lunar main
deb-src https://packagecloud.io/appsignal/agent/ubuntu/ lunar main

​
Debian

Stellen Sie sicher, dass Sie bookworm in der appsignal_agent.list-Konfigurationsdatei unten durch den Namen Ihres Debian-Releases ersetzen. Verwenden Sie die folgenden Release-Namen:
  • bookworm für Debian 12
  • bullseye für Debian 11
  • buster für Debian 10
  • stretch für Debian 9
  • jessie für Debian 8
deb https://packagecloud.io/appsignal/agent/debian/ bookworm main
deb-src https://packagecloud.io/appsignal/agent/debian/ bookworm main

​
Den Agenten installieren

Führen Sie anschließend apt update aus, um die neu hinzugefügten Pakete zu erhalten, und installieren Sie den Agenten. 
apt-get update
apt-get install appsignal-agent
Der Agent ist nun installiert. Als Nächstes folgt seine Konfiguration, damit er Daten an die richtige App in AppSignal meldet.

​
Red Hat Enterprise Linux/CentOS

Derzeit werden EL Version 7 und 8 unterstützt. Stellen Sie zunächst sicher, dass die folgenden Pakete installiert sind. Alle folgenden Befehle benötigen Root-Berechtigungen; möglicherweise müssen Sie sudo verwenden. 
yum install pygpgme yum-utils
Erstellen Sie eine Datei namens /etc/yum.repos.d/appsignal_agent.repo, die die folgende Repository-Konfiguration für EL7 enthält: 
[appsignal_agent]
name=appsignal_agent
baseurl=https://packagecloud.io/appsignal/agent/el/7/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/appsignal/agent/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
Oder diese Konfiguration für EL8: 
[appsignal_agent]
name=appsignal_agent
baseurl=https://packagecloud.io/appsignal/agent/el/8/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/appsignal/agent/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
Aktualisieren Sie Ihren lokalen yum-Cache, indem Sie Folgendes ausführen: 
yum -q makecache -y --disablerepo='*' --enablerepo='appsignal_agent'
Und Sie können dann den Agenten installieren: 
yum install appsignal-agent

​
Konfiguration

Die Konfiguration des Standalone Agents finden Sie unter /etc/appsignal-agent.conf. Eine Liste aller verfügbaren Optionen finden Sie auf der Seite Konfigurationsoptionen für den Standalone Agent. Den erforderlichen Push API-Schlüssel finden Sie im Abschnitt „Push & Deploy” für jede App in Ihrer Organisation und im „App hinzufügen”-Assistenten für Ihre Organisation. Wählen Sie bei der Konfiguration des Standalone Agents einen App-Namen und eine Umgebung, die für Sie passen. Es kann entweder eine separate App sein, oder Sie können sie für eine bestehende App konfigurieren, sodass sie als neuer Host an diese App meldet. 
push_api_key = "<YOUR PUSH API KEY>"
app_name = "<YOUR APP NAME>"
environment = "<YOUR APP ENVIRONMENT>"
hostname = "<YOUR HOST NAME>"
Zum Beispiel: 
push_api_key = "0000-0000-0000-000"
app_name = "My app name"
environment = "production"
hostname = "hostname"
Sobald Sie die Konfigurationsdatei bearbeitet haben, müssen Sie den Agenten neu starten.
  • Verwenden Sie unter Ubuntu 14.04 service appsignal-agent restart
  • Verwenden Sie unter CentOS/Red Hat und Ubuntu 16.04 und höher systemctl restart appsignal-agent

​
Erfasste Metriken

Der Agent erfasst standardmäßig Host-Metriken. Sie können auch StatsD-Nachrichten an ihn senden, die als benutzerdefinierte Metriken verarbeitet werden. Wir sind gespannt auf Ihr Feedback. Lassen Sie es uns über den Chat in der App oder unter support@appsignal.com wissen.