> ## 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.
# Installation des Standalone AppSignal Agents über das Linux-Paket
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](mailto:support@appsignal.com), 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.
```bash Bash theme={null}
apt-get install curl gnupg apt-transport-https
```
Importieren Sie dann den GPG-Schlüssel von [Packagecloud](https://packagecloud.io). Dies ist ein Dienst, den wir zum Hosten der Repositorys für uns verwenden.
```bash Bash theme={null}
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
```conf /etc/apt/sources.list.d/appsignal_agent.list theme={null}
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
```conf /etc/apt/sources.list.d/appsignal_agent.list theme={null}
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.
```bash Bash theme={null}
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.
```bash Bash theme={null}
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:
```conf /etc/yum.repos.d/appsignal_agent.repo theme={null}
[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:
```conf /etc/yum.repos.d/appsignal_agent.repo theme={null}
[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:
```bash Bash theme={null}
yum -q makecache -y --disablerepo='*' --enablerepo='appsignal_agent'
```
Und Sie können dann den Agenten installieren:
```bash Bash theme={null}
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](/standalone-agent/configuration/options) für den Standalone Agent.
Den erforderlichen Push API-Schlüssel finden Sie im Abschnitt [„Push & Deploy"](https://appsignal.com/redirect-to/app?to=info) für jede App in Ihrer Organisation und im [„App hinzufügen"-Assistenten](https://appsignal.com/redirect-to/organization?to=sites/new) 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.
```conf /etc/appsignal-agent.conf theme={null}
push_api_key = ""
app_name = ""
environment = ""
hostname = ""
```
Zum Beispiel:
```conf /etc/appsignal-agent.conf theme={null}
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](/metrics/host-metrics). Sie können auch [StatsD](/standalone-agent/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](mailto:support@appsignal.com) wissen.