Passer au contenu principal
Cette documentation explique comment installer l’AppSignal collector à l’aide d’un paquet Linux sur l’hôte que vous souhaitez surveiller. Sélectionnez le système d’exploitation utilisé par votre hôte dans la navigation à droite pour continuer. Faites-nous savoir si vous souhaitez exécuter le collector sur une distribution non listée ici.

Debian

Tout d’abord, assurez-vous que les paquets suivants sont installés. Toutes les commandes suivantes nécessitent les permissions root.
sudo apt update
sudo apt install curl gpg -y
Les versions suivantes sont prises en charge.
  • Bookworm pour Debian 12 (x86_64 et arm64)
  • Bullseye pour Debian 11 (x86_64)
Suivez les instructions correspondant à votre version de Debian.
Importez la clé de signature GPG en exécutant cette commande :
curl -fsSL "https://packages.buildkite.com/appsignal/collector-debian-bookworm/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg
Configurez la source du paquet en exécutant cette commande :
echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bookworm/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bookworm/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-debian-bookworm.list
Ensuite, mettez à jour apt pour récupérer les paquets nouvellement ajoutés et installez le collector.
apt-get update
apt-get install appsignal-collector
Le collector est maintenant installé. La prochaine étape est la configuration du collector afin qu’AppSignal puisse recevoir des données.

Ubuntu

Tout d’abord, assurez-vous que les paquets suivants sont installés. Toutes les commandes suivantes nécessitent les permissions root.
sudo apt update
sudo apt install curl gpg -y
Les versions suivantes sont prises en charge.
  • Noble pour Ubuntu 24.04 (x86_64 et arm64)
  • Jammy pour Ubuntu 22.04 (x86_64)
Suivez les instructions correspondant à votre version d’Ubuntu.
Importez la clé de signature GPG en exécutant cette commande :
curl -fsSL "https://packages.buildkite.com/appsignal/collector-ubuntu-noble/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg
Configurez la source du paquet en exécutant cette commande :
echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-noble/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-noble/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-ubuntu-noble.list
Ensuite, mettez à jour apt pour récupérer les paquets nouvellement ajoutés et installez le collector.
apt-get update
apt-get install appsignal-collector
Le collector est maintenant installé. La prochaine étape est la configuration du collector afin qu’AppSignal puisse recevoir des données.

Red Hat Enterprise Linux/CentOS

Les versions Red Hat suivantes sont prises en charge.
  • RHEL 9 (x86_64)
Les commandes suivantes nécessitent les permissions root. Si vous obtenez une erreur de permission, vous devrez peut-être utiliser sudo. Configurez la source du paquet en exécutant cette commande :
sh -c 'echo -e "[collector-rpm-9]\nname=Collector RPM 9 \nbaseurl=https://packages.buildkite.com/appsignal/collector-rpm-9/rpm_any/rpm_any/\$basearch\nenabled=1\nrepo_gpgcheck=1\ngpgcheck=0\ngpgkey=https://packages.buildkite.com/appsignal/collector-rpm-9/gpgkey\npriority=1"' > /etc/yum.repos.d/collector-rpm-9.repo
Ensuite, installez le collector.
dnf install -y appsignal-collector
Le collector est maintenant installé. La prochaine étape est la configuration du collector afin qu’AppSignal puisse recevoir des données.

Configuration

La configuration du collector se trouve à l’emplacement /etc/appsignal-collector.conf. Pour la liste de toutes les options disponibles, consultez la page des options de configuration. Mettez à jour le fichier de configuration /etc/appsignal-collector.conf pour utiliser la clé Push API de votre organisation. 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.
# /etc/appsignal-collector.conf
push_api_key = "<YOUR PUSH API KEY>"
Par exemple :
# /etc/appsignal-collector.conf
push_api_key = "0000-0000-0000-0000"
Seule la clé Push API est requise lors de la configuration du collector. Elle autorisera les données de votre application avec notre Push API. Une fois le fichier de configuration mis à jour, vous devez redémarrer le collector.
systemctl restart appsignal-collector
Le collector devrait maintenant être en cours d’exécution !

Débogage

Vérifiez la sortie des journaux avec la commande suivante pour voir si des problèmes ont été signalés.
journalctl -u appsignal-collector