@adalo/metrics 0.0.0-staging.1

package/lib/metrics/metricsClient.js

@@ -0,0 +1,239 @@
+"use strict";
+
+const fs = require('fs');
+const os = require('os');
+const {
+  BaseMetricsClient
+} = require('./baseMetricsClient');
+
+/**
+ * MetricsClient handles Prometheus metrics collection and push.
+ * Supports gauges, counters, default metrics, and custom metrics.
+ * Extends BaseMetricsClient for common functionality.
+ */
+class MetricsClient extends BaseMetricsClient {
+  /**
+   * @param {Object} config
+   * @param {string} [config.appName] Name of the application
+   * @param {string} [config.dynoId] Dyno/instance ID
+   * @param {string} [config.processType] Process type (web, worker, etc.)
+   * @param {boolean} [config.enabled] Enable metrics collection
+   * @param {boolean} [config.httpMetricsEnabled=false] Enable HTTP request metrics (app_requests_total, app_requests_total_duration)
+   * @param {boolean} [config.logValues] Log metrics values to console
+   * @param {string} [config.pushgatewayUrl] PushGateway URL
+   * @param {string} [config.pushgatewaySecret] PushGateway secret token
+   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics
+   * @param {boolean} [config.removeOldMetrics] Enable to clear metrics by service name
+   * @param {function} [config.startupValidation] Add to validate on start push.
+   * @param {boolean} [config.disablePushgateway] Disable pushing to Pushgateway (use HTTP scraping instead)
+   */
+  constructor(config = {}) {
+    super(config);
+    this.httpMetricsEnabled = config.httpMetricsEnabled ?? process.env.METRICS_HTTP_ENABLED === 'true' ?? false;
+    this._lastUsageMicros = 0;
+    this._lastCheckTime = Date.now();
+    this._initDefaultMetrics();
+  }
+
+  /**
+   * Register all built-in default Gauges and Counters.
+   * @private
+   */
+  _initDefaultMetrics = () => {
+    this.createGauge({
+      name: 'app_process_cpu_usage_percent',
+      help: 'Current CPU usage of the Node.js process in percent',
+      updateFn: this.getCpuUsagePercent
+    });
+    this.createGauge({
+      name: 'app_available_cpu_count',
+      help: 'How many CPU cores are available to this process',
+      updateFn: this.getAvailableCPUs
+    });
+    this.createGauge({
+      name: 'app_container_memory_usage_bytes',
+      help: 'Current container RAM usage from cgroup',
+      updateFn: this.getContainerMemoryUsage
+    });
+    this.createGauge({
+      name: 'app_event_loop_lag_ms',
+      help: 'Estimated event loop lag in milliseconds',
+      updateFn: this.measureLag
+    });
+    this.createGauge({
+      name: 'app_container_memory_limit_bytes',
+      help: 'Max RAM available to container from cgroup (memory.max)',
+      updateFn: this.getContainerMemoryLimit
+    });
+    this.createGauge({
+      name: 'app_uptime_seconds',
+      help: 'How long the process has been running',
+      updateFn: process.uptime
+    });
+    if (this.httpMetricsEnabled) {
+      this.createCounter({
+        name: 'app_requests_total',
+        help: 'Total number of HTTP requests',
+        labelNames: this.withDefaultLabels(['method', 'route', 'appId', 'databaseId', 'status_code'])
+      });
+      this.createCounter({
+        name: 'app_requests_total_duration',
+        help: 'Total duration of HTTP requests in milliseconds',
+        labelNames: this.withDefaultLabels(['method', 'route', 'appId', 'databaseId', 'status_code'])
+      });
+    }
+  };
+
+  /**
+   * Get CPU usage percent (cgroup-aware)
+   * @returns {number}
+   */
+  getCpuUsagePercent = () => {
+    try {
+      const stat = fs.readFileSync('/sys/fs/cgroup/cpu.stat', 'utf-8');
+      const match = stat.match(/usage_usec (\d+)/);
+      if (!match) return 0;
+      const now = Date.now();
+      const currentUsage = parseInt(match[1], 10);
+      if (this._lastUsageMicros === 0) {
+        this._lastUsageMicros = currentUsage;
+        this._lastCheckTime = now;
+        return 0;
+      }
+      const deltaUsage = currentUsage - this._lastUsageMicros;
+      const deltaTime = now - this._lastCheckTime;
+      this._lastUsageMicros = currentUsage;
+      this._lastCheckTime = now;
+      return deltaUsage / (deltaTime * 1000) * 100;
+    } catch {
+      return 0;
+    }
+  };
+
+  /**
+   * Get available CPU cores.
+   * @returns {number}
+   */
+  getAvailableCPUs() {
+    try {
+      const cpuMaxPath = '/sys/fs/cgroup/cpu.max';
+      if (fs.existsSync(cpuMaxPath)) {
+        const [quotaStr, periodStr] = fs.readFileSync(cpuMaxPath, 'utf8').trim().split(' ');
+        if (quotaStr === 'max') return os.cpus().length;
+        return parseInt(quotaStr, 10) / parseInt(periodStr, 10);
+      }
+      return os.cpus().length;
+    } catch {
+      return 1;
+    }
+  }
+
+  /**
+   * Get container memory usage in bytes.
+   * @returns {number}
+   */
+  getContainerMemoryUsage() {
+    try {
+      return parseInt(fs.readFileSync('/sys/fs/cgroup/memory.current', 'utf-8').trim(), 10);
+    } catch {
+      return process.memoryUsage().rss;
+    }
+  }
+
+  /**
+   * Get container memory limit in bytes.
+   * @returns {number}
+   */
+  getContainerMemoryLimit() {
+    try {
+      const path = '/sys/fs/cgroup/memory.max';
+      if (fs.existsSync(path)) {
+        const val = fs.readFileSync(path, 'utf-8').trim();
+        if (val !== 'max') {
+          const parsed = parseInt(val, 10);
+          if (parsed && parsed < os.totalmem()) return parsed;
+        }
+      }
+      return os.totalmem();
+    } catch {
+      return os.totalmem();
+    }
+  }
+
+  /**
+   * Measure event loop lag in ms.
+   * @returns {Promise<number>}
+   */
+  measureLag() {
+    return new Promise(resolve => {
+      const start = Date.now();
+      setImmediate(() => resolve(Date.now() - start));
+    });
+  }
+
+  /**
+   * Increment the HTTP requests counter with detailed request information.
+   *
+   * @param {Object} params - The parameters for the request counter.
+   * @param {string} params.method - HTTP method (GET, POST, etc.).
+   * @param {string} params.route - The full requested URL or route.
+   * @param {number} params.status_code - HTTP response status code.
+   * @param {string} [params.appId=''] - Optional application identifier.
+   * @param {string} [params.databaseId=''] - Optional database identifier.
+   * @param {number} params.duration - Request duration in milliseconds.
+   */
+  trackHttpRequest({
+    method,
+    route,
+    status_code,
+    appId = '',
+    databaseId = '',
+    duration
+  }) {
+    if (!this.httpMetricsEnabled) return;
+    this.countersFunctions?.app_requests_total({
+      method,
+      route,
+      status_code,
+      appId,
+      databaseId
+    });
+    this.countersFunctions?.app_requests_total_duration({
+      method,
+      route,
+      status_code,
+      appId,
+      databaseId
+    }, duration);
+  }
+
+  /**
+   * Express middleware to track HTTP requests.
+   * Track the `app_requests_total` and `app_requests_total_duration` metric.
+   */
+  trackHttpRequestMiddleware = (req, res, next) => {
+    if (!this.enabled || !this.httpMetricsEnabled || req.method === 'OPTIONS') {
+      next();
+      return;
+    }
+    const start = Date.now();
+    res.on('finish', () => {
+      const route = req.route?.path || req.path || 'unknown';
+      const appId = req.params?.appId || req.body?.appId || req.query?.appId || '';
+      const databaseId = req.params?.databaseId || req.body?.databaseId || req.query?.databaseId || req.params?.datasourceId || req.body?.datasourceId || req.query?.datasourceId || '';
+      this.trackHttpRequest({
+        method: req.method,
+        route,
+        status_code: res.statusCode,
+        appId,
+        databaseId,
+        duration: Date.now() - start
+      });
+    });
+    next();
+  };
+}
+module.exports = {
+  MetricsClient
+};
+//# sourceMappingURL=metricsClient.js.map

package/lib/metrics/metricsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsClient.js","names":["fs","require","os","BaseMetricsClient","MetricsClient","constructor","config","httpMetricsEnabled","process","env","METRICS_HTTP_ENABLED","_lastUsageMicros","_lastCheckTime","Date","now","_initDefaultMetrics","createGauge","name","help","updateFn","getCpuUsagePercent","getAvailableCPUs","getContainerMemoryUsage","measureLag","getContainerMemoryLimit","uptime","createCounter","labelNames","withDefaultLabels","stat","readFileSync","match","currentUsage","parseInt","deltaUsage","deltaTime","cpuMaxPath","existsSync","quotaStr","periodStr","trim","split","cpus","length","memoryUsage","rss","path","val","parsed","totalmem","Promise","resolve","start","setImmediate","trackHttpRequest","method","route","status_code","appId","databaseId","duration","countersFunctions","app_requests_total","app_requests_total_duration","trackHttpRequestMiddleware","req","res","next","enabled","on","params","body","query","datasourceId","statusCode","module","exports"],"sources":["../../src/metrics/metricsClient.js"],"sourcesContent":["const fs = require('fs')\nconst os = require('os')\nconst { BaseMetricsClient } = require('./baseMetricsClient')\n\n/**\n * MetricsClient handles Prometheus metrics collection and push.\n * Supports gauges, counters, default metrics, and custom metrics.\n * Extends BaseMetricsClient for common functionality.\n */\nclass MetricsClient extends BaseMetricsClient {\n  /**\n   * @param {Object} config\n   * @param {string} [config.appName] Name of the application\n   * @param {string} [config.dynoId] Dyno/instance ID\n   * @param {string} [config.processType] Process type (web, worker, etc.)\n   * @param {boolean} [config.enabled] Enable metrics collection\n   * @param {boolean} [config.httpMetricsEnabled=false] Enable HTTP request metrics (app_requests_total, app_requests_total_duration)\n   * @param {boolean} [config.logValues] Log metrics values to console\n   * @param {string} [config.pushgatewayUrl] PushGateway URL\n   * @param {string} [config.pushgatewaySecret] PushGateway secret token\n   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics\n   * @param {boolean} [config.removeOldMetrics] Enable to clear metrics by service name\n   * @param {function} [config.startupValidation] Add to validate on start push.\n   * @param {boolean} [config.disablePushgateway] Disable pushing to Pushgateway (use HTTP scraping instead)\n   */\n  constructor(config = {}) {\n    super(config)\n\n    this.httpMetricsEnabled =\n      config.httpMetricsEnabled ??\n      process.env.METRICS_HTTP_ENABLED === 'true' ??\n      false\n\n    this._lastUsageMicros = 0\n    this._lastCheckTime = Date.now()\n\n    this._initDefaultMetrics()\n  }\n\n  /**\n   * Register all built-in default Gauges and Counters.\n   * @private\n   */\n  _initDefaultMetrics = () => {\n    this.createGauge({\n      name: 'app_process_cpu_usage_percent',\n      help: 'Current CPU usage of the Node.js process in percent',\n      updateFn: this.getCpuUsagePercent,\n    })\n\n    this.createGauge({\n      name: 'app_available_cpu_count',\n      help: 'How many CPU cores are available to this process',\n      updateFn: this.getAvailableCPUs,\n    })\n\n    this.createGauge({\n      name: 'app_container_memory_usage_bytes',\n      help: 'Current container RAM usage from cgroup',\n      updateFn: this.getContainerMemoryUsage,\n    })\n\n    this.createGauge({\n      name: 'app_event_loop_lag_ms',\n      help: 'Estimated event loop lag in milliseconds',\n      updateFn: this.measureLag,\n    })\n\n    this.createGauge({\n      name: 'app_container_memory_limit_bytes',\n      help: 'Max RAM available to container from cgroup (memory.max)',\n      updateFn: this.getContainerMemoryLimit,\n    })\n\n    this.createGauge({\n      name: 'app_uptime_seconds',\n      help: 'How long the process has been running',\n      updateFn: process.uptime,\n    })\n\n    if (this.httpMetricsEnabled) {\n      this.createCounter({\n        name: 'app_requests_total',\n        help: 'Total number of HTTP requests',\n        labelNames: this.withDefaultLabels([\n          'method',\n          'route',\n          'appId',\n          'databaseId',\n          'status_code',\n        ]),\n      })\n\n      this.createCounter({\n        name: 'app_requests_total_duration',\n        help: 'Total duration of HTTP requests in milliseconds',\n        labelNames: this.withDefaultLabels([\n          'method',\n          'route',\n          'appId',\n          'databaseId',\n          'status_code',\n        ]),\n      })\n    }\n  }\n\n  /**\n   * Get CPU usage percent (cgroup-aware)\n   * @returns {number}\n   */\n  getCpuUsagePercent = () => {\n    try {\n      const stat = fs.readFileSync('/sys/fs/cgroup/cpu.stat', 'utf-8')\n      const match = stat.match(/usage_usec (\\d+)/)\n      if (!match) return 0\n\n      const now = Date.now()\n      const currentUsage = parseInt(match[1], 10)\n\n      if (this._lastUsageMicros === 0) {\n        this._lastUsageMicros = currentUsage\n        this._lastCheckTime = now\n        return 0\n      }\n\n      const deltaUsage = currentUsage - this._lastUsageMicros\n      const deltaTime = now - this._lastCheckTime\n\n      this._lastUsageMicros = currentUsage\n      this._lastCheckTime = now\n\n      return (deltaUsage / (deltaTime * 1000)) * 100\n    } catch {\n      return 0\n    }\n  }\n\n  /**\n   * Get available CPU cores.\n   * @returns {number}\n   */\n  getAvailableCPUs() {\n    try {\n      const cpuMaxPath = '/sys/fs/cgroup/cpu.max'\n      if (fs.existsSync(cpuMaxPath)) {\n        const [quotaStr, periodStr] = fs\n          .readFileSync(cpuMaxPath, 'utf8')\n          .trim()\n          .split(' ')\n        if (quotaStr === 'max') return os.cpus().length\n        return parseInt(quotaStr, 10) / parseInt(periodStr, 10)\n      }\n      return os.cpus().length\n    } catch {\n      return 1\n    }\n  }\n\n  /**\n   * Get container memory usage in bytes.\n   * @returns {number}\n   */\n  getContainerMemoryUsage() {\n    try {\n      return parseInt(\n        fs.readFileSync('/sys/fs/cgroup/memory.current', 'utf-8').trim(),\n        10\n      )\n    } catch {\n      return process.memoryUsage().rss\n    }\n  }\n\n  /**\n   * Get container memory limit in bytes.\n   * @returns {number}\n   */\n  getContainerMemoryLimit() {\n    try {\n      const path = '/sys/fs/cgroup/memory.max'\n      if (fs.existsSync(path)) {\n        const val = fs.readFileSync(path, 'utf-8').trim()\n        if (val !== 'max') {\n          const parsed = parseInt(val, 10)\n          if (parsed && parsed < os.totalmem()) return parsed\n        }\n      }\n      return os.totalmem()\n    } catch {\n      return os.totalmem()\n    }\n  }\n\n  /**\n   * Measure event loop lag in ms.\n   * @returns {Promise<number>}\n   */\n  measureLag() {\n    return new Promise(resolve => {\n      const start = Date.now()\n      setImmediate(() => resolve(Date.now() - start))\n    })\n  }\n\n  /**\n   * Increment the HTTP requests counter with detailed request information.\n   *\n   * @param {Object} params - The parameters for the request counter.\n   * @param {string} params.method - HTTP method (GET, POST, etc.).\n   * @param {string} params.route - The full requested URL or route.\n   * @param {number} params.status_code - HTTP response status code.\n   * @param {string} [params.appId=''] - Optional application identifier.\n   * @param {string} [params.databaseId=''] - Optional database identifier.\n   * @param {number} params.duration - Request duration in milliseconds.\n   */\n  trackHttpRequest({\n    method,\n    route,\n    status_code,\n    appId = '',\n    databaseId = '',\n    duration,\n  }) {\n    if (!this.httpMetricsEnabled) return\n\n    this.countersFunctions?.app_requests_total({\n      method,\n      route,\n      status_code,\n      appId,\n      databaseId,\n    })\n    this.countersFunctions?.app_requests_total_duration(\n      {\n        method,\n        route,\n        status_code,\n        appId,\n        databaseId,\n      },\n      duration\n    )\n  }\n\n  /**\n   * Express middleware to track HTTP requests.\n   * Track the `app_requests_total` and `app_requests_total_duration` metric.\n   */\n  trackHttpRequestMiddleware = (req, res, next) => {\n    if (!this.enabled || !this.httpMetricsEnabled || req.method === 'OPTIONS') {\n      next()\n      return\n    }\n\n    const start = Date.now()\n    res.on('finish', () => {\n      const route = req.route?.path || req.path || 'unknown'\n      const appId =\n        req.params?.appId || req.body?.appId || req.query?.appId || ''\n      const databaseId =\n        req.params?.databaseId ||\n        req.body?.databaseId ||\n        req.query?.databaseId ||\n        req.params?.datasourceId ||\n        req.body?.datasourceId ||\n        req.query?.datasourceId ||\n        ''\n\n      this.trackHttpRequest({\n        method: req.method,\n        route,\n        status_code: res.statusCode,\n        appId,\n        databaseId,\n        duration: Date.now() - start,\n      })\n    })\n\n    next()\n  }\n}\n\nmodule.exports = { MetricsClient }\n"],"mappings":"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","ignoreList":[]}

package/lib/metrics/metricsDatabaseClient.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DatabaseMetricsClient collects Postgres connection metrics
+ * and pushes them to Prometheus Pushgateway.
+ *
+ * @extends BaseMetricsClient
+ */
+export class DatabaseMetricsClient extends BaseMetricsClient {
+    /**
+     * @param {Object} options
+     * @param {string} options.databaseUrl - Required main database URL
+     * @param {string} options.databaseName - Main database name for metrics
+     * @param {Object<string, string>} [options.additional_database_urls] - Optional additional DBs, keyed by custom name with URL as value
+     * @param {string} [options.appName] - Application name (from BaseMetricsClient)
+     * @param {string} [options.dynoId] - Dyno/instance ID (from BaseMetricsClient)
+     * @param {string} [options.processType] - Process type (from BaseMetricsClient)
+     * @param {boolean} [options.enabled] - Enable metrics collection (from BaseMetricsClient)
+     * @param {boolean} [options.logValues] - Log metrics values (from BaseMetricsClient)
+     * @param {string} [options.pushgatewayUrl] - PushGateway URL (from BaseMetricsClient)
+     * @param {string} [options.pushgatewaySecret] - PushGateway secret token (from BaseMetricsClient)
+     * @param {number} [options.intervalSec] - Interval in seconds for pushing metrics
+     * @param {boolean} [options.removeOldMetrics] - Remove old metrics by service
+     * @param {function} [options.startupValidation] - Function to validate startup
+     * @param {boolean} [options.disablePushgateway] - Disable pushing to Pushgateway (use HTTP scraping instead)
+     */
+    constructor({ databaseUrl, databaseName, additional_database_urls, ...metricsConfig }?: {
+        databaseUrl: string;
+        databaseName: string;
+        additional_database_urls?: {
+            [x: string]: string;
+        } | undefined;
+        appName?: string | undefined;
+        dynoId?: string | undefined;
+        processType?: string | undefined;
+        enabled?: boolean | undefined;
+        logValues?: boolean | undefined;
+        pushgatewayUrl?: string | undefined;
+        pushgatewaySecret?: string | undefined;
+        intervalSec?: number | undefined;
+        removeOldMetrics?: boolean | undefined;
+        startupValidation?: Function | undefined;
+        disablePushgateway?: boolean | undefined;
+    });
+    databasePools: any[];
+    /** Gauge for Database connections */
+    databaseConnectionsGauge: import("prom-client").Gauge<string>;
+    _addPool: (url: any, dbKey: any) => Pool;
+    /**
+     * @param {Pool} pool - PG connection pool
+     * @returns {Promise<{ current: number, max: number, dbName: string }>}
+     */
+    getDBConnectionsAndName: (pool: Pool) => Promise<{
+        current: number;
+        max: number;
+        dbName: string;
+    }>;
+    /**
+     * Collect database connection metrics for all configured pools
+     * @returns {Promise<void>}
+     */
+    collectDatabaseMetrics: () => Promise<void>;
+    /**
+     * Push database metrics to Prometheus Pushgateway
+     * @returns {Promise<void>}
+     */
+    pushDatabaseMetrics: () => Promise<void>;
+    /**
+     * Start periodic collection.
+     * @param {number} [intervalSec=this.intervalSec] - Interval in seconds
+     */
+    startPush: (intervalSec?: number | undefined) => void;
+}
+import { BaseMetricsClient } from "./baseMetricsClient";
+import { Pool } from "pg";
+//# sourceMappingURL=metricsDatabaseClient.d.ts.map

package/lib/metrics/metricsDatabaseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsDatabaseClient.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsDatabaseClient.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IACE;;;;;;;;;;;;;;;;OAgBG;IACH;QAf2B,WAAW,EAA3B,MAAM;QACU,YAAY,EAA5B,MAAM;QAC2B,wBAAwB;;;QACxC,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QACf,iBAAiB;QAClB,kBAAkB;OAkF9C;IAtBC,qBAAuB;IAUvB,qCAAqC;IACrC,8DAQE;IAKJ,yCAKC;IAED;;;OAGG;IACH,gCAHW,IAAI,KACF,QAAQ;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CA4BrE;IAED;;;OAGG;IACH,8BAFa,QAAQ,IAAI,CAAC,CAsBzB;IAED;;;OAGG;IACH,2BAFa,QAAQ,IAAI,CAAC,CAqBzB;IAED;;;OAGG;IACH,sDAMC;CAwBF"}

package/lib/metrics/metricsDatabaseClient.js

@@ -0,0 +1,218 @@
+"use strict";
+
+const {
+  Pool
+} = require('pg');
+const {
+  BaseMetricsClient
+} = require('./baseMetricsClient');
+
+/**
+ * DatabaseMetricsClient collects Postgres connection metrics
+ * and pushes them to Prometheus Pushgateway.
+ *
+ * @extends BaseMetricsClient
+ */
+class DatabaseMetricsClient extends BaseMetricsClient {
+  /**
+   * @param {Object} options
+   * @param {string} options.databaseUrl - Required main database URL
+   * @param {string} options.databaseName - Main database name for metrics
+   * @param {Object<string, string>} [options.additional_database_urls] - Optional additional DBs, keyed by custom name with URL as value
+   * @param {string} [options.appName] - Application name (from BaseMetricsClient)
+   * @param {string} [options.dynoId] - Dyno/instance ID (from BaseMetricsClient)
+   * @param {string} [options.processType] - Process type (from BaseMetricsClient)
+   * @param {boolean} [options.enabled] - Enable metrics collection (from BaseMetricsClient)
+   * @param {boolean} [options.logValues] - Log metrics values (from BaseMetricsClient)
+   * @param {string} [options.pushgatewayUrl] - PushGateway URL (from BaseMetricsClient)
+   * @param {string} [options.pushgatewaySecret] - PushGateway secret token (from BaseMetricsClient)
+   * @param {number} [options.intervalSec] - Interval in seconds for pushing metrics
+   * @param {boolean} [options.removeOldMetrics] - Remove old metrics by service
+   * @param {function} [options.startupValidation] - Function to validate startup
+   * @param {boolean} [options.disablePushgateway] - Disable pushing to Pushgateway (use HTTP scraping instead)
+   */
+  constructor({
+    databaseUrl,
+    databaseName,
+    additional_database_urls = {},
+    ...metricsConfig
+  } = {}) {
+    const intervalSec = metricsConfig.intervalSec || parseInt(process.env.METRICS_DATABASE_INTERVAL_SEC || '', 10) || 60;
+    const tmpAppName = metricsConfig.appName || process.env.BUILD_APP_NAME || 'unknown-app';
+    const mainDbName = databaseName || `${tmpAppName}_db`;
+    const startupValidation = async () => {
+      if (!databaseUrl) {
+        console.error(`[database-metrics] ❌ METRICS_DATABASE_URL is required`);
+        return false;
+      }
+      try {
+        const mainPool = new Pool({
+          connectionString: databaseUrl
+        });
+        await mainPool.query('SELECT 1');
+        await mainPool.end();
+        console.info(`[database-metrics] ✓ Main database OK: ${mainDbName}`);
+      } catch (err) {
+        console.error(`[database-metrics] ❌ Cannot connect to main database: ${err.message}`);
+        return false;
+      }
+      for (const [dbKey, url] of Object.entries(additional_database_urls)) {
+        try {
+          const p = new Pool({
+            connectionString: url
+          });
+          await p.query('SELECT 1');
+          await p.end();
+          console.info(`[database-metrics] ✓ Additional database OK: ${dbKey}`);
+        } catch (err) {
+          console.error(`[database-metrics] ⚠ Skipping additional database: ${dbKey}`);
+          console.error(`[database-metrics]    ${err.message}`);
+        }
+      }
+      console.info(`[database-metrics] Database metrics collection starting`);
+      return true;
+    };
+    super({
+      ...metricsConfig,
+      processType: metricsConfig.processType || 'database-metrics',
+      intervalSec,
+      startupValidation
+    });
+    this.databasePools = [];
+    if (databaseUrl) {
+      this._addPool(databaseUrl, mainDbName);
+    }
+    for (const [dbKey, url] of Object.entries(additional_database_urls)) {
+      this._addPool(url, dbKey);
+    }
+
+    /** Gauge for Database connections */
+    this.databaseConnectionsGauge = this.createGauge({
+      name: 'app_database_connections',
+      help: 'Postgres database connections',
+      labelNames: this.withDefaultLabels(['max_connections', 'database_name', 'db_key'])
+    });
+    this._setCleanupHandlers();
+  }
+  _addPool = (url, dbKey) => {
+    const pool = new Pool({
+      connectionString: url
+    });
+    pool.dbKey = dbKey;
+    this.databasePools.push(pool);
+    return pool;
+  };
+
+  /**
+   * @param {Pool} pool - PG connection pool
+   * @returns {Promise<{ current: number, max: number, dbName: string }>}
+   */
+  getDBConnectionsAndName = async pool => {
+    try {
+      const currentRes = await pool.query('SELECT COUNT(*) AS current FROM pg_stat_activity WHERE datname = current_database()');
+      const current = parseInt(currentRes.rows[0]?.current || 0, 10);
+      const maxRes = await pool.query("SELECT current_setting('max_connections') AS max");
+      const max = parseInt(maxRes.rows[0]?.max || 0, 10);
+      let dbName = pool.options?.database;
+      if (!dbName && pool.options?.connectionString) {
+        try {
+          const url = new URL(pool.options.connectionString);
+          dbName = url.pathname.replace(/^\//, '');
+        } catch {
+          dbName = pool.options.connectionString;
+        }
+      }
+      return {
+        current,
+        max,
+        dbName
+      };
+    } catch (err) {
+      return {
+        current: 0,
+        max: 0,
+        dbName: pool.options?.database || ''
+      };
+    }
+  };
+
+  /**
+   * Collect database connection metrics for all configured pools
+   * @returns {Promise<void>}
+   */
+  collectDatabaseMetrics = async () => {
+    for (const pool of this.databasePools) {
+      try {
+        const {
+          current,
+          max,
+          dbName
+        } = await this.getDBConnectionsAndName(pool);
+        this.databaseConnectionsGauge.set({
+          ...this.getDefaultLabels(),
+          database_name: pool.dbKey,
+          max_connections: String(max),
+          db_key: dbName
+        }, current);
+      } catch (err) {
+        console.warn(`[database-metrics] Failed to collect: ${err.message}`);
+      }
+    }
+  };
+
+  /**
+   * Push database metrics to Prometheus Pushgateway
+   * @returns {Promise<void>}
+   */
+  pushDatabaseMetrics = async () => {
+    try {
+      await this.collectDatabaseMetrics();
+      await this.gatewayPush();
+      this.clearAllCounters();
+      if (this.metricsLogValues) {
+        const metricObjects = await this.registry.getMetricsAsJSON();
+        console.info(`[database-metrics] Collected DB metrics`, JSON.stringify(metricObjects, null, 2));
+      }
+    } catch (error) {
+      console.error(`[database-metrics] Failed to collect DB metrics: ${error.message}`);
+      throw error;
+    }
+  };
+
+  /**
+   * Start periodic collection.
+   * @param {number} [intervalSec=this.intervalSec] - Interval in seconds
+   */
+  startPush = (intervalSec = this.intervalSec) => {
+    this._startPush(intervalSec, () => {
+      this.pushDatabaseMetrics().catch(err => {
+        console.error(`[database-metrics] Failed to push DB metrics:`, err);
+      });
+    });
+  };
+
+  /**
+   * Cleanup database pools and exit process
+   * @returns {Promise<void>}
+   */
+  cleanup = async () => {
+    try {
+      if (this.databasePools) {
+        for (const pool of this.databasePools) {
+          await pool.end();
+        }
+      }
+    } catch (err) {
+      console.error('[database-metrics] Error during cleanup:', err);
+    }
+    process.exit(0);
+  };
+  _setCleanupHandlers = () => {
+    process.on('SIGINT', this.cleanup);
+    process.on('SIGTERM', this.cleanup);
+  };
+}
+module.exports = {
+  DatabaseMetricsClient
+};
+//# sourceMappingURL=metricsDatabaseClient.js.map

package/lib/metrics/metricsDatabaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsDatabaseClient.js","names":["Pool","require","BaseMetricsClient","DatabaseMetricsClient","constructor","databaseUrl","databaseName","additional_database_urls","metricsConfig","intervalSec","parseInt","process","env","METRICS_DATABASE_INTERVAL_SEC","tmpAppName","appName","BUILD_APP_NAME","mainDbName","startupValidation","console","error","mainPool","connectionString","query","end","info","err","message","dbKey","url","Object","entries","p","processType","databasePools","_addPool","databaseConnectionsGauge","createGauge","name","help","labelNames","withDefaultLabels","_setCleanupHandlers","pool","push","getDBConnectionsAndName","currentRes","current","rows","maxRes","max","dbName","options","database","URL","pathname","replace","collectDatabaseMetrics","set","getDefaultLabels","database_name","max_connections","String","db_key","warn","pushDatabaseMetrics","gatewayPush","clearAllCounters","metricsLogValues","metricObjects","registry","getMetricsAsJSON","JSON","stringify","startPush","_startPush","catch","cleanup","exit","on","module","exports"],"sources":["../../src/metrics/metricsDatabaseClient.js"],"sourcesContent":["const { Pool } = require('pg')\nconst { BaseMetricsClient } = require('./baseMetricsClient')\n\n/**\n * DatabaseMetricsClient collects Postgres connection metrics\n * and pushes them to Prometheus Pushgateway.\n *\n * @extends BaseMetricsClient\n */\nclass DatabaseMetricsClient extends BaseMetricsClient {\n  /**\n   * @param {Object} options\n   * @param {string} options.databaseUrl - Required main database URL\n   * @param {string} options.databaseName - Main database name for metrics\n   * @param {Object<string, string>} [options.additional_database_urls] - Optional additional DBs, keyed by custom name with URL as value\n   * @param {string} [options.appName] - Application name (from BaseMetricsClient)\n   * @param {string} [options.dynoId] - Dyno/instance ID (from BaseMetricsClient)\n   * @param {string} [options.processType] - Process type (from BaseMetricsClient)\n   * @param {boolean} [options.enabled] - Enable metrics collection (from BaseMetricsClient)\n   * @param {boolean} [options.logValues] - Log metrics values (from BaseMetricsClient)\n   * @param {string} [options.pushgatewayUrl] - PushGateway URL (from BaseMetricsClient)\n   * @param {string} [options.pushgatewaySecret] - PushGateway secret token (from BaseMetricsClient)\n   * @param {number} [options.intervalSec] - Interval in seconds for pushing metrics\n   * @param {boolean} [options.removeOldMetrics] - Remove old metrics by service\n   * @param {function} [options.startupValidation] - Function to validate startup\n   * @param {boolean} [options.disablePushgateway] - Disable pushing to Pushgateway (use HTTP scraping instead)\n   */\n  constructor({\n    databaseUrl,\n    databaseName,\n    additional_database_urls = {},\n    ...metricsConfig\n  } = {}) {\n    const intervalSec =\n      metricsConfig.intervalSec ||\n      parseInt(process.env.METRICS_DATABASE_INTERVAL_SEC || '', 10) ||\n      60\n\n    const tmpAppName =\n      metricsConfig.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    const mainDbName = databaseName || `${tmpAppName}_db`\n\n    const startupValidation = async () => {\n      if (!databaseUrl) {\n        console.error(`[database-metrics] ❌ METRICS_DATABASE_URL is required`)\n        return false\n      }\n\n      try {\n        const mainPool = new Pool({ connectionString: databaseUrl })\n        await mainPool.query('SELECT 1')\n        await mainPool.end()\n        console.info(`[database-metrics] ✓ Main database OK: ${mainDbName}`)\n      } catch (err) {\n        console.error(\n          `[database-metrics] ❌ Cannot connect to main database: ${err.message}`\n        )\n        return false\n      }\n\n      for (const [dbKey, url] of Object.entries(additional_database_urls)) {\n        try {\n          const p = new Pool({ connectionString: url })\n          await p.query('SELECT 1')\n          await p.end()\n          console.info(`[database-metrics] ✓ Additional database OK: ${dbKey}`)\n        } catch (err) {\n          console.error(\n            `[database-metrics] ⚠ Skipping additional database: ${dbKey}`\n          )\n          console.error(`[database-metrics]    ${err.message}`)\n        }\n      }\n\n      console.info(`[database-metrics] Database metrics collection starting`)\n      return true\n    }\n\n    super({\n      ...metricsConfig,\n      processType: metricsConfig.processType || 'database-metrics',\n      intervalSec,\n      startupValidation,\n    })\n\n    this.databasePools = []\n\n    if (databaseUrl) {\n      this._addPool(databaseUrl, mainDbName)\n    }\n\n    for (const [dbKey, url] of Object.entries(additional_database_urls)) {\n      this._addPool(url, dbKey)\n    }\n\n    /** Gauge for Database connections */\n    this.databaseConnectionsGauge = this.createGauge({\n      name: 'app_database_connections',\n      help: 'Postgres database connections',\n      labelNames: this.withDefaultLabels([\n        'max_connections',\n        'database_name',\n        'db_key',\n      ]),\n    })\n\n    this._setCleanupHandlers()\n  }\n\n  _addPool = (url, dbKey) => {\n    const pool = new Pool({ connectionString: url })\n    pool.dbKey = dbKey\n    this.databasePools.push(pool)\n    return pool\n  }\n\n  /**\n   * @param {Pool} pool - PG connection pool\n   * @returns {Promise<{ current: number, max: number, dbName: string }>}\n   */\n  getDBConnectionsAndName = async pool => {\n    try {\n      const currentRes = await pool.query(\n        'SELECT COUNT(*) AS current FROM pg_stat_activity WHERE datname = current_database()'\n      )\n      const current = parseInt(currentRes.rows[0]?.current || 0, 10)\n\n      const maxRes = await pool.query(\n        \"SELECT current_setting('max_connections') AS max\"\n      )\n      const max = parseInt(maxRes.rows[0]?.max || 0, 10)\n\n      let dbName = pool.options?.database\n      if (!dbName && pool.options?.connectionString) {\n        try {\n          const url = new URL(pool.options.connectionString)\n          dbName = url.pathname.replace(/^\\//, '')\n        } catch {\n          dbName = pool.options.connectionString\n        }\n      }\n\n      return { current, max, dbName }\n    } catch (err) {\n      return { current: 0, max: 0, dbName: pool.options?.database || '' }\n    }\n  }\n\n  /**\n   * Collect database connection metrics for all configured pools\n   * @returns {Promise<void>}\n   */\n  collectDatabaseMetrics = async () => {\n    for (const pool of this.databasePools) {\n      try {\n        const { current, max, dbName } = await this.getDBConnectionsAndName(\n          pool\n        )\n\n        this.databaseConnectionsGauge.set(\n          {\n            ...this.getDefaultLabels(),\n            database_name: pool.dbKey,\n            max_connections: String(max),\n            db_key: dbName,\n          },\n          current\n        )\n      } catch (err) {\n        console.warn(`[database-metrics] Failed to collect: ${err.message}`)\n      }\n    }\n  }\n\n  /**\n   * Push database metrics to Prometheus Pushgateway\n   * @returns {Promise<void>}\n   */\n  pushDatabaseMetrics = async () => {\n    try {\n      await this.collectDatabaseMetrics()\n      await this.gatewayPush()\n      this.clearAllCounters()\n\n      if (this.metricsLogValues) {\n        const metricObjects = await this.registry.getMetricsAsJSON()\n        console.info(\n          `[database-metrics] Collected DB metrics`,\n          JSON.stringify(metricObjects, null, 2)\n        )\n      }\n    } catch (error) {\n      console.error(\n        `[database-metrics] Failed to collect DB metrics: ${error.message}`\n      )\n      throw error\n    }\n  }\n\n  /**\n   * Start periodic collection.\n   * @param {number} [intervalSec=this.intervalSec] - Interval in seconds\n   */\n  startPush = (intervalSec = this.intervalSec) => {\n    this._startPush(intervalSec, () => {\n      this.pushDatabaseMetrics().catch(err => {\n        console.error(`[database-metrics] Failed to push DB metrics:`, err)\n      })\n    })\n  }\n\n  /**\n   * Cleanup database pools and exit process\n   * @returns {Promise<void>}\n   */\n  cleanup = async () => {\n    try {\n      if (this.databasePools) {\n        for (const pool of this.databasePools) {\n          await pool.end()\n        }\n      }\n    } catch (err) {\n      console.error('[database-metrics] Error during cleanup:', err)\n    }\n\n    process.exit(0)\n  }\n\n  _setCleanupHandlers = () => {\n    process.on('SIGINT', this.cleanup)\n    process.on('SIGTERM', this.cleanup)\n  }\n}\n\nmodule.exports = { DatabaseMetricsClient }\n"],"mappings":"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","ignoreList":[]}

package/lib/metrics/metricsQueueRedisClient.d.ts

@@ -0,0 +1,57 @@
+/**
+ * QueueRedisMetricsClient extends RedisMetricsClient to collect
+ * Redis and Bee Queue metrics periodically and push them to Prometheus Pushgateway.
+ *
+ * @extends RedisMetricsClient
+ */
+export class QueueRedisMetricsClient extends RedisMetricsClient {
+    getConfiguredQueueNames: () => string[];
+    startupValidation: () => boolean;
+    /** Cache for queue objects to avoid multiple connections */
+    queueCache: Map<any, any>;
+    /** Gauge for queue jobs by status */
+    queueJobsGauge: import("prom-client").Gauge<string>;
+    /**
+     * Execute a Redis command in a client-type safe way.
+     *
+     * @param {string[]} args Command args array, e.g. ['LLEN', 'key']
+     * @returns {Promise<any>}
+     */
+    _send: (args: string[]) => Promise<any>;
+    _toNumber: (v: any) => number;
+    _getQueueType: (queueName: any) => Promise<"bull" | "bee">;
+    _getBullHealth: (queueName: any) => Promise<{
+        waiting: number;
+        active: number;
+        succeeded: number;
+        failed: number;
+        delayed: number;
+    }>;
+    _getBeeQueueHealth: (queueName: any) => Promise<{
+        waiting: number;
+        active: number;
+        succeeded: number;
+        failed: number;
+        delayed: number;
+    }>;
+    /**
+     * Collect metrics for a single queue and set gauges.
+     *
+     * Supports:
+     * - Bull (default): keys like `bull:<queue>:wait`, `...:active`, `...:completed`, `...:failed`, `...:delayed`
+     * - Bee-Queue: keys like `bq:<queue>:waiting`, `...:active`, `...:succeeded`, `...:failed`, `...:delayed`
+     *
+     * Auto-detects queue type unless `METRICS_QUEUE_TYPE` is set to `bull` or `bee`.
+     *
+     * @param {string} queueName - Name of the queue
+     * @returns {Promise<void>}
+     */
+    collectSingleQueueMetrics: (queueName: string) => Promise<void>;
+    /**
+     * Collect metrics for all queues and Redis, then push to Pushgateway
+     * @returns {Promise<void>}
+     */
+    collectQueueMetrics: () => Promise<void>;
+}
+import { RedisMetricsClient } from "./metricsRedisClient";
+//# sourceMappingURL=metricsQueueRedisClient.d.ts.map

package/lib/metrics/metricsQueueRedisClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsQueueRedisClient.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsQueueRedisClient.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IAgEI,wCAAsD;IACtD,iCAA0C;IAE1C,4DAA4D;IAa5D,0BAA2B;IAE3B,qCAAqC;IACrC,oDAIE;IAKJ;;;;;OAKG;IACH,cAHW,MAAM,EAAE,KACN,QAAQ,GAAG,CAAC,CA6BxB;IAED,8BAGC;IAED,2DA6BC;IAED;;;;;;OAmBC;IAED;;;;;;OAwBC;IAED;;;;;;;;;;;OAWG;IACH,uCAHW,MAAM,KACJ,QAAQ,IAAI,CAAC,CAyCzB;IAED;;;OAGG;IACH,2BAFa,QAAQ,IAAI,CAAC,CAuCzB;CAoCF"}