Naar hoofdinhoud gaan
Deze documentatie beschrijft hoe u de AppSignal standalone agent installeert via een Linux-pakket op de host die u wilt monitoren, zoals een database of een host zonder een geïnstrumenteerde app die erop draait. Wij zijn bezig met het testen en verpakken van de standalone agent op de Linux-distributies die het populairst zijn bij onze klanten. Laat het ons weten als u de agent wilt draaien op een distributie die nog niet wordt ondersteund.

​
Besturingssysteem

​
Debian en Ubuntu

De agent is getest op Ubuntu LTS 14.04/16.04/18.04/20.04/22.04/24.04 en Debian 8/9/10/11/12. Zorg er eerst voor dat de volgende pakketten zijn geïnstalleerd. Voor alle volgende commando’s zijn rootrechten nodig, mogelijk moet u sudo gebruiken. 
apt-get install curl gnupg apt-transport-https
Importeer vervolgens de GPG-sleutel van Packagecloud. Dit is een dienst die wij gebruiken om de repositories voor ons te hosten. 
curl -L https://packagecloud.io/appsignal/agent/gpgkey | sudo apt-key add -
Maak een bestand aan met de naam /etc/apt/sources.list.d/appsignal_agent.list dat de onderstaande repository-configuratie bevat voor het besturingssysteem dat u gebruikt.

​
Ubuntu

Zorg ervoor dat u lunar in het onderstaande appsignal_agent.list-configuratiebestand vervangt door de naam van uw Ubuntu-release. Gebruik de volgende releasenamen:
  • noble voor Ubuntu 24.04
  • jammy voor Ubuntu 22.04
  • focal voor Ubuntu 20.04
  • bionic voor Ubuntu 18.04
  • xenial voor Ubuntu 16.04
  • trusty voor Ubuntu 14.04
deb https://packagecloud.io/appsignal/agent/ubuntu/ lunar main
deb-src https://packagecloud.io/appsignal/agent/ubuntu/ lunar main

​
Debian

Zorg ervoor dat u bookworm in het onderstaande appsignal_agent.list-configuratiebestand vervangt door de naam van uw Debian-release. Gebruik de volgende releasenamen:
  • bookworm voor Debian 12
  • bullseye voor Debian 11
  • buster voor Debian 10
  • stretch voor Debian 9
  • jessie voor Debian 8
deb https://packagecloud.io/appsignal/agent/debian/ bookworm main
deb-src https://packagecloud.io/appsignal/agent/debian/ bookworm main

​
De agent installeren

Voer vervolgens apt update uit om de nieuw toegevoegde pakketten op te halen en installeer de agent. 
apt-get update
apt-get install appsignal-agent
De agent is nu geïnstalleerd. De volgende stap is het configureren ervan zodat deze rapporteert aan de juiste app in AppSignal.

​
Redhat Enterprise Linux/Centos

Op dit moment worden EL-versie 7 en 8 ondersteund. Zorg er eerst voor dat de volgende pakketten zijn geïnstalleerd. Voor alle volgende commando’s zijn rootrechten nodig, mogelijk moet u sudo gebruiken. 
yum install pygpgme yum-utils
Maak een bestand aan met de naam /etc/yum.repos.d/appsignal_agent.repo dat de onderstaande repository-configuratie bevat voor 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
Of deze configuratie voor 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
Werk uw lokale yum-cache bij door uit te voeren: 
yum -q makecache -y --disablerepo='*' --enablerepo='appsignal_agent'
Daarna kunt u de agent installeren: 
yum install appsignal-agent

​
Configuratie

De configuratie van de standalone agent vindt u op /etc/appsignal-agent.conf. Voor een lijst met alle beschikbare opties, zie de pagina configuratieopties voor de standalone agent. De vereiste Push API-sleutel vindt u in het gedeelte “Push & Deploy” voor elke app in uw organisatie en in de wizard “App toevoegen” voor uw organisatie. Kies bij het configureren van de standalone agent een app-naam en omgeving die voor u werken. Het kan een aparte app zijn, of u kunt het configureren voor een bestaande app, zodat deze als een nieuwe host aan die app rapporteert. 
push_api_key = "<YOUR PUSH API KEY>"
app_name = "<YOUR APP NAME>"
environment = "<YOUR APP ENVIRONMENT>"
hostname = "<YOUR HOST NAME>"
Bijvoorbeeld: 
push_api_key = "0000-0000-0000-000"
app_name = "My app name"
environment = "production"
hostname = "hostname"
Nadat u het configuratiebestand hebt bewerkt, moet u de agent opnieuw starten.
  • Gebruik op Ubuntu 14.04 service appsignal-agent restart
  • Gebruik op Centos/Redhat en Ubuntu 16.04 en hoger systemctl restart appsignal-agent

​
Verzamelde metrieken

De agent verzamelt standaard host-metrieken. U kunt er ook StatsD-berichten naartoe sturen die als aangepaste metrieken worden verwerkt. Wij horen hier graag feedback over, laat het ons weten via de chat in de app of via support@appsignal.com.