Skip to main content

@webframp/sre

v2026.04.22.1

SRE Health Check - Unified site reliability health check workflow with report.

Runs network probes (HTTP, TLS certs, DNS, ports) against target endpoints and collects local system health (disk, memory, load), then generates a unified SRE health report with actionable findings.

Quick Start

# Install the extension (auto-resolves dependencies)
swamp extension pull @webframp/sre

# Create model instances
swamp model create @webframp/network net-probe
swamp model create @webframp/system sys-diag

# Run the health check workflow
swamp workflow run @webframp/sre-health-check --input target=https://example.com

Included Components

Workflows

  • @webframp/sre-health-check - Unified health check workflow that:
    • Checks HTTP endpoint status and timing
    • Inspects TLS certificate expiry
    • Resolves DNS records
    • Tests TCP port connectivity
    • Checks disk, memory, and system load
    • Generates a health report with severity-rated findings

Reports

  • @webframp/sre-health-report - Workflow-scope report that aggregates findings into:
    • Overall health status (HEALTHY/WARNING/CRITICAL/DEGRADED)
    • Severity-rated findings per check
    • Actionable recommendations

Model Dependencies

The workflow expects these model instances (create them before running):

  • net-probe - @webframp/network
  • sys-diag - @webframp/system

Repository

https://github.com/webframp/swamp-extensions

Labels

sreopshealth-checkworkflow

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @webframp/sre

@webframp/sre-health-check893ef149-d509-44de-9755-69b95f4087a8

Site reliability health check workflow. Runs network probes (HTTP, TLS certs, DNS, ports) against target endpoints and collects local system health (disk, memory, load), then generates a unified SRE health report with actionable findings.

network-probesRun network probes against the target endpoint
1.http-checknet-probe.http_check— Check HTTP endpoint status and timing
2.cert-checknet-probe.cert_check— Inspect TLS certificate expiry
3.dns-checknet-probe.dns_lookup— Resolve DNS A records for the target
4.port-checknet-probe.port_check— Check TCP port connectivity
system-healthCollect local system health metrics
1.disk-usagesys-diag.get_disk_usage— Check filesystem disk usage
2.memory-usagesys-diag.get_memory— Check memory and swap usage
3.system-loadsys-diag.get_uptime— Check uptime and load averages
finalizeTrigger report generation after all probes complete
1.os-infosys-diag.get_os_info— Collect OS info for report context

@webframp/sre-health-reportworkflow
sre_health_report.ts

Aggregates network probe and system health data into an SRE health check report with actionable findings

sreopshealth-check