System Checks
Project · Bash · Prometheus · Health Check

prom-health

A small CLI health checker for a local Prometheus or Prom++ instance. It checks readiness, health, scrape targets, memory usage, runtime metrics and basic TSDB status.

GitHubBack to projects
/-/readyready
/-/healthyhealthy
targets1 down
tsdb statusread

What it checks

prom-health is useful for quick local diagnostics, cron checks, systemd timers and integration into Prometheus operational scripts.

Prometheus health

Checks readiness and health endpoints.

/-/ready/-/healthy

Scrape targets

Reads active targets, shows summary and prints unhealthy targets.

targetsup/down

Runtime and TSDB

Shows process memory, Go runtime metrics and basic TSDB status.

memoryGo runtimeTSDB

Usage

git clone https://github.com/m0zgen/prom-health.git
cd prom-health
chmod +x prom-health.sh

./prom-health.sh

Use custom Prometheus URL:

./prom-health.sh -u http://127.0.0.1:9090

Show all targets:

./prom-health.sh --all

Project status

Small diagnostic tool for local Prometheus health checks. Good fit for cron, systemd timers, shell automation and quick troubleshooting.