heartbeat-monitor

{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Label for what is monitored, e.g. "nightly-backup" or "research-agent-loop".'}, 'email': {'type': 'string', 'description': "Email address for DOWN and recovery alerts. STRONGLY RECOMMENDED — without an email or webhook_url, Cronping tracks status but cannot notify anyone when the job stops, which defeats the purpose. Use your operator's email."}, 'pull_url': {'type': 'string', 'description': "Optional. If set, creates a PULL check instead: Cronping itself fetches this URL every period_seconds and alerts if it fails — use for a target that can't call a ping URL (a public health endpoint, status page, or API). No ping needed."}, 'stuck_after': {'type': 'number', 'description': 'Optional. Flip to STUCK if the progress_token passed to ping_heartbeat stays identical for this many consecutive runs (default 3, 0 disables). Catches zombie runs that keep pinging but make no progress.'}, 'webhook_url': {'type': 'string', 'description': 'https webhook (Slack/Discord/generic) for DOWN and recovery alerts. Set this OR email so someone is actually notified when the monitored job goes silent.'}, 'grace_seconds': {'type': 'number', 'description': 'Extra slack before marking DOWN, in seconds. Default 3600.'}, 'pull_contains': {'type': 'string', 'description': 'Optional (pull checks only). The fetched response body must contain this text to count as UP; otherwise Cronping alerts.'}, 'period_seconds': {'type': 'number', 'description': 'How often you expect a ping, in seconds (min 60). Default 86400 (daily).'}}}

{'type': 'object', 'required': ['id', 'claim_token'], 'properties': {'id': {'type': 'string', 'description': 'The check id returned by create_heartbeat.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token returned by create_heartbeat.'}}}

{'type': 'object', 'required': ['id', 'claim_token'], 'properties': {'id': {'type': 'string'}, 'claim_token': {'type': 'string', 'description': 'The claim_token returned by create_heartbeat.'}}}

{'type': 'object', 'required': ['crontab'], 'properties': {'email': {'type': 'string', 'description': 'Optional. Email address for DOWN and recovery alerts, applied to every check created. STRONGLY RECOMMENDED — without it the checks track status but cannot notify anyone.'}, 'crontab': {'type': 'string', 'description': 'Raw crontab text, one job per line (comments and FOO=bar env lines are ignored). Standard 5-field expressions plus @daily/@hourly/@weekly/@monthly/@yearly macros and named days/months are supported.'}}}

{'type': 'object', 'required': ['id', 'claim_token'], 'properties': {'id': {'type': 'string', 'description': 'The check id returned by create_heartbeat.'}, 'paused': {'type': 'boolean', 'description': 'true to pause monitoring, false to resume it. Defaults to true.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token returned by create_heartbeat.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The check id returned by create_heartbeat.'}, 'signal': {'enum': ['success', 'start', 'fail'], 'type': 'string', 'description': 'success | start | fail. Default success.'}, 'progress_token': {'type': 'string', 'description': "Optional. A short digest/hash of this run's output (e.g. last-processed id, row count, content hash). If it stays identical across stuck_after consecutive runs, the check flips to STUCK and alerts."}}}

{'type': 'object', 'required': ['id', 'claim_token'], 'properties': {'id': {'type': 'string', 'description': 'The check id returned by create_heartbeat.'}, 'email': {'type': 'string', 'description': 'Email address to notify (e.g. the operator/owner). Pass empty string to clear.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token returned by create_heartbeat.'}, 'webhook_url': {'type': 'string', 'description': 'Optional https webhook (Slack/Discord/generic) to notify. Pass empty string to clear.'}}}