The InfraBeacon server agent installs in under a minute on most Linux servers with bash and curl.
Prerequisites
- A Linux server (Debian, Ubuntu, CentOS, RHEL, etc.)
- Root or sudo access
curlinstalled
- Outbound HTTPS access to
api.infrabeacon.io
Installation steps
- Go to your Account page in InfraBeacon
- Scroll to the Server Monitoring section and click Add server
- Enter a unique host name, such as
web-server-1ordb-prod
- Add a display label if you want one
- Copy the install command shown. It includes your token and host
The installer process
- Creates a config file at
/etc/ib-agent.conf
- Downloads the agent script to
/usr/local/bin/ib-agent
- Sets up a cron job to run the agent every minute
- Optionally creates a dedicated
ib-agentuser
Running as a dedicated user
By default, the installer asks you to choose between:
- ib-agent (recommended) - Creates a system user with no login shell
- root - Runs as root
You can also set the user with this flag:
--user ib-agent
Verifying installation
After installation, you should see data in your dashboard within a couple of minutes. You can also check:
# View recent log entries
tail /var/log/ib-agent.log
# Check the cron job
cat /etc/cron.d/ib-agent
# Run the agent manually
sudo /usr/local/bin/ib-agent