InfraSonar Linux Agent

Documentation: https://docs.infrasonar.com/collectors/agents/linux/

Environment variables

Environment	Default	Description
CONFIG_PATH	/etc/infrasonar	Path where configuration files are loaded and stored (note: for a user, the $HOME path will be used instead of /etc)
TOKEN	required	Token used for authentication (This MUST be a container token).
ASSET_NAME	none	Initial Asset Name. This will only be used at the announce. Once the asset is created, ASSET_NAME will be ignored.
ASSET_ID	none	Asset Id (If not given, the asset Id will be stored and loaded from file).
API_URI	https://api.infrasonar.com	InfraSonar API.
SKIP_VERIFY	none	Set to 1 or something else to skip certificate validation.
CHECK_SYSTEM_INTERVAL	300	Interval in seconds for the system check.

Build

CGO_ENABLED=0 go build -trimpath -o linux-agent

Installation

Download the latest release:

wget https://github.com/infrasonar/linux-agent/releases/download/v0.1.0/linux-agent

The pre-build binary is build for the linux-amd64 platform. For other platforms build from source using the command: CGO_ENABLED=0 go build -o linux-agent

Ensure the binary is executable:

chmod +x linux-agent

Copy the binary to /usr/sbin/infrasonar-linux-agent

sudo cp linux-agent /usr/sbin/infrasonar-linux-agent

Using Systemd

sudo touch /etc/systemd/system/infrasonar-linux-agent.service
sudo chmod 664 /etc/systemd/system/infrasonar-linux-agent.service

1. Using you favorite editor, add the content below to the file created:

[Unit]
Description=InfraSonar Linux Agent
Wants=network.target

[Service]
EnvironmentFile=/etc/infrasonar/linux-agent.env
ExecStart=/usr/sbin/infrasonar-linux-agent

[Install]
WantedBy=multi-user.target

2. Create the directory /etc/infrasonar

sudo mkdir /etc/infrasonar

3. Create the file /etc/infrasonar/linux-agent.env with at least:

TOKEN=<YOUR TOKEN HERE>

Optionaly, add environment variable to the linux-agent.env file for settings like ASSET_ID or CONFIG_PATH (see all environment variables in the table above).

4. Reload systemd:

sudo systemctl daemon-reload

5. Install the service:

sudo systemctl enable infrasonar-linux-agent

Finally, you may want to start/stop or view the status:

sudo systemctl start infrasonar-linux-agent
sudo systemctl stop infrasonar-linux-agent
sudo systemctl status infrasonar-linux-agent

View logging:

journalctl -u infrasonar-linux-agent