Ad-hoc metrics over HTTP.

U=https://curlplot.dev/m/your-account/pick-a-key
curl -s "$U/g/disk_free_gb/$(df -BG --output=avail / | tail -1 | tr -dc 0-9)?host=$(hostname)"
curl -s "$U/c/backups_ok"
curl -s "$U/e/deploy/$(printf 'v1.4 shipped' | jq -sRr @uri)"

POST works too

curl -s -X POST "https://curlplot.dev/m/your-account/pick-a-key/c/signups/3"

Drop this in /usr/local/bin/pp-health and run it from cron every minute. It sends six gauges per host.

#!/bin/sh
U=https://curlplot.dev/m/your-account/pick-a-key
H="host=$(hostname)"
read l1 l5 l15 _ < /proc/loadavg
mem=$(awk '/MemAvailable/ {print int($2/1024)}' /proc/meminfo)
disk=$(df --output=pcent / | tail -1 | tr -dc 0-9)
up=$(cut -d' ' -f1 /proc/uptime)
temp=$(( $(cat /sys/class/thermal/thermal_zone0/temp 2>/dev/null || echo 0) / 1000 ))
for kv in load1=$l1 load5=$l5 mem_avail_mb=$mem disk_used_pct=$disk uptime_s=$up cpu_temp=$temp; do
  curl -s -o /dev/null "$U/g/${kv%%=*}/${kv#*=}?$H"
done

* * * * * /usr/local/bin/pp-health

Failed systemd units

curl -s "https://curlplot.dev/m/your-account/pick-a-key/g/failed_units/$(systemctl --failed --no-legend | wc -l)?host=$(hostname)"

Pending apt upgrades (Debian/Ubuntu)

curl -s "https://curlplot.dev/m/your-account/pick-a-key/g/apt_upgradable/$(apt list --upgradable 2>/dev/null | grep -c upgradable)?host=$(hostname)"

Count successes and failures separately, and record how long the job took.

#!/bin/sh
U=https://curlplot.dev/m/your-account/pick-a-key
t0=$(date +%s%3N)
if restic backup /home; then
  curl -s "$U/c/backup_ok?job=home"
else
  curl -s "$U/c/backup_failed?job=home"
fi
curl -s "$U/t/backup_ms/$(( $(date +%s%3N) - t0 ))?job=home"

Every 5 minutes: 1-minute load average

*/5 * * * * curl -s "https://curlplot.dev/m/your-account/pick-a-key/g/load1/$(cut -d' ' -f1 /proc/loadavg)?host=$(hostname)" >/dev/null

Paste this into a workflow to try it right away. The write URL is inline here; anyone who can read the workflow or its logs can write to your account, so if that matters, move it to a repository secret named CURLPLOT_URL and use U: ${{ secrets.CURLPLOT_URL }} instead. GitHub then masks it in logs.

      - run: echo "T0=$(date +%s)" >> "$GITHUB_ENV"   # first step of the job

      # … your build and test steps …

      - name: Report to Curlplot
        if: always()
        env:
          U: https://curlplot.dev/m/your-account/pick-a-key
        run: |
          curl -s "$U/c/ci_${{ job.status }}?repo=${{ github.event.repository.name }}"
          curl -s "$U/t/ci_ms/$(( ($(date +%s) - T0) * 1000 ))?repo=${{ github.event.repository.name }}"

Gives you ci_success and ci_failure counters plus a ci_ms timing, labelled by repository.

Mark deploys on every chart

      - name: Deploy marker
        run: curl -s "https://curlplot.dev/m/your-account/pick-a-key/e/deploy/$(printf '%s' "${{ github.sha }}" | cut -c1-7)"

Standard library only.

import time, urllib.request
U = "https://curlplot.dev/m/your-account/pick-a-key"
t0 = time.monotonic()
do_the_work()
urllib.request.urlopen(f"{U}/t/job_ms/{(time.monotonic() - t0) * 1000:.0f}?job=nightly")

A small helper that never breaks your program

import urllib.parse, urllib.request

U = "https://curlplot.dev/m/your-account/pick-a-key"

def pp(kind, metric, value="", **labels):
    url = f"{U}/{kind}/{metric}"
    if value != "":
        url += "/" + urllib.parse.quote(str(value), safe="")
    if labels:
        url += "?" + urllib.parse.urlencode(labels)
    try:
        urllib.request.urlopen(url, timeout=2)
    except Exception:
        pass   # metrics must never take the app down

pp("g", "queue_len", 17, worker="a")
pp("c", "emails_sent")
pp("e", "deploy", "v1.4 shipped")

With requests

import requests
requests.get("https://curlplot.dev/m/your-account/pick-a-key/g/room_temp/21.4", params={"room": "office"}, timeout=2)

Running containers

curl -s "https://curlplot.dev/m/your-account/pick-a-key/g/containers_running/$(docker ps -q | wc -l)?host=$(hostname)"

Unhealthy containers

curl -s "https://curlplot.dev/m/your-account/pick-a-key/g/containers_unhealthy/$(docker ps -q --filter health=unhealthy | wc -l)?host=$(hostname)"

Response time from wherever the check runs, and a counter for failures.

#!/bin/sh
U=https://curlplot.dev/m/your-account/pick-a-key
SITE=https://example.com
ms=$(curl -s -o /dev/null -w '%{time_total}' --max-time 10 "$SITE" | awk '{print int($1*1000)}')
code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 10 "$SITE")
curl -s "$U/t/http_ms/$ms?site=example"
[ "$code" = 200 ] || curl -s "$U/c/http_fail?site=example&code=$code"

TLS certificate days left

end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
curl -s "https://curlplot.dev/m/your-account/pick-a-key/g/cert_days/$(( ($(date -d "$end" +%s) - $(date +%s)) / 86400 ))?site=example"

Raspberry Pi temperature

curl -s "https://curlplot.dev/m/your-account/pick-a-key/g/cpu_temp/$(vcgencmd measure_temp | tr -dc 0-9.)?host=pi"

MicroPython (ESP32, Pico W)

import urequests
r = urequests.get("https://curlplot.dev/m/your-account/pick-a-key/g/humidity/%.1f?room=attic" % sensor.humidity())
r.close()

Home Assistant rest_command

rest_command:
  curlplot:
    url: "https://curlplot.dev/m/your-account/pick-a-key/g/{{ metric }}/{{ value }}?room={{ room }}"

# busybox wget needs to be built with TLS support for https
wget -q -O /dev/null "https://curlplot.dev/m/your-account/pick-a-key/g/wan_rx_bytes/$(cat /sys/class/net/eth0/statistics/rx_bytes)?host=router"

Ping latency

ms=$(ping -c 3 -q 1.1.1.1 | awk -F/ '/^rtt|^round-trip/ {print int($5)}')
curl -s "https://curlplot.dev/m/your-account/pick-a-key/t/ping_ms/$ms?target=cloudflare"

const U = "https://curlplot.dev/m/your-account/pick-a-key";
const pp = (kind, metric, value = "", labels = {}) =>
  fetch(`${U}/${kind}/${metric}${value === "" ? "" : "/" + encodeURIComponent(value)}?${new URLSearchParams(labels)}`)
    .catch(() => {});   // never let metrics break the app

pp("c", "orders");
pp("t", "render_ms", Math.round(performance.now()), { page: "home" });

$U = "https://curlplot.dev/m/your-account/pick-a-key"
$free = [math]::Round((Get-PSDrive C).Free / 1GB, 1)
Invoke-RestMethod "$U/g/disk_free_gb/$($free)?host=$($env:COMPUTERNAME)" | Out-Null