Usage

Once installed, the Simple Observability agent (simob) is available in your system’s PATH and can be managed through various commands.

Start

simob start

Starts the collection service. The agent is typically configured to run as a background service (using systemd on Linux or as a Windows Service), so this command is primarily used for manual execution or troubleshooting.

Tip

Use --dry-run to see what data would be collected without sending it to the server.


Status

simob status

Checks if the agent is currently running on your system.


Run

simob run <job-key> -- <command>

Wraps a command and reports its execution lifecycle to Simple Observability. This is useful for monitoring cron jobs or automated scripts. The command’s stdout and stderr are passed through unchanged.

simob run Vp4s8S0SsnMo -- /usr/local/bin/backup.sh

Update

simob update

Checks for newer versions of the agent and automatically downloads and installs updates if available.


Version check

simob version

Displays the currently installed version of the agent.


Configuration

simob config [key=value]

Manages agent settings. Run without arguments to view the current resolved configuration, or provide key=value pairs to update settings.

simob config api_key=your-server-key

Service management

The agent runs as a background service on both Linux and Windows.

Linux

Use standard systemd commands to manage the service:

systemctl start simob
systemctl stop simob
systemctl restart simob

Windows

Manage the simob service using the Services desktop app (services.msc) or via the command line:

Start-Service simob
Stop-Service simob
Restart-Service simob