health-check-automation

name	health-check-automation
description	Generate deployable scripts for automated health checks. Includes Node.js, Python, and Bash implementations. Runs periodic checks and generates reports.

Health Check Automation

Create and deploy automated scripts for periodic site health verification. Generates reports and alerts on issues found.

Scope Context

Post-approval automation layer. Generates deployable scripts that invoke audit skills on a schedule.

Field	Value
Phase	Post-approval automation
Depends on	All primary audit skills (content-audit, technical-audit, ux-compliance-audit, policy-risk-scanner, seo-spam-detection)
ARB item coverage	Configurable; defaults to Core 79 for lightweight scheduled checks
Score mode	Core 79 for daily automated checks; Core 79 + Profile for weekly; Full 105 for monthly

Each automated run should log score_mode and timestamp for a complete audit trail.

Purpose

Automate health checks post-approval:

• Periodic content quality scans
• Performance metric collection
• Link validity verification
• SEO health assessment
• Generate automated reports

Quick Start

Choose your environment:

Node.js Implementation

Install:

npm install axios cheerio moment

Script (health-check.js):

const axios = require('axios');
const cheerio = require('cheerio');
const fs = require('fs');

const config = {
  site_url: 'https://example.com',
  check_pages: 10,
  interval: 86400 // Daily (seconds)
};

async function healthCheck() {
  const report = {
    timestamp: new Date(),
    checks: []
  };

  // Check 1: Site up?
  try {
    await axios.get(config.site_url, { timeout: 5000 });
    report.checks.push({ name: 'Uptime', status: 'pass' });
  } catch (e) {
    report.checks.push({ name: 'Uptime', status: 'fail', error: e.message });
  }

  // Check 2: SSL certificate valid?
  const https_check = await axios.get(config.site_url);
  if (https_check.config.url.startsWith('https')) {
    report.checks.push({ name: 'HTTPS', status: 'pass' });
  }

  // Check 3: Robots.txt exists?
  try {
    await axios.get(`${config.site_url}/robots.txt`);
    report.checks.push({ name: 'Robots.txt', status: 'pass' });
  } catch {
    report.checks.push({ name: 'Robots.txt', status: 'fail' });
  }

  // Save report
  fs.writeFileSync(`./reports/health-${Date.now()}.json`, JSON.stringify(report));
  console.log('Health check complete:', report);
}

// Run daily
setInterval(healthCheck, config.interval * 1000);
healthCheck(); // First run

Run:

node health-check.js &

---

Python Implementation

Requirements (requirements.txt):

requests==2.28.0
beautifulsoup4==4.11.0
pytz==2022.1

Script (health_check.py):

import requests
import json
from datetime import datetime
import schedule
import time

CONFIG = {
    'site_url': 'https://example.com',
    'check_pages': 10
}

def health_check():
    report = {
        'timestamp': datetime.now().isoformat(),
        'checks': []
    }

    # Check uptime
    try:
        response = requests.get(CONFIG['site_url'], timeout=5)
        report['checks'].append({
            'name': 'Uptime',
            'status': 'pass' if response.status_code == 200 else 'fail'
        })
    except Exception as e:
        report['checks'].append({'name': 'Uptime', 'status': 'fail', 'error': str(e)})

    # Check HTTPS
    if CONFIG['site_url'].startswith('https'):
        report['checks'].append({'name': 'HTTPS', 'status': 'pass'})

    # Check robots.txt
    try:
        requests.get(f"{CONFIG['site_url']}/robots.txt")
        report['checks'].append({'name': 'Robots.txt', 'status': 'pass'})
    except:
        report['checks'].append({'name': 'Robots.txt', 'status': 'fail'})

    # Save report
    with open(f"reports/health-{datetime.now().timestamp()}.json", 'w') as f:
        json.dump(report, f)

    return report

# Schedule daily check at 6 AM
schedule.every().day.at("06:00").do(health_check)

while True:
    schedule.run_pending()
    time.sleep(60)

Run:

python health_check.py &

---

Bash Implementation

Script (health-check.sh):

#!/bin/bash

SITE_URL="https://example.com"
REPORT_DIR="./reports"
TIMESTAMP=$(date +%Y-%m-%d_%H-%M-%S)
REPORT="$REPORT_DIR/health-$TIMESTAMP.txt"

mkdir -p $REPORT_DIR

echo "Health Check Report - $TIMESTAMP" > $REPORT
echo "===================================" >> $REPORT

# Check uptime
echo -n "Uptime: " >> $REPORT
if curl -s -o /dev/null -w "%{http_code}" $SITE_URL | grep -q "200"; then
  echo "PASS" >> $REPORT
else
  echo "FAIL" >> $REPORT
fi

# Check HTTPS
echo -n "HTTPS: " >> $REPORT
if curl -s $SITE_URL | grep -q "https"; then
  echo "PASS" >> $REPORT
else
  echo "FAIL" >> $REPORT
fi

# Check robots.txt
echo -n "Robots.txt: " >> $REPORT
if curl -s -I $SITE_URL/robots.txt | grep -q "200"; then
  echo "PASS" >> $REPORT
else
  echo "FAIL" >> $REPORT
fi

echo "Report saved: $REPORT"

Setup Cron (daily at 6 AM):

0 6 * * * /path/to/health-check.sh

---

Docker Implementation (Advanced)

Dockerfile:

FROM node:16-slim

WORKDIR /app
COPY health-check.js .
COPY package.json .

RUN npm install

CMD ["node", "health-check.js"]

docker-compose.yml:

version: '3'
services:
  health-check:
    build: .
    volumes:
      - ./reports:/app/reports
    restart: always

Run:

docker-compose up -d

---

Report Generation

Generate Monthly Report:

function generateMonthlyReport() {
  const reports = fs.readdirSync('./reports');
  const thisMonth = reports.filter(r => r.includes(currentMonth));
  
  const summary = {
    total_checks: thisMonth.length,
    failed_checks: thisMonth.filter(r => r.includes('fail')).length,
    success_rate: '95%'
  };
  
  sendEmailReport(summary);
}

---

Dashboard Integration

Export to CSV:

const json2csv = require('json2csv');
const data = JSON.parse(fs.readFileSync('reports/health.json'));
const csv = json2csv.parse(data);
fs.writeFileSync('reports/health.csv', csv);

Push to Monitoring Service:

// Send to DataDog, New Relic, or Grafana
const axios = require('axios');

axios.post('https://api.datadoghq.com/api/v2/events', {
  title: 'Health Check',
  text: report.summary,
  alert_type: 'info'
}, {
  headers: { 'DD-API-KEY': process.env.DATADOG_KEY }
});

---

Monitoring Checklist

• Script runs daily
• Reports generated successfully
• No accumulation of old reports
• Alerts triggering on failures
• Dashboard updated with latest data

---

Related Skills:

• Set alerts → alert-rules-setup
• Monitor compliance → active-compliance-monitor