Install PirlApp Monitoring Agent on Linux Server
The PirlApp Monitoring Agent does provide system metrics like CPU usage, RAM utilization and HDD storage in use. You add your server to PirlApp 2.0 and the metrics are displayed on a monitoring dashboard.
This is not dedicated to Pirl Masternodes, you can monitor every Linux server you want. Supported Linux platform is currently:
- Linux amd64
Besides Linux we also have builds for:
- Windows 64-bit
- macOS 64-bit
Most of the CentOS and Ubuntu based servers are Linux amd64 ones and this article focus on this build. The latest builds can be found on Github. https://github.com/pirl/PirlApp-Monitoring-Agent/releases
Which actions we will take?
Login to your server as
root via SSH.
- Ensure there is the Pirl configuration folder under /etc
- Download the PirlApp Agent Monitoring configuration file
- Download the agent
- Make the agent executable
- Download service file for systemd
- Activate and start the PirlApp2.0 Monitoring Agent service
- Verify the status
- Modify your firewall settings
1. Make Pirl config directory if not exists. It does not override something if it´s already there.
mkdir -p /etc/pirl/
2. Download the PirlApp Agent Monitoring configuration file
wget -O /etc/pirl/pirlapp-agent.conf https://raw.githubusercontent.com/pirl/PirlApp-Monitoring-Agent/master/setup/linux/pirlapp-agent.conf
3. Download the agent
wget -O /usr/bin/pirlapp-agent https://github.com/pirl/PirlApp-Monitoring-Agent/releases/download/1.0/pirlapp-agent-linux
4. Make the agent executable
chmod +x /usr/bin/pirlapp-agent
5. Download the service file for systemd, that takes care of that the daemon is running and started after a reboot.
wget -O /lib/systemd/system/pirlapp-monitoring-agent.service https://raw.githubusercontent.com/pirl/PirlApp-Monitoring-Agent/master/setup/linux/pirlapp-monitoring-agent.service
6. Activate and start the PirlApp2.0 Monitoring Agent service
systemctl daemon-reload systemctl enable pirlapp-monitoring-agent systemctl start pirlapp-monitoring-agent
7. Verify the status
systemctl status pirlapp-monitoring-agent
[[email protected]](https://helpdesk.pirl.io/cdn-cgi/l/email-protection) ~ # systemctl status pirlapp-monitoring-agent ● pirlapp-monitoring-agent.service - PirlApp Monitoring Agent Loaded: loaded (/lib/systemd/system/pirlapp-monitoring-agent.service; enabled; vendor preset: enabled) Active: active (running) since Wed 2020-05-13 20:51:25 UTC; 30min ago Main PID: 3486 (pirlapp-agent) Tasks: 4 (limit: 4915) CGroup: /system.slice/pirlapp-monitoring-agent.service └─3486 /usr/bin/pirlapp-agent May 13 20:51:25 pirl-dev systemd: Started PirlApp Monitoring Agent. May 13 20:51:25 pirl-dev pirlapp-agent: Starting PirlApp Agent on port :8081
[[email protected]](https://helpdesk.pirl.io/cdn-cgi/l/email-protection) ~ #
8. Modify your firewall settings
For CentOS and firewalld use:
firewall-cmd --zone=public --permanent --add-port=8081/tcp
For Ubuntu and ufw use:
ufw allow 8081
If you decide to use another tcp port via the
/etc/pirl/pirlapp-agent.conf file, please keep in mind to change your firewall also.
We have the following files:
/usr/bin/pirlapp-agent # Monitoring Agent Binary
/etc/pirl/pirlapp-agent.conf # Configuration File
/lib/systemd/system/pirlapp-monitoring-agent.service # Systemd Service File
The default port is tcp/8081.
In case you need help, visit us in Discord and post your request under #support or #PirlApp-2_0 .