@adalo/metrics 0.1.173 → 0.1.175

package/lib/metrics/metricsClient.js

@@ -8,28 +8,34 @@ const {
 
 /**
  * MetricsClient handles Prometheus metrics collection and push.
- * Supports gauges, counters, default metrics, and custom metrics.
- * Extends BaseMetricsClient for common functionality.
+ * Supports gauges, default process metrics, optional HTTP counters, and custom metrics.
+ *
+ * **HTTP metrics:** In-process counters only (`app_requests_*`), gated by `httpMetricsEnabled` /
+ * `METRICS_HTTP_ENABLED`. For Redis-backed HTTP aggregation (multi-web / cluster), use
+ * {@link HttpMetricsRedisRecorder} and {@link HttpMetricsRedisCollector} — not this class.
+ *
+ * @extends BaseMetricsClient
  */
 class MetricsClient extends BaseMetricsClient {
   /**
-   * @param {Object} config
+   * @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.httpMetricsEnabled] Enable HTTP request metrics (`app_requests_total`, `app_requests_total_duration`); defaults from `METRICS_HTTP_ENABLED === 'true'`
    * @param {boolean} [config.logValues] Log metrics values to console
-   * @param {string} [config.pushgatewayUrl] PushGateway URL
-   * @param {string} [config.pushgatewaySecret] PushGateway secret token
+   * @param {string} [config.pushgatewayUrl] Push URL (VM-agent import endpoint, e.g. .../api/v1/import/prometheus). /metrics is for GET (scrape), not POST (push).
+   * @param {string} [config.pushgatewaySecret] Basic auth secret (Base64 of `user:password`)
    * @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)
+   * @param {function} [config.startupValidation] Add to validate on start push
+   * @param {boolean} [config.disablePushgateway] Disable pushing to VM-agent (use HTTP scraping instead)
+   * @param {boolean} [config.blockNodeDefaultMetrics] When true, skip prom-client default process metrics (rare; see {@link BaseMetricsClient})
    */
   constructor(config = {}) {
     super(config);
-    this.httpMetricsEnabled = config.httpMetricsEnabled ?? process.env.METRICS_HTTP_ENABLED === 'true' ?? false;
+    this.httpMetricsEnabled = config.httpMetricsEnabled !== undefined ? config.httpMetricsEnabled : process.env.METRICS_HTTP_ENABLED === 'true';
     this._lastUsageMicros = 0;
     this._lastCheckTime = Date.now();
     this._initDefaultMetrics();
@@ -74,13 +80,13 @@ class MetricsClient extends BaseMetricsClient {
       this.createCounter({
         name: 'app_requests_total',
         help: 'Total number of HTTP requests',
-        labelNames: this.withDefaultLabelsWithoutDynoId(['method', 'route', 'appId', 'databaseId', 'status_code']),
+        labelNames: this.withDefaultLabelsWithoutDynoId(['method', 'route', 'status_code']),
         useLabelsWithoutDynoId: true
       });
       this.createCounter({
         name: 'app_requests_total_duration',
         help: 'Total duration of HTTP requests in milliseconds',
-        labelNames: this.withDefaultLabelsWithoutDynoId(['method', 'route', 'appId', 'databaseId', 'status_code']),
+        labelNames: this.withDefaultLabelsWithoutDynoId(['method', 'route', 'status_code']),
         useLabelsWithoutDynoId: true
       });
     }
@@ -113,7 +119,7 @@ class MetricsClient extends BaseMetricsClient {
   };
 
   /**
-   * Get available CPU cores.
+   * Available CPU cores (cgroup quota or `os.cpus().length`).
    * @returns {number}
    */
   getAvailableCPUs() {
@@ -131,7 +137,7 @@ class MetricsClient extends BaseMetricsClient {
   }
 
   /**
-   * Get container memory usage in bytes.
+   * Container memory usage in bytes (`memory.current` or RSS fallback).
    * @returns {number}
    */
   getContainerMemoryUsage() {
@@ -143,7 +149,7 @@ class MetricsClient extends BaseMetricsClient {
   }
 
   /**
-   * Get container memory limit in bytes.
+   * Container memory limit in bytes (`memory.max` or host total).
    * @returns {number}
    */
   getContainerMemoryLimit() {
@@ -163,7 +169,7 @@ class MetricsClient extends BaseMetricsClient {
   }
 
   /**
-   * Measure event loop lag in ms.
+   * Event loop lag sample in milliseconds.
    * @returns {Promise<number>}
    */
   measureLag() {
@@ -174,44 +180,40 @@ class MetricsClient extends BaseMetricsClient {
   }
 
   /**
-   * Increment the HTTP requests counter with detailed request information.
+   * Increment HTTP request counters (in-process). No-op if `httpMetricsEnabled` is false.
    *
-   * @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.
+   * @param {Object} params
+   * @param {string} params.method HTTP method
+   * @param {string} params.route Route or path pattern
+   * @param {number} params.status_code HTTP status code
+   * @param {number} params.duration 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
+      status_code
     });
     this.countersFunctions?.app_requests_total_duration({
       method,
       route,
-      status_code,
-      appId,
-      databaseId
+      status_code
     }, duration);
   }
 
   /**
-   * Express middleware to track HTTP requests.
-   * Track the `app_requests_total` and `app_requests_total_duration` metric.
+   * Express middleware: records `app_requests_*` on response finish.
+   * Skips when disabled, HTTP metrics off, or `OPTIONS`.
+   *
+   * @param {import('http').IncomingMessage} req
+   * @param {import('http').ServerResponse} res
+   * @param {function} next
    */
   trackHttpRequestMiddleware = (req, res, next) => {
     if (!this.enabled || !this.httpMetricsEnabled || req.method === 'OPTIONS') {
@@ -221,14 +223,10 @@ class MetricsClient extends BaseMetricsClient {
     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
       });
     });

package/lib/metrics/metricsClient.js.map

@@ -1 +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","withDefaultLabelsWithoutDynoId","useLabelsWithoutDynoId","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.withDefaultLabelsWithoutDynoId([\n          'method',\n          'route',\n          'appId',\n          'databaseId',\n          'status_code',\n        ]),\n        useLabelsWithoutDynoId: true,\n      })\n\n      this.createCounter({\n        name: 'app_requests_total_duration',\n        help: 'Total duration of HTTP requests in milliseconds',\n        labelNames: this.withDefaultLabelsWithoutDynoId([\n          'method',\n          'route',\n          'appId',\n          'databaseId',\n          'status_code',\n        ]),\n        useLabelsWithoutDynoId: true,\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":[]}
+{"version":3,"file":"metricsClient.js","names":["fs","require","os","BaseMetricsClient","MetricsClient","constructor","config","httpMetricsEnabled","undefined","process","env","METRICS_HTTP_ENABLED","_lastUsageMicros","_lastCheckTime","Date","now","_initDefaultMetrics","createGauge","name","help","updateFn","getCpuUsagePercent","getAvailableCPUs","getContainerMemoryUsage","measureLag","getContainerMemoryLimit","uptime","createCounter","labelNames","withDefaultLabelsWithoutDynoId","useLabelsWithoutDynoId","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","duration","countersFunctions","app_requests_total","app_requests_total_duration","trackHttpRequestMiddleware","req","res","next","enabled","on","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, default process metrics, optional HTTP counters, and custom metrics.\n *\n * **HTTP metrics:** In-process counters only (`app_requests_*`), gated by `httpMetricsEnabled` /\n * `METRICS_HTTP_ENABLED`. For Redis-backed HTTP aggregation (multi-web / cluster), use\n * {@link HttpMetricsRedisRecorder} and {@link HttpMetricsRedisCollector} — not this class.\n *\n * @extends BaseMetricsClient\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] Enable HTTP request metrics (`app_requests_total`, `app_requests_total_duration`); defaults from `METRICS_HTTP_ENABLED === 'true'`\n   * @param {boolean} [config.logValues] Log metrics values to console\n   * @param {string} [config.pushgatewayUrl] Push URL (VM-agent import endpoint, e.g. .../api/v1/import/prometheus). /metrics is for GET (scrape), not POST (push).\n   * @param {string} [config.pushgatewaySecret] Basic auth secret (Base64 of `user:password`)\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 VM-agent (use HTTP scraping instead)\n   * @param {boolean} [config.blockNodeDefaultMetrics] When true, skip prom-client default process metrics (rare; see {@link BaseMetricsClient})\n   */\n  constructor(config = {}) {\n    super(config)\n\n    this.httpMetricsEnabled =\n      config.httpMetricsEnabled !== undefined\n        ? config.httpMetricsEnabled\n        : process.env.METRICS_HTTP_ENABLED === 'true'\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.withDefaultLabelsWithoutDynoId([\n          'method',\n          'route',\n          'status_code',\n        ]),\n        useLabelsWithoutDynoId: true,\n      })\n\n      this.createCounter({\n        name: 'app_requests_total_duration',\n        help: 'Total duration of HTTP requests in milliseconds',\n        labelNames: this.withDefaultLabelsWithoutDynoId([\n          'method',\n          'route',\n          'status_code',\n        ]),\n        useLabelsWithoutDynoId: true,\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   * Available CPU cores (cgroup quota or `os.cpus().length`).\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   * Container memory usage in bytes (`memory.current` or RSS fallback).\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   * Container memory limit in bytes (`memory.max` or host total).\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   * Event loop lag sample in milliseconds.\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 HTTP request counters (in-process). No-op if `httpMetricsEnabled` is false.\n   *\n   * @param {Object} params\n   * @param {string} params.method HTTP method\n   * @param {string} params.route Route or path pattern\n   * @param {number} params.status_code HTTP status code\n   * @param {number} params.duration Duration in milliseconds\n   */\n  trackHttpRequest({ method, route, status_code, duration }) {\n    if (!this.httpMetricsEnabled) return\n\n    this.countersFunctions?.app_requests_total({\n      method,\n      route,\n      status_code,\n    })\n    this.countersFunctions?.app_requests_total_duration(\n      {\n        method,\n        route,\n        status_code,\n      },\n      duration\n    )\n  }\n\n  /**\n   * Express middleware: records `app_requests_*` on response finish.\n   * Skips when disabled, HTTP metrics off, or `OPTIONS`.\n   *\n   * @param {import('http').IncomingMessage} req\n   * @param {import('http').ServerResponse} res\n   * @param {function} next\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\n      this.trackHttpRequest({\n        method: req.method,\n        route,\n        status_code: res.statusCode,\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.map

@@ -1 +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,mDAAmD;IACnD,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"}
+{"version":3,"file":"metricsDatabaseClient.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsDatabaseClient.js"],"names":[],"mappings":"AAOA;;;;;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;OAoF9C;IAtBC,qBAAuB;IAUvB,mDAAmD;IACnD,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

@@ -6,6 +6,10 @@ const {
 const {
   BaseMetricsClient
 } = require('./baseMetricsClient');
+const {
+  exitUnlessProcessTypeIs,
+  METRICS_PROCESS_TYPE_DATABASE
+} = require('./metricsProcessTypeUtils');
 
 /**
  * DatabaseMetricsClient collects Postgres connection metrics
@@ -37,6 +41,7 @@ class DatabaseMetricsClient extends BaseMetricsClient {
     additional_database_urls = {},
     ...metricsConfig
   } = {}) {
+    exitUnlessProcessTypeIs(metricsConfig, METRICS_PROCESS_TYPE_DATABASE);
     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`;
@@ -74,7 +79,7 @@ class DatabaseMetricsClient extends BaseMetricsClient {
     };
     super({
       ...metricsConfig,
-      processType: metricsConfig.processType || 'database-metrics',
+      processType: metricsConfig.processType || METRICS_PROCESS_TYPE_DATABASE,
       intervalSec,
       startupValidation
     });

package/lib/metrics/metricsDatabaseClient.js.map

@@ -1 +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","withDefaultLabelsWithoutDynoId","_setCleanupHandlers","pool","push","getDBConnectionsAndName","currentRes","current","rows","maxRes","max","dbName","options","database","URL","pathname","replace","collectDatabaseMetrics","set","defaultLabelsWithoutDynoId","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 (no dyno_id). */\n    this.databaseConnectionsGauge = this.createGauge({\n      name: 'app_database_connections',\n      help: 'Postgres database connections',\n      labelNames: this.withDefaultLabelsWithoutDynoId([\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.defaultLabelsWithoutDynoId,\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":[]}
+{"version":3,"file":"metricsDatabaseClient.js","names":["Pool","require","BaseMetricsClient","exitUnlessProcessTypeIs","METRICS_PROCESS_TYPE_DATABASE","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","withDefaultLabelsWithoutDynoId","_setCleanupHandlers","pool","push","getDBConnectionsAndName","currentRes","current","rows","maxRes","max","dbName","options","database","URL","pathname","replace","collectDatabaseMetrics","set","defaultLabelsWithoutDynoId","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')\nconst {\n  exitUnlessProcessTypeIs,\n  METRICS_PROCESS_TYPE_DATABASE,\n} = require('./metricsProcessTypeUtils')\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    exitUnlessProcessTypeIs(metricsConfig, METRICS_PROCESS_TYPE_DATABASE)\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 || METRICS_PROCESS_TYPE_DATABASE,\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 (no dyno_id). */\n    this.databaseConnectionsGauge = this.createGauge({\n      name: 'app_database_connections',\n      help: 'Postgres database connections',\n      labelNames: this.withDefaultLabelsWithoutDynoId([\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.defaultLabelsWithoutDynoId,\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/metricsProcessTypeUtils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Resolve logical process type the same way specialized metrics clients do.
+ *
+ * @param {{ processType?: string }} metricsConfig - Remainder of constructor options (e.g. after destructuring `redisClient`, `databaseUrl`, …)
+ * @param {string} defaultProcessType - Fallback when `metricsConfig.processType` and `BUILD_DYNO_PROCESS_TYPE` are unset
+ * @returns {string}
+ */
+export function resolveMetricsProcessType(metricsConfig: {
+    processType?: string;
+}, defaultProcessType: string): string;
+/**
+ * Exit with no logs if the resolved process type is not exactly `expectedProcessType`.
+ *
+ * @param {{ processType?: string }} metricsConfig
+ * @param {string} expectedProcessType - Single allowed value (use a module constant, e.g. {@link METRICS_PROCESS_TYPE_DATABASE})
+ * @returns {void}
+ */
+export function exitUnlessProcessTypeIs(metricsConfig: {
+    processType?: string;
+}, expectedProcessType: string): void;
+/**
+ * Exit with no logs if the resolved process type is not in `allowedProcessTypes`.
+ *
+ * @param {{ processType?: string }} metricsConfig
+ * @param {readonly string[]} allowedProcessTypes
+ * @param {string} defaultWhenUnspecified - Used only to resolve when config/env omit `processType` (e.g. {@link METRICS_PROCESS_TYPE_QUEUE} for {@link RedisMetricsClient})
+ * @returns {void}
+ */
+export function exitUnlessProcessTypeIn(metricsConfig: {
+    processType?: string;
+}, allowedProcessTypes: readonly string[], defaultWhenUnspecified: string): void;
+/**
+ * Helpers for resolving `processType` and silently exiting when a specialized metrics client
+ * is constructed on the wrong dyno / process (no log output).
+ *
+ * **Canonical names** align with typical Procfile processes (e.g. backend: `web`, `worker`,
+ * `queue-metrics`, `database-metrics`, `http-metrics`). The compile **worker** dyno serves queues/builds
+ * — it does not run HTTP request metrics. HTTP Redis **key segment** for API traffic is fixed **`web`**
+ * (`HttpMetricsRedisCollector` / `HttpMetricsRedisRecorder`), not `BUILD_DYNO_PROCESS_TYPE`.
+ *
+ * @module metrics/metricsProcessTypeUtils
+ */
+/** DB-only metrics dyno (`database-metrics` in Procfile). */
+export const METRICS_PROCESS_TYPE_DATABASE: "database-metrics";
+/** Queue + Redis metrics dyno (`queue-metrics` in Procfile). */
+export const METRICS_PROCESS_TYPE_QUEUE: "queue-metrics";
+/** Redis-only metrics dyno (no Bee Queue; optional separate process). */
+export const METRICS_PROCESS_TYPE_REDIS: "redis-metrics";
+/** Web servers — HTTP traffic, HTTP Redis **writers** typically use this in Redis key segment. */
+export const METRICS_PROCESS_TYPE_WEB: "web";
+/** Build/compile workers and similar (e.g. backend `worker:`) — no HTTP server metrics here. */
+export const METRICS_PROCESS_TYPE_WORKER: "worker";
+/**
+ * Parent {@link RedisMetricsClient} allows either redis-only or queue stack (`QueueRedisMetricsClient`).
+ * @type {readonly string[]}
+ */
+export const REDIS_METRICS_CLIENT_ALLOWED_PROCESS_TYPES: readonly string[];
+//# sourceMappingURL=metricsProcessTypeUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metricsProcessTypeUtils.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsProcessTypeUtils.js"],"names":[],"mappings":"AAoCA;;;;;;GAMG;AACH,yDAJW;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,sBACxB,MAAM,GACJ,MAAM,CAQlB;AAED;;;;;;GAMG;AACH,uDAJW;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,uBACxB,MAAM,GACJ,IAAI,CAOhB;AAED;;;;;;;GAOG;AACH,uDALW;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,uBACxB,SAAS,MAAM,EAAE,0BACjB,MAAM,GACJ,IAAI,CAchB;AArFD;;;;;;;;;;GAUG;AAEH,6DAA6D;AAC7D,+DAAwD;AAExD,gEAAgE;AAChE,yDAAkD;AAElD,yEAAyE;AACzE,yDAAkD;AAElD,kGAAkG;AAClG,6CAAsC;AAEtC,gGAAgG;AAChG,mDAA4C;AAE5C;;;GAGG;AACH,yDAFU,SAAS,MAAM,EAAE,CAKzB"}

package/lib/metrics/metricsProcessTypeUtils.js

@@ -0,0 +1,86 @@
+"use strict";
+
+/**
+ * Helpers for resolving `processType` and silently exiting when a specialized metrics client
+ * is constructed on the wrong dyno / process (no log output).
+ *
+ * **Canonical names** align with typical Procfile processes (e.g. backend: `web`, `worker`,
+ * `queue-metrics`, `database-metrics`, `http-metrics`). The compile **worker** dyno serves queues/builds
+ * — it does not run HTTP request metrics. HTTP Redis **key segment** for API traffic is fixed **`web`**
+ * (`HttpMetricsRedisCollector` / `HttpMetricsRedisRecorder`), not `BUILD_DYNO_PROCESS_TYPE`.
+ *
+ * @module metrics/metricsProcessTypeUtils
+ */
+
+/** DB-only metrics dyno (`database-metrics` in Procfile). */
+const METRICS_PROCESS_TYPE_DATABASE = 'database-metrics';
+
+/** Queue + Redis metrics dyno (`queue-metrics` in Procfile). */
+const METRICS_PROCESS_TYPE_QUEUE = 'queue-metrics';
+
+/** Redis-only metrics dyno (no Bee Queue; optional separate process). */
+const METRICS_PROCESS_TYPE_REDIS = 'redis-metrics';
+
+/** Web servers — HTTP traffic, HTTP Redis **writers** typically use this in Redis key segment. */
+const METRICS_PROCESS_TYPE_WEB = 'web';
+
+/** Build/compile workers and similar (e.g. backend `worker:`) — no HTTP server metrics here. */
+const METRICS_PROCESS_TYPE_WORKER = 'worker';
+
+/**
+ * Parent {@link RedisMetricsClient} allows either redis-only or queue stack (`QueueRedisMetricsClient`).
+ * @type {readonly string[]}
+ */
+const REDIS_METRICS_CLIENT_ALLOWED_PROCESS_TYPES = Object.freeze([METRICS_PROCESS_TYPE_REDIS, METRICS_PROCESS_TYPE_QUEUE]);
+
+/**
+ * Resolve logical process type the same way specialized metrics clients do.
+ *
+ * @param {{ processType?: string }} metricsConfig - Remainder of constructor options (e.g. after destructuring `redisClient`, `databaseUrl`, …)
+ * @param {string} defaultProcessType - Fallback when `metricsConfig.processType` and `BUILD_DYNO_PROCESS_TYPE` are unset
+ * @returns {string}
+ */
+function resolveMetricsProcessType(metricsConfig, defaultProcessType) {
+  return metricsConfig.processType || process.env.BUILD_DYNO_PROCESS_TYPE || defaultProcessType;
+}
+
+/**
+ * Exit with no logs if the resolved process type is not exactly `expectedProcessType`.
+ *
+ * @param {{ processType?: string }} metricsConfig
+ * @param {string} expectedProcessType - Single allowed value (use a module constant, e.g. {@link METRICS_PROCESS_TYPE_DATABASE})
+ * @returns {void}
+ */
+function exitUnlessProcessTypeIs(metricsConfig, expectedProcessType) {
+  const resolved = resolveMetricsProcessType(metricsConfig, expectedProcessType);
+  if (resolved !== expectedProcessType) {
+    process.exit(0);
+  }
+}
+
+/**
+ * Exit with no logs if the resolved process type is not in `allowedProcessTypes`.
+ *
+ * @param {{ processType?: string }} metricsConfig
+ * @param {readonly string[]} allowedProcessTypes
+ * @param {string} defaultWhenUnspecified - Used only to resolve when config/env omit `processType` (e.g. {@link METRICS_PROCESS_TYPE_QUEUE} for {@link RedisMetricsClient})
+ * @returns {void}
+ */
+function exitUnlessProcessTypeIn(metricsConfig, allowedProcessTypes, defaultWhenUnspecified) {
+  const resolved = resolveMetricsProcessType(metricsConfig, defaultWhenUnspecified);
+  if (!allowedProcessTypes.includes(resolved)) {
+    process.exit(0);
+  }
+}
+module.exports = {
+  resolveMetricsProcessType,
+  exitUnlessProcessTypeIs,
+  exitUnlessProcessTypeIn,
+  METRICS_PROCESS_TYPE_DATABASE,
+  METRICS_PROCESS_TYPE_QUEUE,
+  METRICS_PROCESS_TYPE_REDIS,
+  METRICS_PROCESS_TYPE_WEB,
+  METRICS_PROCESS_TYPE_WORKER,
+  REDIS_METRICS_CLIENT_ALLOWED_PROCESS_TYPES
+};
+//# sourceMappingURL=metricsProcessTypeUtils.js.map

package/lib/metrics/metricsProcessTypeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsProcessTypeUtils.js","names":["METRICS_PROCESS_TYPE_DATABASE","METRICS_PROCESS_TYPE_QUEUE","METRICS_PROCESS_TYPE_REDIS","METRICS_PROCESS_TYPE_WEB","METRICS_PROCESS_TYPE_WORKER","REDIS_METRICS_CLIENT_ALLOWED_PROCESS_TYPES","Object","freeze","resolveMetricsProcessType","metricsConfig","defaultProcessType","processType","process","env","BUILD_DYNO_PROCESS_TYPE","exitUnlessProcessTypeIs","expectedProcessType","resolved","exit","exitUnlessProcessTypeIn","allowedProcessTypes","defaultWhenUnspecified","includes","module","exports"],"sources":["../../src/metrics/metricsProcessTypeUtils.js"],"sourcesContent":["/**\n * Helpers for resolving `processType` and silently exiting when a specialized metrics client\n * is constructed on the wrong dyno / process (no log output).\n *\n * **Canonical names** align with typical Procfile processes (e.g. backend: `web`, `worker`,\n * `queue-metrics`, `database-metrics`, `http-metrics`). The compile **worker** dyno serves queues/builds\n * — it does not run HTTP request metrics. HTTP Redis **key segment** for API traffic is fixed **`web`**\n * (`HttpMetricsRedisCollector` / `HttpMetricsRedisRecorder`), not `BUILD_DYNO_PROCESS_TYPE`.\n *\n * @module metrics/metricsProcessTypeUtils\n */\n\n/** DB-only metrics dyno (`database-metrics` in Procfile). */\nconst METRICS_PROCESS_TYPE_DATABASE = 'database-metrics'\n\n/** Queue + Redis metrics dyno (`queue-metrics` in Procfile). */\nconst METRICS_PROCESS_TYPE_QUEUE = 'queue-metrics'\n\n/** Redis-only metrics dyno (no Bee Queue; optional separate process). */\nconst METRICS_PROCESS_TYPE_REDIS = 'redis-metrics'\n\n/** Web servers — HTTP traffic, HTTP Redis **writers** typically use this in Redis key segment. */\nconst METRICS_PROCESS_TYPE_WEB = 'web'\n\n/** Build/compile workers and similar (e.g. backend `worker:`) — no HTTP server metrics here. */\nconst METRICS_PROCESS_TYPE_WORKER = 'worker'\n\n/**\n * Parent {@link RedisMetricsClient} allows either redis-only or queue stack (`QueueRedisMetricsClient`).\n * @type {readonly string[]}\n */\nconst REDIS_METRICS_CLIENT_ALLOWED_PROCESS_TYPES = Object.freeze([\n  METRICS_PROCESS_TYPE_REDIS,\n  METRICS_PROCESS_TYPE_QUEUE,\n])\n\n/**\n * Resolve logical process type the same way specialized metrics clients do.\n *\n * @param {{ processType?: string }} metricsConfig - Remainder of constructor options (e.g. after destructuring `redisClient`, `databaseUrl`, …)\n * @param {string} defaultProcessType - Fallback when `metricsConfig.processType` and `BUILD_DYNO_PROCESS_TYPE` are unset\n * @returns {string}\n */\nfunction resolveMetricsProcessType(metricsConfig, defaultProcessType) {\n  return (\n    metricsConfig.processType ||\n    process.env.BUILD_DYNO_PROCESS_TYPE ||\n    defaultProcessType\n  )\n}\n\n/**\n * Exit with no logs if the resolved process type is not exactly `expectedProcessType`.\n *\n * @param {{ processType?: string }} metricsConfig\n * @param {string} expectedProcessType - Single allowed value (use a module constant, e.g. {@link METRICS_PROCESS_TYPE_DATABASE})\n * @returns {void}\n */\nfunction exitUnlessProcessTypeIs(metricsConfig, expectedProcessType) {\n  const resolved = resolveMetricsProcessType(metricsConfig, expectedProcessType)\n  if (resolved !== expectedProcessType) {\n    process.exit(0)\n  }\n}\n\n/**\n * Exit with no logs if the resolved process type is not in `allowedProcessTypes`.\n *\n * @param {{ processType?: string }} metricsConfig\n * @param {readonly string[]} allowedProcessTypes\n * @param {string} defaultWhenUnspecified - Used only to resolve when config/env omit `processType` (e.g. {@link METRICS_PROCESS_TYPE_QUEUE} for {@link RedisMetricsClient})\n * @returns {void}\n */\nfunction exitUnlessProcessTypeIn(\n  metricsConfig,\n  allowedProcessTypes,\n  defaultWhenUnspecified\n) {\n  const resolved = resolveMetricsProcessType(\n    metricsConfig,\n    defaultWhenUnspecified\n  )\n  if (!allowedProcessTypes.includes(resolved)) {\n    process.exit(0)\n  }\n}\n\nmodule.exports = {\n  resolveMetricsProcessType,\n  exitUnlessProcessTypeIs,\n  exitUnlessProcessTypeIn,\n  METRICS_PROCESS_TYPE_DATABASE,\n  METRICS_PROCESS_TYPE_QUEUE,\n  METRICS_PROCESS_TYPE_REDIS,\n  METRICS_PROCESS_TYPE_WEB,\n  METRICS_PROCESS_TYPE_WORKER,\n  REDIS_METRICS_CLIENT_ALLOWED_PROCESS_TYPES,\n}\n"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMA,6BAA6B,GAAG,kBAAkB;;AAExD;AACA,MAAMC,0BAA0B,GAAG,eAAe;;AAElD;AACA,MAAMC,0BAA0B,GAAG,eAAe;;AAElD;AACA,MAAMC,wBAAwB,GAAG,KAAK;;AAEtC;AACA,MAAMC,2BAA2B,GAAG,QAAQ;;AAE5C;AACA;AACA;AACA;AACA,MAAMC,0CAA0C,GAAGC,MAAM,CAACC,MAAM,CAAC,CAC/DL,0BAA0B,EAC1BD,0BAA0B,CAC3B,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASO,yBAAyBA,CAACC,aAAa,EAAEC,kBAAkB,EAAE;EACpE,OACED,aAAa,CAACE,WAAW,IACzBC,OAAO,CAACC,GAAG,CAACC,uBAAuB,IACnCJ,kBAAkB;AAEtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASK,uBAAuBA,CAACN,aAAa,EAAEO,mBAAmB,EAAE;EACnE,MAAMC,QAAQ,GAAGT,yBAAyB,CAACC,aAAa,EAAEO,mBAAmB,CAAC;EAC9E,IAAIC,QAAQ,KAAKD,mBAAmB,EAAE;IACpCJ,OAAO,CAACM,IAAI,CAAC,CAAC,CAAC;EACjB;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,uBAAuBA,CAC9BV,aAAa,EACbW,mBAAmB,EACnBC,sBAAsB,EACtB;EACA,MAAMJ,QAAQ,GAAGT,yBAAyB,CACxCC,aAAa,EACbY,sBACF,CAAC;EACD,IAAI,CAACD,mBAAmB,CAACE,QAAQ,CAACL,QAAQ,CAAC,EAAE;IAC3CL,OAAO,CAACM,IAAI,CAAC,CAAC,CAAC;EACjB;AACF;AAEAK,MAAM,CAACC,OAAO,GAAG;EACfhB,yBAAyB;EACzBO,uBAAuB;EACvBI,uBAAuB;EACvBnB,6BAA6B;EAC7BC,0BAA0B;EAC1BC,0BAA0B;EAC1BC,wBAAwB;EACxBC,2BAA2B;EAC3BC;AACF,CAAC","ignoreList":[]}

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

@@ -1 +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,mDAAmD;IACnD,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"}
+{"version":3,"file":"metricsQueueRedisClient.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsQueueRedisClient.js"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH;IAkEI,wCAAsD;IACtD,iCAA0C;IAE1C,4DAA4D;IAa5D,0BAA2B;IAE3B,mDAAmD;IACnD,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"}

package/lib/metrics/metricsQueueRedisClient.js

@@ -8,6 +8,10 @@ const {
   REDIS_V3,
   REDIS_V4
 } = require('../redisUtils');
+const {
+  exitUnlessProcessTypeIs,
+  METRICS_PROCESS_TYPE_QUEUE
+} = require('./metricsProcessTypeUtils');
 
 /**
  * QueueRedisMetricsClient extends RedisMetricsClient to collect
@@ -35,6 +39,7 @@ class QueueRedisMetricsClient extends RedisMetricsClient {
     redisClient,
     ...metricsConfig
   } = {}) {
+    exitUnlessProcessTypeIs(metricsConfig, METRICS_PROCESS_TYPE_QUEUE);
     const getConfiguredQueueNames = () => {
       if (!process.env.METRICS_APP_REDIS_BQ) {
         throw new Error('No queues configured for monitoring. Set METRICS_APP_REDIS_BQ with comma-separated queue names');