obzervo-agent 1.0.0

package/bin/index.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const axios = require('axios');
+const fs = require('fs');
+const path = require('path');
+
+const program = new Command();
+
+program
+  .name('obzervo')
+  .description('Obzervo Local CLI Observability and Monitoring Agent')
+  .version('1.0.0');
+
+program
+  .command('monitor')
+  .description('Monitor a local or private HTTP endpoint and stream telemetry to Obzervo')
+  .option('-e, --endpointId <id>', 'Target endpoint ID in Obzervo')
+  .option('-t, --targetUrl <url>', 'Local target URL, for example http://localhost:3000/health')
+  .option('-k, --key <apiKey>', 'Obzervo API key, for example obz_live_...')
+  .option('-m, --method <httpMethod>', 'HTTP method (GET, POST, PUT, etc.)', 'GET')
+  .option('-c, --expectedStatus <status>', 'Expected HTTP status code', 200)
+  .option('-s, --serverUrl <serverUrl>', 'Obzervo API server URL', 'http://localhost:5000')
+  .option('-i, --interval <intervalMs>', 'Ping interval in milliseconds', 10000)
+  .action(async (options) => {
+    let { endpointId, targetUrl, key, method, expectedStatus, serverUrl, interval } = options;
+
+    const configPath = path.join(process.cwd(), 'obzervo.json');
+    if (fs.existsSync(configPath)) {
+      try {
+        const fileConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        endpointId = endpointId || fileConfig.endpointId;
+        targetUrl = targetUrl || fileConfig.targetUrl;
+        key = key || fileConfig.apiKey;
+        method = method || fileConfig.method || 'GET';
+        expectedStatus = expectedStatus || fileConfig.expectedStatus || 200;
+        serverUrl = serverUrl || fileConfig.serverUrl || 'http://localhost:5000';
+        interval = interval || fileConfig.interval || 10000;
+        console.log('[Obzervo Agent] Loaded local configuration from obzervo.json');
+      } catch (err) {
+        console.error('[Obzervo Agent Error] Failed to parse obzervo.json:', err.message);
+      }
+    }
+
+    if (!endpointId || !targetUrl || !key) {
+      console.error('\nMissing required parameters.');
+      console.error('Usage: obzervo monitor --endpointId <ID> --targetUrl <URL> --key <API_KEY>');
+      console.error('Or create an obzervo.json config file in the project directory.\n');
+      process.exit(1);
+    }
+
+    const targetExpectedStatus = Number(expectedStatus) || 200;
+    const targetMethod = (method || 'GET').toUpperCase();
+
+    console.log('\n======================================================');
+    console.log('Obzervo Local CLI Monitoring Agent Started');
+    console.log('======================================================');
+    console.log(` Target URL:      ${targetUrl}`);
+    console.log(` Method:          ${targetMethod}`);
+    console.log(` Expected Status: ${targetExpectedStatus}`);
+    console.log(` Endpoint ID:     ${endpointId}`);
+    console.log(` API Server:      ${serverUrl}`);
+    console.log(` Interval:        Every ${Number(interval) / 1000}s`);
+    console.log('======================================================\n');
+
+    const runPingCycle = async () => {
+      const startTime = process.hrtime();
+      let statusCode = 0;
+      let latencyMs = 0;
+      let responseSize = 0;
+      let isSuccess = false;
+      let errorMessage = null;
+
+      try {
+        const response = await axios({
+          method: targetMethod,
+          url: targetUrl,
+          timeout: 5000,
+          validateStatus: () => true
+        });
+
+        const diff = process.hrtime(startTime);
+        latencyMs = parseFloat((diff[0] * 1000 + diff[1] / 1e6).toFixed(2));
+        statusCode = response.status;
+
+        const rawData = JSON.stringify(response.data || '');
+        responseSize = Buffer.byteLength(rawData, 'utf8');
+
+        isSuccess = statusCode === targetExpectedStatus;
+        if (!isSuccess) {
+          errorMessage = `HTTP Status ${statusCode} did not match expected status ${targetExpectedStatus}`;
+        }
+      } catch (err) {
+        const diff = process.hrtime(startTime);
+        latencyMs = parseFloat((diff[0] * 1000 + diff[1] / 1e6).toFixed(2));
+
+        if (err.response) {
+          statusCode = err.response.status;
+          errorMessage = `HTTP ${statusCode}: ${err.response.statusText}`;
+        } else if (err.code === 'ECONNABORTED') {
+          statusCode = 408;
+          errorMessage = 'Local HTTP request timeout after 5000ms';
+        } else {
+          statusCode = 0;
+          errorMessage = err.message || 'Connection refused or DNS failure';
+        }
+        isSuccess = false;
+      }
+
+
+      try {
+        await axios.post(
+          `${serverUrl}/api/v1/telemetry/push`,
+          {
+            endpointId,
+            statusCode,
+            latencyMs,
+            responseSize,
+            isSuccess,
+            errorMessage
+          },
+          {
+            headers: {
+              'x-api-key': key,
+              'Content-Type': 'application/json'
+            },
+            timeout: 5000
+          }
+        );
+
+        const timestamp = new Date().toLocaleTimeString();
+        if (isSuccess) {
+          console.log(`[${timestamp}] PING OK | ${statusCode} | ${latencyMs}ms | ${responseSize} B`);
+        } else {
+          console.log(`[${timestamp}] PING FAIL | ${statusCode} | ${latencyMs}ms | Error: ${errorMessage}`);
+        }
+      } catch (pushErr) {
+        const timestamp = new Date().toLocaleTimeString();
+        console.error(`[${timestamp}] Telemetry Push Failed:`, pushErr.response?.data?.message || pushErr.message);
+      }
+    };
+
+    await runPingCycle();
+    setInterval(runPingCycle, Number(interval));
+  });
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "obzervo-agent",
+  "version": "1.0.0",
+  "description": "Obzervo Local & VPC Microservice Monitoring CLI Agent",
+  "bin": {
+    "obzervo": "./bin/index.js",
+    "obzervo-agent": "./bin/index.js"
+  },
+  "main": "./bin/index.js",
+  "files": [
+    "bin/"
+  ],
+  "preferGlobal": true,
+  "scripts": {
+    "start": "node ./bin/index.js"
+  },
+  "keywords": [
+    "obzervo",
+    "monitoring",
+    "cli",
+    "observability",
+    "sre",
+    "telemetry",
+    "agent"
+  ],
+  "author": "Obzervo SRE Team",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.8",
+    "commander": "^12.0.0"
+  }
+}