Skip to main content
← back to extensions

Sre

@webframp/srev2026.09.04.1· 11d agoWORKFLOWSREPORTS
01README

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
02Release Notes

2026.09.04.1

Changed: Bump @webframp/network 2026.08.26.2 → 2026.08.28.1

Changed: Bump @webframp/system 2026.08.26.2 → 2026.08.28.1

2026.08.28.2

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.28.1

Changed: Bump @webframp/network 2026.07.18.1 → 2026.08.26.2

Changed: Bump @webframp/system 2026.07.18.1 → 2026.08.26.2

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

03Workflows1
@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
04Reports1
@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
05Previous Versions13
2026.08.28.2

2026.08.28.2

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.28.1

Changed: Bump @webframp/network 2026.07.18.1 → 2026.08.26.2

Changed: Bump @webframp/system 2026.07.18.1 → 2026.08.26.2

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

2026.08.28.1

2026.08.28.1

Changed: Bump @webframp/network 2026.07.18.1 → 2026.08.26.2

Changed: Bump @webframp/system 2026.07.18.1 → 2026.08.26.2

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

updated dependencies

2026.08.26.1

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

2026.08.25.1

2026.08.25.1

Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.

updated labels

2026.08.24.1

2026.08.24.1

Added Troubleshooting section documenting DEGRADED status meaning, allowFailure workflow design, target/targetHost input relationship, hardcoded thresholds, and asymmetric no-data handling.

2026.08.21.1

2026.08.21.1

Changed: The health report no longer silently drops a check when its underlying probe or diagnostic data can't be read. Previously, if the data repository lookup failed or returned bytes that weren't valid JSON, the report quietly treated the check as if it never ran (no finding, no explanation). Both failure modes are now logged with the model/data target and the underlying error, so a missing section in the report can be traced back to a data-access or parsing problem instead of looking like a step that simply didn't execute.

2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/network 2026.07.16.1 → 2026.07.18.1
  • @webframp/system 2026.06.21.1 → 2026.07.18.1

updated dependencies

2026.07.20.1

2026.07.20.1

Changed: Refreshed dependency pins to the latest published releases. No behavioral changes to the health-check workflow or report.

Upgrade note: Bumps @webframp/network 2026.05.21.1 → 2026.07.16.1 and @webframp/system 2026.04.22.1 → 2026.06.21.1, pulled automatically with this extension.

updated dependencies

2026.07.18.1

2026.07.18.1

Changed: Version bump only, no code changes.

2026.05.24.1

updated dependencies

2026.04.22.1

updated platforms

2026.04.14.1
2026.04.13.2
06Stats
A
100 / 100
Downloads
32
Archive size
16.1 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/webframp/swamp-extensions
07Platforms
08Labels
#health-check#observability#ops#sre#workflow