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.
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.
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

​
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

​
Installer l’agent

Exécutez ensuite apt update pour récupérer les paquets nouvellement ajoutés et installez l’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.
Créez un fichier nommé /etc/yum.repos.d/appsignal_agent.repo qui contient la configuration de dépôt ci-dessous pour EL7 :
Ou cette configuration pour EL8 :
Mettez à jour votre cache yum local en exécutant :
Vous pouvez ensuite installer l’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.
Par exemple :
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.