@radzor/uptime-monitor

Monitor URL uptime with configurable check intervals, latency tracking, and status change alerts. Supports multiple targets, pause/resume, and downtime history. Zero dependencies — uses raw fetch.

v0.1.0typescriptpythonServeruptimemonitoringavailabilitylatencyalertingpingby Radzor

Install

View source on GitHub →

$npx radzor@latest add uptime-monitor

⚠ Constraints: Uses raw fetch() for HTTP checks — the target must be reachable from the server. Check intervals are managed via setInterval with unref() to avoid keeping the process alive. A target is considered 'down' if fetch throws or the HTTP status is >= 500. Status codes 2xx-4xx are considered 'up'.

Inputs

Name	Type	Default	Description
intervalMs	number	60000	Default check interval in milliseconds.
timeout	number	10000	HTTP request timeout in milliseconds per check.
latencyThresholdMs	number	2000	Latency threshold in ms; exceeding it fires onLatencySpike.
headers	Record<string, string>	—	Default HTTP headers sent with each check request.

intervalMsnumber

Default check interval in milliseconds.

default: 60000

timeoutnumber

HTTP request timeout in milliseconds per check.

{ "llm": { "constraints": "Uses raw fetch() for HTTP checks — the target must be reachable from the server. Check intervals are managed via setInterval with unref() to avoid keeping the process alive. A target is considered 'down' if fetch throws or the HTTP status is >= 500. Status codes 2xx-4xx are considered 'up'.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/uptime-monitor", "tags": [ "uptime", "monitoring", "availability", "latency", "alerting", "ping" ], "events": [ { "name": "onDown", "payload": { "url": "string", "error": "string", "timestamp": "number", "consecutiveFailures": "number" }, "description": "Fired when a target goes down (first failure after being up)." }, { "name": "onRecovered", "payload": { "url": "string", "timestamp": "number", "downtimeMs": "number" }, "description": "Fired when a target recovers after being down." }, { "name": "onLatencySpike", "payload": { "url": "string", "latencyMs": "number", "threshold": "number", "timestamp": "number" }, "description": "Fired when response latency exceeds the configured threshold." } ], "inputs": [ { "name": "intervalMs", "type": "number", "default": 60000, "required": false, "description": "Default check interval in milliseconds." }, { "name": "timeout", "type": "number", "default": 10000, "required": false, "description": "HTTP request timeout in milliseconds per check." }, { "name": "latencyThresholdMs", "type": "number", "default": 2000, "required": false, "description": "Latency threshold in ms; exceeding it fires onLatencySpike." }, { "name": "headers", "type": "Record<string, string>", "required": false, "description": "Default HTTP headers sent with each check request." } ], "radzor": "1.0.0", "actions": [ { "name": "addTarget", "params": [ { "name": "url", "type": "string", "description": "URL to monitor." }, { "name": "name", "type": "string", "required": false, "description": "Human-readable name for the target." }, { "name": "intervalMs", "type": "number", "required": false, "description": "Override the default check interval for this target." } ], "returns": "void", "description": "Add a URL to the monitoring list and start checking it." }, { "name": "removeTarget", "params": [ { "name": "url", "type": "string", "description": "URL to stop monitoring." } ], "returns": "void", "description": "Remove a target and stop its checks." }, { "name": "getStatus", "params": [ { "name": "url", "type": "string", "required": false, "description": "URL to get status for. If omitted, returns all targets." } ], "returns": "UptimeReport | UptimeReport[]", "description": "Get the current status report for one or all targets." }, { "name": "pause", "params": [ { "name": "url", "type": "string", "required": false, "description": "URL to pause monitoring for." } ], "returns": "void", "description": "Pause monitoring for a target (or all if URL omitted)." }, { "name": "resume", "params": [ { "name": "url", "type": "string", "required": false, "description": "URL to resume monitoring for." } ], "returns": "void", "description": "Resume monitoring for a paused target (or all if URL omitted)." } ], "outputs": [ { "name": "uptimeReport", "type": "UptimeReport", "fields": [ { "name": "url", "type": "string", "description": "Monitored URL." }, { "name": "status", "type": "'up' | 'down' | 'unknown'", "description": "Current status." }, { "name": "latencyMs", "type": "number", "description": "Latest response latency in ms." }, { "name": "uptimePercent", "type": "number", "description": "Uptime percentage based on check history." }, { "name": "lastChecked", "type": "number", "description": "Timestamp of last check." }, { "name": "consecutiveFailures", "type": "number", "description": "Number of consecutive failed checks." }, { "name": "totalChecks", "type": "number", "description": "Total number of checks performed." } ], "description": "Status report for a monitored target." } ], "runtime": "server", "version": "0.1.0", "category": "monitoring", "languages": [ "typescript", "python" ], "description": "Monitor URL uptime with configurable check intervals, latency tracking, and status change alerts. Supports multiple targets, pause/resume, and downtime history. Zero dependencies — uses raw fetch.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "event": "onDown", "description": "Alert team when a monitored service goes down", "compatibleWith": [ "@radzor/notification-hub.action.send.body", "@radzor/slack-bot.action.sendMessage.text", "@radzor/email-send.action.send.message", "@radzor/push-notification.action.sendToDevice.token" ] }, { "event": "onRecovered", "description": "Notify when service recovers", "compatibleWith": [ "@radzor/slack-bot.action.sendMessage.text", "@radzor/notification-hub.action.send.body" ] }, { "event": "onLatencySpike", "description": "Alert on latency spikes", "compatibleWith": [ "@radzor/slack-bot.action.sendMessage.text", "@radzor/log-aggregator.action.warn.message" ] } ] } }

@radzor/uptime-monitor

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json