Dog Poop Tracker — Server Health Monitoring for the Civilized

██████╗  ██████╗  ██████╗     ██████╗  ██████╗  ██████╗ ██████╗ 
██╔══██╗██╔═══██╗██╔════╝     ██╔══██╗██╔═══██╗██╔═══██╗██╔══██╗
██║  ██║██║   ██║██║  ███╗    ██████╔╝██║   ██║██║   ██║██████╔╝
██║  ██║██║   ██║██║   ██║    ██╔═══╝ ██║   ██║██║   ██║██╔═══╝ 
██████╔╝╚██████╔╝╚██████╔╝    ██║     ╚██████╔╝╚██████╔╝██║     
╚═════╝  ╚═════╝  ╚═════╝     ╚═╝      ╚═════╝  ╚═════╝ ╚═╝     
████████╗██████╗  █████╗  ██████╗██╗  ██╗███████╗██████╗ 
╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██║ ██╔╝██╔════╝██╔══██╗
   ██║   ██████╔╝███████║██║     █████╔╝ █████╗  ██████╔╝
   ██║   ██╔══██╗██╔══██║██║     ██╔═██╗ ██╔══╝  ██╔══██╗
   ██║   ██║  ██║██║  ██║╚██████╗██║  ██╗███████╗██║  ██║
   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

Server health monitoring for the civilized.

Because every service drops a deuce eventually.

terminal

$ pip install dog-poop-tracker $ poop

Get Started GitHub

Features

Everything you need to monitor your endpoints.

With the dumbest name possible.

Health Checks

Monitor HTTP endpoints with configurable intervals, methods, headers, and expected status codes. GET, POST, whatever your dog needs.

The Poop Scale

Results mapped to a brilliant consistency scale. Solid (healthy), Normal (ok), Soft (degraded), Liquid (down). You'll never unsee it.

Live Watch Mode

Real-time monitoring dashboard in your terminal. Auto-refreshes at each dog's interval. Alerts when services go down or recover.

Statistics & History

Track uptime percentages, latency trends, consistency breakdowns. Full check history with filtering by service and time window.

Zero Dependencies*

Pure Python. SQLite for storage. No cloud, no accounts, no BS. Your data stays local in ~/.dpt/poop.db. *well, a few pip packages

Beautiful CLI

Rich terminal UI with colored tables, gradient ASCII art, and status indicators. Looks as good as it is functional.

How It Works

Three steps to digestive enlightenment.

Add your dogs

Register endpoints to monitor. Set the URL, expected status, timeout, and check interval. Each service is a "dog" in your pack.

terminal

$ poop add prod-api https://api.example.com --interval 30 ╭──────────────────── ✔ New Dog Added ─────────────────────╮ │ Name: prod-api │ │ URL: https://api.example.com │ │ Method: GET │ │ Interval: 30s │ ╰──────────────────────────────────────────────────────────╯

Walk the dogs

Run health checks on all your services at once. Each check is classified into the poop consistency scale with color-coded results.

terminal

$ poop check ╭────────────┬────────┬─────────┬─────────────┬───────────╮ │ Dog │ Status │ Latency │ Consistency │ Healthy │ ├────────────┼────────┼─────────┼─────────────┼───────────┤ │ prod-api │ 200 │ 45ms │ ● solid │ ✔ HEALTHY │ │ auth │ 200 │ 890ms │ ◐ soft │ ✘ SICK │ │ payments │ ERR │ timeout │ ○ liquid │ ✘ SICK │ ╰────────────┴────────┴─────────┴─────────────┴───────────╯

Watch them play

Start the live monitoring daemon. It continuously checks all services at their configured intervals and alerts you when something changes.

terminal — poop watch

◆ Live Monitoring │ Ctrl+C to stop ╭────────────┬────────┬─────────┬─────────────┬───────────╮ │ Dog │ Status │ Latency │ Consistency │ Next │ ├────────────┼────────┼─────────┼─────────────┼───────────┤ │ prod-api │ 200 │ 42ms │ ● solid │ 28s │ │ auth │ 200 │ 120ms │ ● solid │ 55s │ │ payments │ 200 │ 230ms │ ● normal │ 48s │ ╰────────────┴────────┴─────────┴─────────────┴───────────╯ [17:21:28] ▲ payments recovered solid 230ms

Poop Term	What It Actually Means
Dog	A service or endpoint you're monitoring
Poop	A health check result
Solid	Fast response, correct status code — all good
Normal	Correct but slower than ideal
Soft	Wrong status code, high latency, 4xx errors
Liquid	Down. 5xx, timeout, connection refused
Walk the dog	Run a health check
Blood	Server errors (5xx) or connection refused
Mucus	Warnings — slow but working, redirects

Installation

Get up and running in 30 seconds.

Requires Python 3.10+. That's it.

pip install Recommended

Install globally from PyPI.

$ pip install dog-poop-tracker
$ poop

From source

Clone and install in development mode.

$ git clone https://github.com/dogpooptracker/dogpooptracker
$ cd dog-poop-tracker
$ pip install -e .

quick start

# Add some services $ poop add prod-api https://api.example.com $ poop add auth https://auth.example.com --timeout 5 # Run a health check $ poop check # Start live monitoring $ poop watch

Commands

Full command reference.

poopShow the splash screen with stats overview

poop add <name> <url>Add a service to monitor. Options: --method, --expected-status, --timeout, --interval, --header

poop remove <name>Remove a service and all its check history

poop listList all registered services with their config

poop check [name]Run health checks. Specify a name or check all enabled services

poop statusQuick overview table of all services and their last check

poop history [name]Show recent check history. Options: --limit, --hours

poop watchStart live monitoring mode. Auto-checks at each service's interval. Ctrl+C to stop

poop stats [name]Show uptime %, latency stats, and consistency breakdown. Options: --hours

poop toggle <name>Enable or disable a service. Disabled services are skipped during checks