Passer au contenu principal
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 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. 
apt-get install curl gnupg apt-transport-https
Importez ensuite la clé GPG depuis Packagecloud. Il s’agit d’un service que nous utilisons pour héberger les dépôts à notre place. 
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
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
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. 
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. 
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 : 
[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 : 
[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 : 
yum -q makecache -y --disablerepo='*' --enablerepo='appsignal_agent'
Vous pouvez ensuite installer l’agent : 
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 de l’agent autonome. La clé Push API requise est accessible dans la section « Push & Deploy » pour toute application de votre organisation et dans l’assistant « Add app » 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. 
push_api_key = "<YOUR PUSH API KEY>"
app_name = "<YOUR APP NAME>"
environment = "<YOUR APP ENVIRONMENT>"
hostname = "<YOUR HOST NAME>"
Par exemple : 
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 par défaut. Vous pouvez également lui envoyer des messages 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.