🌐 node-red-contrib-http-monitor

Monitor HTTP endpoints in Node-RED with detailed metrics, SSL info, and authentication support! 🚦🔒

✨ Features

• ⏱️ Response Time & Metrics: Track DNS, TCP, SSL, and HTTP timings
• 🔐 SSL/TLS Analysis: Get server certificate details, cipher suite, and protocol
• 🛡️ Authentication: Supports None, Basic, OAuth (token retrieval), and more
• 📦 Custom Headers: Set user-agent and custom request headers
• 🚨 Status & Content Checks: Verify status codes, response content, and download limits
• 📊 History: Persists metrics to monitor-history.json

🚀 Installation

cd ~/.node-red
npm install node-red-contrib-http-monitor

🛠️ Usage

1. Restart Node-RED after installation.

2. In the Node-RED editor, drag the HTTP Monitor node from the sidebar (category: function).

3. Double-click the node to configure:

   • Name: Friendly label for your monitor
   • Monitor Config: Paste or edit JSON config (see below)

Example Config

{
  "url": "https://example.com",
  "interval": 60,
  "timeout": 30,
  "target_response_time": 1000,
  "authentication": {
    "scheme": "None"
  },
  "request": {
    "method": "GET",
    "follow_redirects": true,
    "user_agent": "HTTPMonitor/1.0",
    "custom_headers": {},
    "max_redirects": 5
  },
  "response": {
    "desired_status_code": "2xx",
    "verify_content": "",
    "download_limit_kb": 1024
  }
}

💡 Tip: You can pass a config via msg.options for dynamic monitoring.

📥 Input

• msg.options: Configuration object (see above)

📤 Output

• msg.payload: Monitoring result object, including:
  • status: "success", "warning", or "error"
  • timestamp
  • url
  • response: status code, headers, body size, content verification
  • ssl: server certificate info, protocol, cipher suite
  • timing: DNS, TCP, SSL, HTTP timings
  • error: error details (if any)

🔒 Authentication Schemes

• None: No authentication
• Basic: Provide username and password
• OAuth: Provide oauth object with auth_url, auth_method, auth_headers
• (NTLM/Kerberos: stub only)

📚 More Info

• http-monitor.js