Probe

April 28, 2026 · View on GitHub

A lightweight Go agent for monitoring system resources and log files.


  🔍 Starting Probe...

  📡 Data logging is enabled.

  🚨 Alarm is armed.

  🤖 Probe is watching.

Badges

Features

CPU - overall CPU usage percentage
Memory - overall memory usage percentage
Process - per-process CPU and memory usage
Load - system load averages (1, 5, 15 min)
Disk - per-partition disk usage percentage (with ignore patterns)
Log Tail - tail the last N lines of specified log files
Data Logging - persist collected metrics to Redis with configurable TTL
Alarms - webhook notifications when thresholds are exceeded
Alarm Filtering - wait and sleep intervals to reduce alarm noise
Console Mode - print metrics to stdout when data logging is disabled

Getting Started

Follow the steps below to install and configure Probe.

Prerequisites

Redis: Version >= 5.0 (optional, required for data logging and alarm filtering)

Install from Binary

Download the latest release for your platform from the GitHub Releases page.

Install from Source

Prerequisites

Go: Version >= 1.26

Steps

Clone the repository:

git clone git@github.com:petaki/probe.git

Build the binary:

cd probe
go build

Copy and edit the configuration:

cp .env.example .env

Configuration

All configuration is done through environment variables in the .env file.

A ✅ marks where the variable is required.

Option	Always	Data Log	Alarm	Alarm Filter	Log Tail
`PROBE_NAME`	✅
`PROBE_DISK_IGNORED`	✅
`PROBE_DATA_LOG_ENABLED`	✅
`PROBE_ALARM_ENABLED`	✅
`PROBE_ALARM_FILTER_ENABLED`	✅
`PROBE_LOG_TAIL_ENABLED`	✅
`PROBE_REDIS_URL`		✅		✅
`PROBE_DATA_LOG_TIMEOUT`		✅
`PROBE_ALARM_CPU_PERCENT`			✅
`PROBE_ALARM_MEMORY_PERCENT`			✅
`PROBE_ALARM_DISK_PERCENT`			✅
`PROBE_ALARM_LOAD_VALUE`			✅
`PROBE_ALARM_WEBHOOK_METHOD`			✅
`PROBE_ALARM_WEBHOOK_URL`			✅
`PROBE_ALARM_WEBHOOK_HEADER`			✅
`PROBE_ALARM_WEBHOOK_BODY`			✅
`PROBE_ALARM_FILTER_WAIT`				✅
`PROBE_ALARM_FILTER_SLEEP`				✅
`PROBE_LOG_TAIL_FILES`					✅
`PROBE_LOG_TAIL_LINES`					✅
`PROBE_LOG_TAIL_BUFFER_SIZE`					✅
`PROBE_LOG_TAIL_LIMIT`					✅
`PROBE_LOG_TAIL_TIMEOUT`					✅

General

Probe Name

Identifier of this probe instance. Used as the %p webhook placeholder and the Redis key prefix.

PROBE_NAME=probe

Disk Ignored

Comma-separated patterns to exclude disk partitions from monitoring:

Pattern	Match Type
`PATTERN*`	Prefix
`*PATTERN`	Suffix
`PATTERN`	Contains
`PATTERN`	Exact

PROBE_DISK_IGNORED=/dev,/var/lib/docker/*

Redis

Required when data logging or alarm filtering is enabled. Keys are prefixed with <PROBE_NAME>:.

Redis URL

PROBE_REDIS_URL=redis://127.0.0.1:6379/0

Data Log

Persists collected metrics to Redis. Requires Redis to be configured.

Data Log Enabled

PROBE_DATA_LOG_ENABLED=true

Data Log Timeout (in seconds)

PROBE_DATA_LOG_TIMEOUT=2592000

Log Tail

Tails the last N lines of specified log files on each monitoring cycle.

Log Tail Enabled

PROBE_LOG_TAIL_ENABLED=false

Log Tail Files (comma-separated)

PROBE_LOG_TAIL_FILES=/var/log/syslog,/var/log/auth.log

Log Tail Lines

PROBE_LOG_TAIL_LINES=10

Log Tail Buffer Size (in bytes)

PROBE_LOG_TAIL_BUFFER_SIZE=4096

Log Tail Limit (max entries per log file in Redis)

PROBE_LOG_TAIL_LIMIT=60

Log Tail Timeout (in seconds)

PROBE_LOG_TAIL_TIMEOUT=172800

Alarm

Sends webhook notifications when a metric exceeds its threshold. Set a threshold to 0 to disable it.

Alarm Enabled

PROBE_ALARM_ENABLED=false

Alarm CPU Percent

PROBE_ALARM_CPU_PERCENT=30

Alarm Memory Percent

PROBE_ALARM_MEMORY_PERCENT=50

Alarm Disk Percent

PROBE_ALARM_DISK_PERCENT=80

Alarm Load Value

PROBE_ALARM_LOAD_VALUE=1.0

Alarm Webhook

Alarm Webhook Method

PROBE_ALARM_WEBHOOK_METHOD=POST

Alarm Webhook URL

PROBE_ALARM_WEBHOOK_URL=http://127.0.0.1:4000/alarm

Alarm Webhook Header

PROBE_ALARM_WEBHOOK_HEADER='{"Authorization": "Bearer TOKEN", "Accept": "application/json"}'

Alarm Webhook Body

The body supports the following placeholders:

Placeholder	Description
`%p`	Probe name
`%n`	Watcher name
`%a`	Alarm threshold
`%u`	Current value
`%t`	Timestamp (`RFC3339`)
`%x`	Timestamp (`Unix`)
`%l`	Satellite link (relative)

PROBE_ALARM_WEBHOOK_BODY='{"probe": "%p", "name": "%n", "alarm": %a, "used": %u, "timestamp_rfc3339": "%t", "timestamp_unix": %x, "link": "%l"}'

Alarm Filter

Reduces alarm noise by requiring sustained threshold violations before firing and enforcing a cooldown between alarms. Requires Redis to be configured.