> ## 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 par paquet Linux de l'agent autonome AppSignal
Cette documentation décrit comment installer l'agent autonome AppSignal via un paquet Linux sur l'hôte que vous souhaitez surveiller, comme une base de données ou un hôte sans application instrumentée en cours d'exécution.
Nous sommes en train de tester et de packager l'agent autonome sur les distributions Linux les plus populaires auprès de nos clients. [Faites-nous savoir](mailto:support@appsignal.com) si vous souhaitez exécuter l'agent sur une distribution qui n'est pas encore prise en charge.
## Système d'exploitation
### Debian et Ubuntu
L'agent a été testé sur Ubuntu LTS 14.04/16.04/18.04/20.04/22.04/24.04 et Debian 8/9/10/11/12.
Assurez-vous d'abord que les paquets suivants sont installés. Toutes les commandes suivantes nécessitent les permissions root, vous devrez peut-être utiliser `sudo`.
```bash Bash theme={null}
apt-get install curl gnupg apt-transport-https
```
Importez ensuite la clé GPG depuis [Packagecloud](https://packagecloud.io). Il s'agit d'un service que nous utilisons pour héberger les dépôts à notre place.
```bash Bash theme={null}
curl -L https://packagecloud.io/appsignal/agent/gpgkey | sudo apt-key add -
```
Créez un fichier nommé `/etc/apt/sources.list.d/appsignal_agent.list` qui contient la configuration du dépôt ci-dessous pour le système d'exploitation que vous utilisez.
#### Ubuntu
Veillez à remplacer `lunar` dans le fichier de configuration `appsignal_agent.list` ci-dessous par le nom de votre version d'Ubuntu. Utilisez les noms de versions suivants :
* `noble` pour Ubuntu 24.04
* `jammy` pour Ubuntu 22.04
* `focal` pour Ubuntu 20.04
* `bionic` pour Ubuntu 18.04
* `xenial` pour Ubuntu 16.04
* `trusty` pour 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
Veillez à remplacer `bookworm` dans le fichier de configuration `appsignal_agent.list` ci-dessous par le nom de votre version de Debian. Utilisez les noms de versions suivants :
* `bookworm` pour Debian 12
* `bullseye` pour Debian 11
* `buster` pour Debian 10
* `stretch` pour Debian 9
* `jessie` pour 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
```
#### Installer l'agent
Exécutez ensuite `apt update` pour récupérer les paquets nouvellement ajoutés et installez l'agent.
```bash Bash theme={null}
apt-get update
apt-get install appsignal-agent
```
L'agent est maintenant installé. La prochaine étape est de le configurer pour qu'il transmette les données à la bonne application dans AppSignal.
### Redhat Enterprise Linux/Centos
Pour le moment, les versions EL 7 et 8 sont prises en charge. Assurez-vous d'abord que les paquets suivants sont installés. Toutes les commandes suivantes nécessitent les permissions root, vous devrez peut-être utiliser `sudo`.
```bash Bash theme={null}
yum install pygpgme yum-utils
```
Créez un fichier nommé `/etc/yum.repos.d/appsignal_agent.repo` qui contient la configuration de dépôt ci-dessous pour EL7 :
```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
```
Ou cette configuration pour 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
```
Mettez à jour votre cache yum local en exécutant :
```bash Bash theme={null}
yum -q makecache -y --disablerepo='*' --enablerepo='appsignal_agent'
```
Vous pouvez ensuite installer l'agent :
```bash Bash theme={null}
yum install appsignal-agent
```
## Configuration
La configuration de l'agent autonome se trouve à l'emplacement `/etc/appsignal-agent.conf`. Pour la liste de toutes les options disponibles, consultez la page des [options de configuration](/standalone-agent/configuration/options) de l'agent autonome.
La clé Push API requise est accessible dans la [section « Push & Deploy »](https://appsignal.com/redirect-to/app?to=info) pour toute application de votre organisation et dans l'[assistant « Add app »](https://appsignal.com/redirect-to/organization?to=sites/new) pour votre organisation.
Lors de la configuration de l'agent autonome, choisissez un nom d'application et un environnement qui vous conviennent. Il peut s'agir d'une application distincte, ou vous pouvez le configurer pour une application existante afin qu'il se rapporte comme un nouvel hôte de cette application.
```conf /etc/appsignal-agent.conf theme={null}
push_api_key = ""
app_name = ""
environment = ""
hostname = ""
```
Par exemple :
```conf /etc/appsignal-agent.conf theme={null}
push_api_key = "0000-0000-0000-000"
app_name = "My app name"
environment = "production"
hostname = "hostname"
```
Une fois que vous avez modifié le fichier de configuration, vous devez redémarrer l'agent.
* Sur Ubuntu 14.04, utilisez `service appsignal-agent restart`
* Sur Centos/Redhat et Ubuntu 16.04 et versions ultérieures, utilisez `systemctl restart appsignal-agent`
## Métriques collectées
L'agent collecte les [métriques d'hôte](/metrics/host-metrics) par défaut. Vous pouvez également lui envoyer des messages [StatsD](/standalone-agent/statsd) qui seront traités comme des métriques personnalisées.
Nous sommes impatients de recevoir vos retours à ce sujet, faites-le-nous savoir via le chat dans l'application ou [support@appsignal.com](mailto:support@appsignal.com).