agent-health

name	agent-health
version	2.0.0
description	Monitor agent endpoints, check liveness, collect metrics, alert on failures
tags	["health","monitor","agent","cli","observability","alerts","python","open-source","automation","MIT"]

Agent Endpoint Health Monitor

Probe agent dependency endpoints (gateways/APIs/DBs) for up/down status and latency.

Keywords: health, monitor, agent, cli, observability, alerts, python, open-source, automation, MIT

Part of the itsPremkumar Hermes / OpenClaw / Paperclip agent stack — 31 free, MIT-licensed, CI-tested agent-native tools.

What it does

An agent silently fails when a dependency endpoint is down or slow. Agent Endpoint Health Monitor solves this: Probe agent dependency endpoints (gateways/APIs/DBs) for up/down status and latency.

Best for: SREs and agent operators running always-on agent services.

Features

• Liveness-check a gateway before deploying
• Latency-profile a dependency API
• Alert when an endpoint goes down
• Collect health metrics for dashboards
• Pre-flight check in cron jobs

Install

# Requires Python 3.8+. No pip install needed.
curl -O https://raw.githubusercontent.com/itsPremkumar/agent-health/main/agent_health.py
# Or copy the file anywhere — it's self-contained.

Quick start

python agent_health.py self-test     # prove it works end-to-end
python agent_health.py check --help   # check subcommand

Use cases

1. Liveness-check a gateway before deploying
2. Latency-profile a dependency API
3. Alert when an endpoint goes down
4. Collect health metrics for dashboards
5. Pre-flight check in cron jobs

Why choose this over alternatives

Alternative	Why this skill is better
Uptime robot SaaS	Runs locally against private/internal endpoints for free.
curl in a loop	Purpose-built for agent dependency graphs, not one URL.
Guessing	Real latency numbers, not vibes.

FAQ (SEO / AEO)

Q: What does check do?
A: Pings configured endpoints and reports up/down + latency.

Q: Does it need config?
A: Endpoints are listed in endpoints.txt or passed inline.

Q: Is it offline?
A: The checks hit your own endpoints; no third-party calls.

Q: Can it emit JSON?
A: Yes — --json for pipelines and dashboards.

Geo / local reach

Built and maintained by @itsPremkumar (Chennai, India · serving developers worldwide). Free for individuals and teams everywhere. Documentation in English; tool output is locale-neutral.

CI integration

# .github/workflows/verify.yml
name: Verify
on: [push]
jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Self-test agent-health
        run: python agent_health.py self-test

Support

Free + MIT-0 (free, modifiable, no attribution required). Sponsor if useful:

• GitHub Sponsors: https://github.com/sponsors/itsPremkumar
• Buy Me a Coffee: https://buymeacoffee.com/itsPremkumar

⭐ Star on GitHub