The OneUptime Infrastructure Agent is a lightweight, open-source agent that collects system metrics and sends them to the OneUptime platform. It is designed to be easy to install and use, and to be extensible.

Installation

curl -sSL https://oneuptime.com/docs/static/scripts/infrastructure-agent/install.sh | bash

Configure the agent

Configure the agent as a system service

You can change the host to your own host if you're self hosting the OneUptime platform.
You can find the secret key on OneUptime Dashboard. Click on "View Monitor" and go to "Settings" tab.

oneuptime-infrastructure-agent configure --secret-key=YOUR_SECRET_KEY --oneuptime-url=https://oneuptime.com

Starting the agent

oneuptime-infrastructure-agent start

Once its up and running you should see the metrics on the OneUptime Dashboard.

Stopping the agent

oneuptime-infrastructure-agent stop

Restarting the agent

oneuptime-infrastructure-agent restart

Uninstalling the agent

oneuptime-infrastructure-agent uninstall && rm -rf /usr/bin/oneuptime-infrastructure-agent

Viewing agent logs

oneuptime-infrastructure-agent logs

You can also use the following options:

Show specific number of lines: oneuptime-infrastructure-agent logs -n 50
Follow logs in real-time: oneuptime-infrastructure-agent logs -f

Supported Platforms

Linux
MacOS
Windows

Development

This section is for developers who want to contribute to the agent. The agent is written in Go.

Building the agent

go mod tidy
go install
go build

Configure the agent

sudo ./oneuptime-infrastructure-agent configure --secret-key=YOUR_SECRET_KEY --oneuptime-url=https://localhost

Starting the agent

sudo ./oneuptime-infrastructure-agent start

Stopping the agent

sudo ./oneuptime-infrastructure-agent stop

Viewing logs

sudo ./oneuptime-infrastructure-agent logs