Files
oneuptime/InfrastructureAgent
Tony An c77cb8cd19 ⬆️ Update dependencies and bump Go version
Updated various dependencies in `go.mod` and `go.sum` to their latest versions, including `golang.org/x/sys`, `github.com/go-co-op/gocron`, and more. Increased the Go version to 1.23.0 and added toolchain specification for Go 1.24.0. These updates improve compatibility, security, and maintainability.
2025-02-27 08:54:28 -06:00
..
2025-02-27 08:54:28 -06:00
2025-02-27 08:54:28 -06:00

OneUptime Infrastructure Agent

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 -s 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

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