@adalo/metrics 0.1.162 → 0.1.164

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

@@ -1 +1 @@
-{"version":3,"file":"baseMetricsClient.d.ts","sourceRoot":"","sources":["../../src/metrics/baseMetricsClient.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACE;;;;;;;;;;;;;;OAcG;IACH;QAb2B,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QAChB,aAAa;QACZ,iBAAiB;QAClB,kBAAkB;OA4D7C;IAzDC,gBAA4E;IAC5E,eAAqE;IACrE,oBAG6B;IAC7B,iBAAuE;IACvE,mBAC+D;IAC/D,uBACoE;IACpE,kBAC0E;IAC1E,oBAGI;IACJ,wCAAiD;IACjD,4BAEoD;IACpD,0BAEmD;IACnD,4HAA4H;IAC5H,uBACwE;IACxE,0IAA0I;IAC1I,yBAA6D;IAE7D,0FAA0F;IAC1F,iBADW,OAAO,OAAO,GAAG,IAAI,CACL;IAE3B,mBAAyF;IAEzF,uEAAsC;IAGtC;;;;MAIC;IAGD,aAAmB;IACnB,WAAgB;IAChB,aAAkB;IAClB,sBAA2B;IAE3B,mEAAmE;IACnE;YADkB,MAAM,SAAc,MAAM,GAAG,QAAQ,MAAM,CAAC;MACvC;IAKvB,sCAAwC;IAG1C;;;;;;;;OAQG;IACH;QAN2B,IAAI,EAApB,MAAM;QACU,IAAI,EAApB,MAAM;QACuC,QAAQ,UAAzC,MAAM,GAAC,QAAQ,MAAM,CAAC;QACf,UAAU;UAC3B,OAAO,aAAa,EAAE,KAAK,CAuBvC;IAED;;;;;;;;;;;OAWG;IACH;QAR0B,IAAI,EAAnB,MAAM;QACS,IAAI,EAAnB,MAAM;QACY,UAAU;kBAEhB,MAAM,mBAAmB,MAAM,KAAK,IAAI,CAuB9D;IAED;;OAEG;IACH,6BAKC;IAED;;OAEG;IACH,kCAiCC;IAED,sEAkEC;IA9DK,+CAA0D;IAgEhE;;;OAGG;IACH,qBAQC;IAED,iCAEC;IAED;;;;;;;;;OASG;IACH,iFAEC;IAED;;;;OAIG;IACH,eAFa,QAAQ,IAAI,CAAC,CAWzB;IAED;;;;;;;;;OASG;IACH,yBAEC;IAED;;;OAGG;IACH,qBAFa,QAAQ,IAAI,CAAC,CAkBzB;IAED;;;OAGG;IACH,8BAkDC;IAED;;;;;OAKG;IACH,8CAFa,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;OAGG;IACH,uBAoDC;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;MAEC;IAED,gCAKC;IAID,8BAEC;IAED,gCAEC;IAED,4EAEC;IAED,sCAEC;IAED,2DAWC;CACF"}
+{"version":3,"file":"baseMetricsClient.d.ts","sourceRoot":"","sources":["../../src/metrics/baseMetricsClient.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACE;;;;;;;;;;;;;;OAcG;IACH;QAb2B,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QAChB,aAAa;QACZ,iBAAiB;QAClB,kBAAkB;OA4D7C;IAzDC,gBAA4E;IAC5E,eAAqE;IACrE,oBAG6B;IAC7B,iBAAuE;IACvE,mBAC+D;IAC/D,uBACoE;IACpE,kBAC0E;IAC1E,oBAGI;IACJ,wCAAiD;IACjD,4BAEoD;IACpD,0BAEmD;IACnD,4HAA4H;IAC5H,uBACwE;IACxE,0IAA0I;IAC1I,yBAA6D;IAE7D,0FAA0F;IAC1F,iBADW,OAAO,OAAO,GAAG,IAAI,CACL;IAE3B,mBAAyF;IAEzF,uEAAsC;IAGtC;;;;MAIC;IAGD,aAAmB;IACnB,WAAgB;IAChB,aAAkB;IAClB,sBAA2B;IAE3B,mEAAmE;IACnE;YADkB,MAAM,SAAc,MAAM,GAAG,QAAQ,MAAM,CAAC;MACvC;IAKvB,sCAAwC;IAG1C;;;;;;;;OAQG;IACH;QAN2B,IAAI,EAApB,MAAM;QACU,IAAI,EAApB,MAAM;QACuC,QAAQ,UAAzC,MAAM,GAAC,QAAQ,MAAM,CAAC;QACf,UAAU;UAC3B,OAAO,aAAa,EAAE,KAAK,CAuBvC;IAED;;;;;;;;;;;OAWG;IACH;QAR0B,IAAI,EAAnB,MAAM;QACS,IAAI,EAAnB,MAAM;QACY,UAAU;kBAEhB,MAAM,mBAAmB,MAAM,KAAK,IAAI,CAuB9D;IAED;;OAEG;IACH,6BAKC;IAED;;OAEG;IACH,kCAiCC;IAED,sEA2DC;IAvDK,+CAA0D;IAyDhE;;;OAGG;IACH,qBAQC;IAED,iCAEC;IAED;;;;;;;;;OASG;IACH,iFAEC;IAED;;;;OAIG;IACH,eAFa,QAAQ,IAAI,CAAC,CAWzB;IAED;;;;;;;;;OASG;IACH,yBAEC;IAED;;;OAGG;IACH,qBAFa,QAAQ,IAAI,CAAC,CAkBzB;IAED;;;OAGG;IACH,8BAkDC;IAED;;;;;OAKG;IACH,8CAFa,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;OAGG;IACH,uBAoDC;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;MAEC;IAED,gCAKC;IAID,8BAEC;IAED,gCAEC;IAED,4EAEC;IAED,sCAEC;IAED,2DAWC;CACF"}

package/lib/metrics/baseMetricsClient.js

@@ -208,13 +208,11 @@ class BaseMetricsClient {
       }, interval * 1000);
     }
 
-    // First push: skip when skipFirstPush (e.g. give old instance time to exit), otherwise push immediately
+    // First push: skip when skipFirstPush, otherwise push immediately
     if (!this.skipFirstPush) {
       runPush().catch(err => {
         console.error(`${this.prefixLogs} Failed to push metrics (initial):`, err);
       });
-    } else {
-      console.warn(`${this.prefixLogs} First push skipped (METRICS_SKIP_FIRST_PUSH or skipFirstPush); first push in ${interval}s.`);
     }
     let pushOrigin = 'none';
     try {
@@ -225,7 +223,6 @@ class BaseMetricsClient {
       pushOrigin = 'invalid URL';
     }
     console.warn(`${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s, push: ${pushOrigin})`);
-    console.warn(`${this.prefixLogs} Push interval: process_type=${this.processType} app=${this.appName} dyno_id=${this.dynoId} interval_sec=${this.intervalSec}`);
   };
 
   /**

package/lib/metrics/baseMetricsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"baseMetricsClient.js","names":["client","require","https","http","URL","BaseMetricsClient","constructor","config","appName","process","env","BUILD_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","authToken","pushgatewaySecret","METRICS_PUSHGATEWAY_SECRET","intervalSec","parseInt","METRICS_INTERVAL_SEC","startupValidation","disablePushgateway","METRICS_DISABLE_PUSHGATEWAY","removeOldMetrics","METRICS_REMOVE_OLD_METRICS","skipFirstPush","METRICS_SKIP_FIRST_PUSH","cleanupExitsProcess","_pushIntervalId","prefixLogs","_registry","Registry","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","gateway","gauges","counters","countersFunctions","gaugeUpdaters","_clearOldWorkers","_setCleanupHandlers","keepProcessAliveWhenDisabled","createGauge","name","help","updateFn","labelNames","Object","keys","g","Gauge","registers","createCounter","c","Counter","data","value","inc","clearAllCounters","metricsLogValues","console","log","values","forEach","counter","reset","_pushMetrics","entries","result","val","Promise","undefined","set","err","error","gatewayPush","metrics","getMetricsAsJSON","JSON","stringify","_startPush","interval","customPushMetics","warn","_idleInterval","setInterval","clearInterval","runPush","resolve","pushMetrics","catch","pushOrigin","trim","origin","stopPush","startPush","cleanup","gatewayDelete","exit","_deleteFromVMByLabels","message","esc","s","String","replace","selector","u","reject","Error","path","encodeURIComponent","req","protocol","request","hostname","port","method","headers","Authorization","agent","Agent","keepAlive","res","statusCode","on","chunk","end","params","_pushToVMAgent","pushUrl","pathname","search","contentType","then","setHeader","Buffer","byteLength","withDefaultLabels","labels","getDefaultLabels","metricsEnabled","registry","getMetricsAsString","metricsMiddleware","status","module","exports"],"sources":["../../src/metrics/baseMetricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst https = require('https')\nconst http = require('http')\nconst { URL } = require('url')\n\n/**\n * BaseMetricsClient provides common functionality for all metrics clients.\n * Handles registry setup, push to remote (VM-agent), default labels, and common operations.\n * Always pushes registry to the configured URL (POST Prometheus text format + Basic auth). No Pushgateway.\n */\nclass 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.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 {boolean} [config.skipFirstPush] Skip the first push (first push after interval); set METRICS_SKIP_FIRST_PUSH=true to give old instance time to exit\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    this.appName = config.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.dynoId = config.dynoId || process.env.HOSTNAME || 'unknown-dyno'\n    this.processType =\n      config.processType ||\n      process.env.BUILD_DYNO_PROCESS_TYPE ||\n      'undefined_build_dyno_type'\n    this.enabled = config.enabled ?? process.env.METRICS_ENABLED === 'true'\n    this.logValues =\n      config.logValues ?? process.env.METRICS_LOG_VALUES === 'true'\n    this.pushgatewayUrl =\n      config.pushgatewayUrl || process.env.METRICS_PUSHGATEWAY_URL || ''\n    this.authToken =\n      config.pushgatewaySecret || process.env.METRICS_PUSHGATEWAY_SECRET || ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\n    this.startupValidation = config.startupValidation\n    this.disablePushgateway =\n      config.disablePushgateway ??\n      process.env.METRICS_DISABLE_PUSHGATEWAY === 'true'\n    this.removeOldMetrics =\n      config.removeOldMetrics ??\n      process.env.METRICS_REMOVE_OLD_METRICS === 'true'\n    /** When true, skip the immediate first push; first push runs after the first interval. Set METRICS_SKIP_FIRST_PUSH=true. */\n    this.skipFirstPush =\n      config.skipFirstPush ?? process.env.METRICS_SKIP_FIRST_PUSH === 'true'\n    /** If true (default), cleanup() calls process.exit(0). Set to false when the app handles SIGTERM itself (e.g. graceful HTTP shutdown). */\n    this.cleanupExitsProcess = config.cleanupExitsProcess ?? true\n\n    /** @type {NodeJS.Timeout | null} Push interval handle so it can be cleared on shutdown */\n    this._pushIntervalId = null\n\n    this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`\n\n    this._registry = new client.Registry()\n    client.collectDefaultMetrics({ register: this._registry })\n\n    this.defaultLabels = {\n      app: this.appName,\n      dyno_id: this.dynoId,\n      process_type: this.processType,\n    }\n\n    // Always push to configured URL (VM-agent). No Pushgateway.\n    this.gateway = null\n    this.gauges = {}\n    this.counters = {}\n    this.countersFunctions = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n\n    this._clearOldWorkers(config.removeOldMetrics)\n    this._setCleanupHandlers()\n\n    this.keepProcessAliveWhenDisabled = true\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {Object} options - Gauge configuration\n   * @param {string} options.name - Name of the gauge\n   * @param {string} options.help - Help text describing the gauge\n   * @param {function(): number|Promise<number>} [options.updateFn] - Optional function returning the gauge value\n   * @param {string[]} [options.labelNames] - Optional custom label names\n   * @returns {import('prom-client').Gauge} The created Prometheus gauge\n   */\n  createGauge = ({\n    name,\n    help,\n    updateFn,\n    labelNames = Object.keys(this.defaultLabels),\n  }) => {\n    if (this.gauges[name]) return this.gauges[name]\n\n    const g = new client.Gauge({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.gauges[name] = g\n\n    if (updateFn && typeof updateFn === 'function') {\n      this.gaugeUpdaters[name] = updateFn\n    }\n\n    return g\n  }\n\n  /**\n   * Create a Prometheus Counter metric.\n   *\n   * @param {Object} params - Counter configuration\n   * @param {string} params.name - Metric name\n   * @param {string} params.help - Metric description\n   * @param {string[]} [params.labelNames] - Optional list of label names. Defaults to this.defaultLabels keys.\n   *\n   * @returns {(labels?: Object, incrementValue?: number) => void}\n   *          A function to increment the counter.\n   *          Usage: (labels?, incrementValue?)\n   */\n  createCounter({ name, help, labelNames = Object.keys(this.defaultLabels) }) {\n    if (this.counters[name]) return this.countersFunctions[name]\n\n    const c = new client.Counter({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.counters[name] = c\n\n    this.countersFunctions = {\n      ...this.countersFunctions,\n      [name]: (data = {}, value = 1) => {\n        c.inc({ ...this.defaultLabels, ...data }, value)\n      },\n    }\n\n    return this.countersFunctions[name]\n  }\n\n  /**\n   * Clear all collected counters\n   */\n  clearAllCounters = () => {\n    if (this.metricsLogValues) {\n      console.log('Counters to clear: ', Object.keys(this.counters))\n    }\n    Object.values(this.counters).forEach(counter => counter.reset())\n  }\n\n  /**\n   * Push all gauges and counters to PushGateway and optionally log.\n   */\n  _pushMetrics = async () => {\n    try {\n      for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {\n        try {\n          if (!updateFn) {\n            continue\n          }\n          const result = updateFn()\n          const val = result instanceof Promise ? await result : result\n          if (val !== undefined) this.gauges[name].set(this.defaultLabels, val)\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to update gauge ${name}:`,\n            err\n          )\n        }\n      }\n\n      if (!this.disablePushgateway) {\n        await this.gatewayPush()\n      }\n      // this.clearAllCounters() //TODO: or uncommit or delete (based on grafana expectation)\n\n      if (this.logValues) {\n        const metrics = await this._registry.getMetricsAsJSON()\n        console.log(\n          `${this.prefixLogs} Metrics:\\n`,\n          JSON.stringify(metrics, null, 2)\n        )\n      }\n    } catch (err) {\n      console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n    }\n  }\n\n  _startPush = (interval = this.intervalSec, customPushMetics = undefined) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n      if (this.keepProcessAliveWhenDisabled && !this._idleInterval) {\n        this._idleInterval = setInterval(() => {}, 60 * 60 * 1000)\n      }\n      return\n    }\n\n    if (this._idleInterval) {\n      clearInterval(this._idleInterval)\n      this._idleInterval = null\n    }\n\n    if (this.startupValidation && !this.startupValidation()) {\n      return\n    }\n\n    const runPush = () => {\n      if (customPushMetics && typeof customPushMetics === 'function') {\n        return Promise.resolve(customPushMetics())\n      }\n      return this.pushMetrics()\n    }\n\n    if (customPushMetics && typeof customPushMetics === 'function') {\n      this._pushIntervalId = setInterval(\n        () => customPushMetics(),\n        interval * 1000\n      )\n    } else {\n      this._pushIntervalId = setInterval(() => {\n        runPush().catch(err => {\n          console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n        })\n      }, interval * 1000)\n    }\n\n    // First push: skip when skipFirstPush (e.g. give old instance time to exit), otherwise push immediately\n    if (!this.skipFirstPush) {\n      runPush().catch(err => {\n        console.error(\n          `${this.prefixLogs} Failed to push metrics (initial):`,\n          err\n        )\n      })\n    } else {\n      console.warn(\n        `${this.prefixLogs} First push skipped (METRICS_SKIP_FIRST_PUSH or skipFirstPush); first push in ${interval}s.`\n      )\n    }\n\n    let pushOrigin = 'none'\n    try {\n      if (this.pushgatewayUrl && this.pushgatewayUrl.trim()) {\n        pushOrigin = new URL(this.pushgatewayUrl.trim()).origin\n      }\n    } catch {\n      pushOrigin = 'invalid URL'\n    }\n    console.warn(\n      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s, push: ${pushOrigin})`\n    )\n    console.warn(\n      `${this.prefixLogs} Push interval: process_type=${this.processType} app=${this.appName} dyno_id=${this.dynoId} interval_sec=${this.intervalSec}`\n    )\n  }\n\n  /**\n   * Stop periodic metrics push (clears the interval).\n   * Call this before process exit to avoid pushing during shutdown and to reduce connection overlap on redeploy.\n   */\n  stopPush = () => {\n    if (this._pushIntervalId) {\n      clearInterval(this._pushIntervalId)\n      this._pushIntervalId = null\n      console.warn(\n        `${this.prefixLogs} Metrics collection stopped (push interval cleared).`\n      )\n    }\n  }\n\n  pushMetrics = async () => {\n    return this._pushMetrics()\n  }\n\n  /**\n   * Start periodic metrics collection and push.\n   *\n   * This method wraps the internal `_startPush` method.\n   * If a `customPushMetrics` function is provided, it will be executed\n   * at the given interval instead of the default `pushMetrics` behavior.\n   *\n   * @param {number} [interval=this.intervalSec] - Interval in seconds between pushes.\n   * @param {() => void | Promise<void>} [customPushMetrics] - Optional custom push function. If provided, Prometheus push is skipped.\n   */\n  startPush = (interval, customPushMetics = undefined) => {\n    this._startPush(interval, customPushMetics)\n  }\n\n  /**\n   * Cleanup metrics and optionally exit process.\n   * Stops the push interval immediately (to avoid overlap on redeploy), then deletes this instance's metrics from the gateway, then exits if cleanupExitsProcess is true.\n   * @returns {Promise<void>}\n   */\n  cleanup = async () => {\n    console.warn(`${this.prefixLogs} Metrics cleanup started (shutdown).`)\n    this.stopPush()\n    if (this.enabled) {\n      await this.gatewayDelete()\n    }\n    if (this.cleanupExitsProcess !== false) {\n      process.exit(0)\n    }\n  }\n\n  /**\n   * Remove old/stale dyno/instance metrics from PushGateway.\n   *\n   * Compares existing PushGateway metrics for this job and deletes any instances\n   * that do not match the current dynoId.\n   *\n   * @param {boolean} removeOldMetrics If true, performs cleanup; otherwise does nothing\n   * @returns {Promise<void>}\n   * @private\n   */\n  _clearOldWorkers = async removeOldMetrics => {\n    // No Pushgateway; VM-agent does not support per-instance delete. Skip.\n  }\n\n  /**\n   * On shutdown: optionally delete this instance's metrics from VictoriaMetrics (by app, dyno_id, process_type).\n   * @returns {Promise<void>}\n   */\n  gatewayDelete = async () => {\n    if (\n      this.removeOldMetrics &&\n      this.pushgatewayUrl &&\n      this.pushgatewayUrl.trim()\n    ) {\n      console.warn(\n        `${this.prefixLogs} Deleting this instance's metrics from VM (app=${this.appName}, dyno_id=${this.dynoId}, process_type=${this.processType}).`\n      )\n      await this._deleteFromVMByLabels().catch(err => {\n        console.warn(\n          `${this.prefixLogs} Deletion from VM on shutdown failed:`,\n          err.message\n        )\n      })\n    }\n  }\n\n  /**\n   * Call VictoriaMetrics delete_series API to remove all series matching this instance's labels (app, dyno_id, process_type).\n   * @private\n   */\n  _deleteFromVMByLabels = () => {\n    const esc = s => String(s).replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')\n    const selector = `{app=\"${esc(this.appName)}\",dyno_id=\"${esc(\n      this.dynoId\n    )}\",process_type=\"${esc(this.processType)}\"}`\n    let origin\n    try {\n      const u = new URL((this.pushgatewayUrl || '').trim())\n      origin = u.origin\n    } catch {\n      return Promise.reject(new Error('Invalid push URL'))\n    }\n    const path = `/api/v1/admin/tsdb/delete_series?match[]=${encodeURIComponent(\n      selector\n    )}`\n    return new Promise((resolve, reject) => {\n      const u = new URL(origin)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path,\n          method: 'POST',\n          headers: {\n            'Content-Length': '0',\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: false })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) resolve()\n          else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Delete failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      req.end()\n    })\n  }\n\n  /**\n   * Push registry to configured URL (VM-agent). POST Prometheus text format + Basic auth.\n   *\n   * @param {object} [params] Unused; kept for API compatibility.\n   * @returns {Promise<void>}\n   */\n  gatewayPush = async (params = {}) => {\n    if (this.disablePushgateway) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_DISABLE_PUSHGATEWAY is set`\n      )\n      return Promise.resolve()\n    }\n    if (!this.pushgatewayUrl || !this.pushgatewayUrl.trim()) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_PUSHGATEWAY_URL is not set`\n      )\n      return Promise.resolve()\n    }\n    return this._pushToVMAgent()\n  }\n\n  /**\n   * POST registry (Prometheus text format) to VM-agent. VM-agent accepts push at /api/v1/import/prometheus; /metrics is GET (scrape) only.\n   * @private\n   */\n  _pushToVMAgent = () => {\n    let pushUrl = (this.pushgatewayUrl || '').trim()\n    try {\n      const u = new URL(pushUrl)\n      if (!u.pathname || u.pathname === '/' || u.pathname === '/metrics') {\n        pushUrl = `${u.origin}/api/v1/import/prometheus${u.search}`\n      }\n    } catch {\n      // leave pushUrl as-is\n    }\n    return new Promise((resolve, reject) => {\n      const u = new URL(pushUrl)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path: u.pathname + u.search,\n          method: 'POST',\n          headers: {\n            'Content-Type': client.register.contentType,\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: true })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) {\n            resolve()\n          } else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Push failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      this._registry\n        .metrics()\n        .then(metrics => {\n          req.setHeader('Content-Length', Buffer.byteLength(metrics, 'utf8'))\n          req.end(metrics, 'utf8')\n        })\n        .catch(reject)\n    })\n  }\n\n  /**\n   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)\n   * with custom label names.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabels = (labels = []) => {\n    return [...Object.keys(this.defaultLabels), ...labels]\n  }\n\n  getDefaultLabels = (labels = []) => {\n    return this.defaultLabels\n  }\n\n  _setCleanupHandlers = () => {\n    if (this.cleanupExitsProcess) {\n      process.on('SIGINT', this.cleanup)\n      process.on('SIGTERM', this.cleanup)\n    }\n  }\n\n  // GETTERS\n\n  get metricsEnabled() {\n    return this.enabled\n  }\n\n  get metricsLogValues() {\n    return this.logValues\n  }\n\n  get registry() {\n    return this._registry\n  }\n\n  async getMetricsAsString() {\n    return this._registry.metrics()\n  }\n\n  metricsMiddleware() {\n    return async (req, res) => {\n      try {\n        const metrics = await this.getMetricsAsString()\n        res.set('Content-Type', client.register.contentType)\n        res.end(metrics)\n      } catch (err) {\n        console.error(`${this.prefixLogs} Failed to get metrics:`, err)\n        res.status(500).end('Failed to collect metrics')\n      }\n    }\n  }\n}\n\nmodule.exports = { BaseMetricsClient }\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"baseMetricsClient.js","names":["client","require","https","http","URL","BaseMetricsClient","constructor","config","appName","process","env","BUILD_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","authToken","pushgatewaySecret","METRICS_PUSHGATEWAY_SECRET","intervalSec","parseInt","METRICS_INTERVAL_SEC","startupValidation","disablePushgateway","METRICS_DISABLE_PUSHGATEWAY","removeOldMetrics","METRICS_REMOVE_OLD_METRICS","skipFirstPush","METRICS_SKIP_FIRST_PUSH","cleanupExitsProcess","_pushIntervalId","prefixLogs","_registry","Registry","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","gateway","gauges","counters","countersFunctions","gaugeUpdaters","_clearOldWorkers","_setCleanupHandlers","keepProcessAliveWhenDisabled","createGauge","name","help","updateFn","labelNames","Object","keys","g","Gauge","registers","createCounter","c","Counter","data","value","inc","clearAllCounters","metricsLogValues","console","log","values","forEach","counter","reset","_pushMetrics","entries","result","val","Promise","undefined","set","err","error","gatewayPush","metrics","getMetricsAsJSON","JSON","stringify","_startPush","interval","customPushMetics","warn","_idleInterval","setInterval","clearInterval","runPush","resolve","pushMetrics","catch","pushOrigin","trim","origin","stopPush","startPush","cleanup","gatewayDelete","exit","_deleteFromVMByLabels","message","esc","s","String","replace","selector","u","reject","Error","path","encodeURIComponent","req","protocol","request","hostname","port","method","headers","Authorization","agent","Agent","keepAlive","res","statusCode","on","chunk","end","params","_pushToVMAgent","pushUrl","pathname","search","contentType","then","setHeader","Buffer","byteLength","withDefaultLabels","labels","getDefaultLabels","metricsEnabled","registry","getMetricsAsString","metricsMiddleware","status","module","exports"],"sources":["../../src/metrics/baseMetricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst https = require('https')\nconst http = require('http')\nconst { URL } = require('url')\n\n/**\n * BaseMetricsClient provides common functionality for all metrics clients.\n * Handles registry setup, push to remote (VM-agent), default labels, and common operations.\n * Always pushes registry to the configured URL (POST Prometheus text format + Basic auth). No Pushgateway.\n */\nclass 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.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 {boolean} [config.skipFirstPush] Skip the first push (first push after interval); set METRICS_SKIP_FIRST_PUSH=true to give old instance time to exit\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    this.appName = config.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.dynoId = config.dynoId || process.env.HOSTNAME || 'unknown-dyno'\n    this.processType =\n      config.processType ||\n      process.env.BUILD_DYNO_PROCESS_TYPE ||\n      'undefined_build_dyno_type'\n    this.enabled = config.enabled ?? process.env.METRICS_ENABLED === 'true'\n    this.logValues =\n      config.logValues ?? process.env.METRICS_LOG_VALUES === 'true'\n    this.pushgatewayUrl =\n      config.pushgatewayUrl || process.env.METRICS_PUSHGATEWAY_URL || ''\n    this.authToken =\n      config.pushgatewaySecret || process.env.METRICS_PUSHGATEWAY_SECRET || ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\n    this.startupValidation = config.startupValidation\n    this.disablePushgateway =\n      config.disablePushgateway ??\n      process.env.METRICS_DISABLE_PUSHGATEWAY === 'true'\n    this.removeOldMetrics =\n      config.removeOldMetrics ??\n      process.env.METRICS_REMOVE_OLD_METRICS === 'true'\n    /** When true, skip the immediate first push; first push runs after the first interval. Set METRICS_SKIP_FIRST_PUSH=true. */\n    this.skipFirstPush =\n      config.skipFirstPush ?? process.env.METRICS_SKIP_FIRST_PUSH === 'true'\n    /** If true (default), cleanup() calls process.exit(0). Set to false when the app handles SIGTERM itself (e.g. graceful HTTP shutdown). */\n    this.cleanupExitsProcess = config.cleanupExitsProcess ?? true\n\n    /** @type {NodeJS.Timeout | null} Push interval handle so it can be cleared on shutdown */\n    this._pushIntervalId = null\n\n    this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`\n\n    this._registry = new client.Registry()\n    client.collectDefaultMetrics({ register: this._registry })\n\n    this.defaultLabels = {\n      app: this.appName,\n      dyno_id: this.dynoId,\n      process_type: this.processType,\n    }\n\n    // Always push to configured URL (VM-agent). No Pushgateway.\n    this.gateway = null\n    this.gauges = {}\n    this.counters = {}\n    this.countersFunctions = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n\n    this._clearOldWorkers(config.removeOldMetrics)\n    this._setCleanupHandlers()\n\n    this.keepProcessAliveWhenDisabled = true\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {Object} options - Gauge configuration\n   * @param {string} options.name - Name of the gauge\n   * @param {string} options.help - Help text describing the gauge\n   * @param {function(): number|Promise<number>} [options.updateFn] - Optional function returning the gauge value\n   * @param {string[]} [options.labelNames] - Optional custom label names\n   * @returns {import('prom-client').Gauge} The created Prometheus gauge\n   */\n  createGauge = ({\n    name,\n    help,\n    updateFn,\n    labelNames = Object.keys(this.defaultLabels),\n  }) => {\n    if (this.gauges[name]) return this.gauges[name]\n\n    const g = new client.Gauge({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.gauges[name] = g\n\n    if (updateFn && typeof updateFn === 'function') {\n      this.gaugeUpdaters[name] = updateFn\n    }\n\n    return g\n  }\n\n  /**\n   * Create a Prometheus Counter metric.\n   *\n   * @param {Object} params - Counter configuration\n   * @param {string} params.name - Metric name\n   * @param {string} params.help - Metric description\n   * @param {string[]} [params.labelNames] - Optional list of label names. Defaults to this.defaultLabels keys.\n   *\n   * @returns {(labels?: Object, incrementValue?: number) => void}\n   *          A function to increment the counter.\n   *          Usage: (labels?, incrementValue?)\n   */\n  createCounter({ name, help, labelNames = Object.keys(this.defaultLabels) }) {\n    if (this.counters[name]) return this.countersFunctions[name]\n\n    const c = new client.Counter({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.counters[name] = c\n\n    this.countersFunctions = {\n      ...this.countersFunctions,\n      [name]: (data = {}, value = 1) => {\n        c.inc({ ...this.defaultLabels, ...data }, value)\n      },\n    }\n\n    return this.countersFunctions[name]\n  }\n\n  /**\n   * Clear all collected counters\n   */\n  clearAllCounters = () => {\n    if (this.metricsLogValues) {\n      console.log('Counters to clear: ', Object.keys(this.counters))\n    }\n    Object.values(this.counters).forEach(counter => counter.reset())\n  }\n\n  /**\n   * Push all gauges and counters to PushGateway and optionally log.\n   */\n  _pushMetrics = async () => {\n    try {\n      for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {\n        try {\n          if (!updateFn) {\n            continue\n          }\n          const result = updateFn()\n          const val = result instanceof Promise ? await result : result\n          if (val !== undefined) this.gauges[name].set(this.defaultLabels, val)\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to update gauge ${name}:`,\n            err\n          )\n        }\n      }\n\n      if (!this.disablePushgateway) {\n        await this.gatewayPush()\n      }\n      // this.clearAllCounters() //TODO: or uncommit or delete (based on grafana expectation)\n\n      if (this.logValues) {\n        const metrics = await this._registry.getMetricsAsJSON()\n        console.log(\n          `${this.prefixLogs} Metrics:\\n`,\n          JSON.stringify(metrics, null, 2)\n        )\n      }\n    } catch (err) {\n      console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n    }\n  }\n\n  _startPush = (interval = this.intervalSec, customPushMetics = undefined) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n      if (this.keepProcessAliveWhenDisabled && !this._idleInterval) {\n        this._idleInterval = setInterval(() => {}, 60 * 60 * 1000)\n      }\n      return\n    }\n\n    if (this._idleInterval) {\n      clearInterval(this._idleInterval)\n      this._idleInterval = null\n    }\n\n    if (this.startupValidation && !this.startupValidation()) {\n      return\n    }\n\n    const runPush = () => {\n      if (customPushMetics && typeof customPushMetics === 'function') {\n        return Promise.resolve(customPushMetics())\n      }\n      return this.pushMetrics()\n    }\n\n    if (customPushMetics && typeof customPushMetics === 'function') {\n      this._pushIntervalId = setInterval(\n        () => customPushMetics(),\n        interval * 1000\n      )\n    } else {\n      this._pushIntervalId = setInterval(() => {\n        runPush().catch(err => {\n          console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n        })\n      }, interval * 1000)\n    }\n\n    // First push: skip when skipFirstPush, otherwise push immediately\n    if (!this.skipFirstPush) {\n      runPush().catch(err => {\n        console.error(\n          `${this.prefixLogs} Failed to push metrics (initial):`,\n          err\n        )\n      })\n    }\n\n    let pushOrigin = 'none'\n    try {\n      if (this.pushgatewayUrl && this.pushgatewayUrl.trim()) {\n        pushOrigin = new URL(this.pushgatewayUrl.trim()).origin\n      }\n    } catch {\n      pushOrigin = 'invalid URL'\n    }\n    console.warn(\n      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s, push: ${pushOrigin})`\n    )\n  }\n\n  /**\n   * Stop periodic metrics push (clears the interval).\n   * Call this before process exit to avoid pushing during shutdown and to reduce connection overlap on redeploy.\n   */\n  stopPush = () => {\n    if (this._pushIntervalId) {\n      clearInterval(this._pushIntervalId)\n      this._pushIntervalId = null\n      console.warn(\n        `${this.prefixLogs} Metrics collection stopped (push interval cleared).`\n      )\n    }\n  }\n\n  pushMetrics = async () => {\n    return this._pushMetrics()\n  }\n\n  /**\n   * Start periodic metrics collection and push.\n   *\n   * This method wraps the internal `_startPush` method.\n   * If a `customPushMetrics` function is provided, it will be executed\n   * at the given interval instead of the default `pushMetrics` behavior.\n   *\n   * @param {number} [interval=this.intervalSec] - Interval in seconds between pushes.\n   * @param {() => void | Promise<void>} [customPushMetrics] - Optional custom push function. If provided, Prometheus push is skipped.\n   */\n  startPush = (interval, customPushMetics = undefined) => {\n    this._startPush(interval, customPushMetics)\n  }\n\n  /**\n   * Cleanup metrics and optionally exit process.\n   * Stops the push interval immediately (to avoid overlap on redeploy), then deletes this instance's metrics from the gateway, then exits if cleanupExitsProcess is true.\n   * @returns {Promise<void>}\n   */\n  cleanup = async () => {\n    console.warn(`${this.prefixLogs} Metrics cleanup started (shutdown).`)\n    this.stopPush()\n    if (this.enabled) {\n      await this.gatewayDelete()\n    }\n    if (this.cleanupExitsProcess !== false) {\n      process.exit(0)\n    }\n  }\n\n  /**\n   * Remove old/stale dyno/instance metrics from PushGateway.\n   *\n   * Compares existing PushGateway metrics for this job and deletes any instances\n   * that do not match the current dynoId.\n   *\n   * @param {boolean} removeOldMetrics If true, performs cleanup; otherwise does nothing\n   * @returns {Promise<void>}\n   * @private\n   */\n  _clearOldWorkers = async removeOldMetrics => {\n    // No Pushgateway; VM-agent does not support per-instance delete. Skip.\n  }\n\n  /**\n   * On shutdown: optionally delete this instance's metrics from VictoriaMetrics (by app, dyno_id, process_type).\n   * @returns {Promise<void>}\n   */\n  gatewayDelete = async () => {\n    if (\n      this.removeOldMetrics &&\n      this.pushgatewayUrl &&\n      this.pushgatewayUrl.trim()\n    ) {\n      console.warn(\n        `${this.prefixLogs} Deleting this instance's metrics from VM (app=${this.appName}, dyno_id=${this.dynoId}, process_type=${this.processType}).`\n      )\n      await this._deleteFromVMByLabels().catch(err => {\n        console.warn(\n          `${this.prefixLogs} Deletion from VM on shutdown failed:`,\n          err.message\n        )\n      })\n    }\n  }\n\n  /**\n   * Call VictoriaMetrics delete_series API to remove all series matching this instance's labels (app, dyno_id, process_type).\n   * @private\n   */\n  _deleteFromVMByLabels = () => {\n    const esc = s => String(s).replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')\n    const selector = `{app=\"${esc(this.appName)}\",dyno_id=\"${esc(\n      this.dynoId\n    )}\",process_type=\"${esc(this.processType)}\"}`\n    let origin\n    try {\n      const u = new URL((this.pushgatewayUrl || '').trim())\n      origin = u.origin\n    } catch {\n      return Promise.reject(new Error('Invalid push URL'))\n    }\n    const path = `/api/v1/admin/tsdb/delete_series?match[]=${encodeURIComponent(\n      selector\n    )}`\n    return new Promise((resolve, reject) => {\n      const u = new URL(origin)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path,\n          method: 'POST',\n          headers: {\n            'Content-Length': '0',\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: false })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) resolve()\n          else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Delete failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      req.end()\n    })\n  }\n\n  /**\n   * Push registry to configured URL (VM-agent). POST Prometheus text format + Basic auth.\n   *\n   * @param {object} [params] Unused; kept for API compatibility.\n   * @returns {Promise<void>}\n   */\n  gatewayPush = async (params = {}) => {\n    if (this.disablePushgateway) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_DISABLE_PUSHGATEWAY is set`\n      )\n      return Promise.resolve()\n    }\n    if (!this.pushgatewayUrl || !this.pushgatewayUrl.trim()) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_PUSHGATEWAY_URL is not set`\n      )\n      return Promise.resolve()\n    }\n    return this._pushToVMAgent()\n  }\n\n  /**\n   * POST registry (Prometheus text format) to VM-agent. VM-agent accepts push at /api/v1/import/prometheus; /metrics is GET (scrape) only.\n   * @private\n   */\n  _pushToVMAgent = () => {\n    let pushUrl = (this.pushgatewayUrl || '').trim()\n    try {\n      const u = new URL(pushUrl)\n      if (!u.pathname || u.pathname === '/' || u.pathname === '/metrics') {\n        pushUrl = `${u.origin}/api/v1/import/prometheus${u.search}`\n      }\n    } catch {\n      // leave pushUrl as-is\n    }\n    return new Promise((resolve, reject) => {\n      const u = new URL(pushUrl)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path: u.pathname + u.search,\n          method: 'POST',\n          headers: {\n            'Content-Type': client.register.contentType,\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: true })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) {\n            resolve()\n          } else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Push failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      this._registry\n        .metrics()\n        .then(metrics => {\n          req.setHeader('Content-Length', Buffer.byteLength(metrics, 'utf8'))\n          req.end(metrics, 'utf8')\n        })\n        .catch(reject)\n    })\n  }\n\n  /**\n   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)\n   * with custom label names.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabels = (labels = []) => {\n    return [...Object.keys(this.defaultLabels), ...labels]\n  }\n\n  getDefaultLabels = (labels = []) => {\n    return this.defaultLabels\n  }\n\n  _setCleanupHandlers = () => {\n    if (this.cleanupExitsProcess) {\n      process.on('SIGINT', this.cleanup)\n      process.on('SIGTERM', this.cleanup)\n    }\n  }\n\n  // GETTERS\n\n  get metricsEnabled() {\n    return this.enabled\n  }\n\n  get metricsLogValues() {\n    return this.logValues\n  }\n\n  get registry() {\n    return this._registry\n  }\n\n  async getMetricsAsString() {\n    return this._registry.metrics()\n  }\n\n  metricsMiddleware() {\n    return async (req, res) => {\n      try {\n        const metrics = await this.getMetricsAsString()\n        res.set('Content-Type', client.register.contentType)\n        res.end(metrics)\n      } catch (err) {\n        console.error(`${this.prefixLogs} Failed to get metrics:`, err)\n        res.status(500).end('Failed to collect metrics')\n      }\n    }\n  }\n}\n\nmodule.exports = { BaseMetricsClient }\n"],"mappings":"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","ignoreList":[]}

package/lib/metrics/metricsRedisClient.d.ts

@@ -21,7 +21,7 @@ export class RedisMetricsClient extends BaseMetricsClient {
      * @param {function} [options.startupValidation] - Function to validate startup (from BaseMetricsClient)
      * @param {boolean} [options.disablePushgateway] - Disable pushing to Pushgateway (use HTTP scraping instead)
      */
-    constructor({ redisClient, gracefulShutdownRedis, ...metricsConfig }?: {
+    constructor({ redisClient, ...metricsConfig }?: {
         redisClient: any;
         gracefulShutdownRedis?: boolean | undefined;
         appName?: string | undefined;
@@ -39,12 +39,8 @@ export class RedisMetricsClient extends BaseMetricsClient {
     /** Redis client used for metrics */
     redisClient: any;
     redisClientType: string;
-    _gracefulShutdownRedis: boolean;
-    _gracefulShutdownChannel: string | null;
     /** Dedicated Redis connection for subscribe (subscriber mode); closed in cleanup. */
     _subClient: any;
-    /** Log prefix for graceful-shutdown messages (always logged, not behind METRICS_LOG_VALUES). */
-    _gracefulShutdownLogPrefix: string;
     /** Counter for Redis client connections */
     redisConnectionsGauge: import("prom-client").Gauge<string>;
     redisConnectionsMemoryGauge: import("prom-client").Gauge<string>;
@@ -55,11 +51,36 @@ export class RedisMetricsClient extends BaseMetricsClient {
     _redisConnSeenKeys: Set<any>;
     _redisConnZeroedKeys: Set<any>;
     /**
-     * Set up Redis subscribe for graceful shutdown. Uses one connection: either redisClient.duplicate() (ioredis) or a client created from REDIS_URL (node-redis). Caller passes only redisClient.
+     * Initialize graceful-shutdown state and subscribe when enabled. Called from constructor.
+     * @param {boolean} [gracefulShutdownRedis] - Explicit false to disable; otherwise enabled unless METRICS_GRACEFUL_SHUTDOWN_REDIS=false.
+     */
+    _initGracefulShutdown(gracefulShutdownRedis?: boolean | undefined): void;
+    _gracefulShutdownRedis: boolean | undefined;
+    _gracefulShutdownStream: string | null | undefined;
+    _gracefulShutdownAckChannel: string | null | undefined;
+    _gracefulShutdownLogPrefix: string | undefined;
+    /**
+     * Create a dedicated Redis client for subscribe (pub/sub). Uses duplicate() when available, else createClient from REDIS_URL. Branches by redisClientType (IOREDIS, REDIS_V3, REDIS_V4).
+     * @returns {any|null} Subscriber client or null if not possible.
+     */
+    _createSubscriberClient(): any | null;
+    /**
+     * Set up Redis subscribe for graceful shutdown. Uses _createSubscriberClient() so subscriber matches client type (ioredis vs node-redis v3/v4).
+     */
+    /**
+     * Set up Redis stream read for graceful shutdown. Uses _createSubscriberClient() and XREAD BLOCK; stream is trimmed (MAXLEN and MINID) so messages are not kept in Redis forever.
      */
     _setupGracefulShutdownSubscribe(): void;
+    _streamReadLoop(streamKey: any): void;
+    _xreadBlock(streamKey: any, blockMs: any): Promise<any>;
+    _parseXreadReply(reply: any, streamKey: any): any[][];
+    /**
+     * Old instance: stop push, clear metrics from VM, then publish ack so new can start; then exit.
+     */
+    _cleanupAndPublishAck(): Promise<void>;
+    _publishAck(): any;
     /**
-     * Publish one-time "new instance started" so old instances (subscribed to the same channel) exit. Call from new instance after startPush.
+     * Publish "new instance started" to stream so old instances exit. Stream is trimmed (MAXLEN ~ 10 and MINID older than 1 min) so messages are not kept in Redis forever.
      */
     _publishNewInstanceStarted(): void;
     getRedisConnections: () => Promise<any>;
@@ -76,10 +97,9 @@ export class RedisMetricsClient extends BaseMetricsClient {
      */
     pushRedisMetrics: () => Promise<void>;
     /**
-     * Start periodic collection.
-     * @param {number} [intervalSec=this.intervalSec] - Interval in seconds
+     * Start periodic collection. When graceful shutdown is on: new publishes "new started" so old exits and clears; new does not push until after one interval (skipFirstPush), giving old time to stop.
      */
-    startPush: (intervalSec?: number | undefined) => void;
+    startPush: (intervalSec?: number) => void;
 }
 import { BaseMetricsClient } from "./baseMetricsClient";
 //# sourceMappingURL=metricsRedisClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"metricsRedisClient.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsRedisClient.js"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH;IACE;;;;;;;;;;;;;;;OAeG;IACH;QAdwB,WAAW,EAAxB,GAAG;QACe,qBAAqB;QACtB,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QACf,iBAAiB;QAClB,kBAAkB;OAgF9C;IAjEC,oCAAoC;IACpC,iBAA8B;IAC9B,wBAAsD;IAMtD,gCAAgE;IAChE,wCAEQ;IACR,qFAAqF;IACrF,gBAAsB;IAEtB,gGAAgG;IAChG,mCAAgH;IAYhH,2CAA2C;IAC3C,2DAIE;IAEF,iEAIE;IAEF,mCAAmC;IACnC,sDAIE;IAEF,sCAAsC;IACtC,qDAIE;IAQF,6BAAmC;IACnC,+BAAqC;IAKvC;;OAEG;IACH,wCA0FC;IAED;;OAEG;IACH,mCAqCC;IAED,wCAgCC;IAED,6CAuBC;IAED,gDAkBC;IAED;;;OAGG;IACH,2BAFa,QAAQ,IAAI,CAAC,CA6KzB;IAED;;;OAGG;IACH,wBAFa,QAAQ,IAAI,CAAC,CAqBzB;IAED;;;OAGG;IACH,sDASC;CAmDF"}
+{"version":3,"file":"metricsRedisClient.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsRedisClient.js"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH;IACE;;;;;;;;;;;;;;;OAeG;IACH;QAdwB,WAAW,EAAxB,GAAG;QACe,qBAAqB;QACtB,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QACf,iBAAiB;QAClB,kBAAkB;OAgE9C;IA9CC,oCAAoC;IACpC,iBAA8B;IAC9B,wBAAsD;IAEtD,qFAAqF;IACrF,gBAAsB;IAItB,2CAA2C;IAC3C,2DAIE;IAEF,iEAIE;IAEF,mCAAmC;IACnC,sDAIE;IAEF,sCAAsC;IACtC,qDAIE;IAQF,6BAAmC;IACnC,+BAAqC;IAKvC;;;OAGG;IACH,yEAeC;IAXC,4CAAgE;IAChE,mDAEQ;IACR,uDAEQ;IACR,+CAAgH;IAMlH;;;OAGG;IACH,2BAFa,GAAG,GAAC,IAAI,CAuBpB;IAED;;OAEG;IACH;;OAEG;IACH,wCAaC;IAED,sCAmBC;IAED,wDAqBC;IAED,sDAKC;IAED;;OAEG;IACH,uCAoCC;IAED,mBAmBC;IAED;;OAEG;IACH,mCAkBC;IAED,wCAgCC;IAED,6CAuBC;IAED,gDAkBC;IAED;;;OAGG;IACH,2BAFa,QAAQ,IAAI,CAAC,CA6KzB;IAED;;;OAGG;IACH,wBAFa,QAAQ,IAAI,CAAC,CAazB;IAED;;OAEG;IACH,0CASC;CAmDF"}

package/lib/metrics/metricsRedisClient.js

@@ -12,6 +12,9 @@ const {
 const redisConnectionStableFields = ['name', 'flags', 'cmd'];
 const redisConnectionFields = ['name', 'flags', 'tot-mem', 'cmd'];
 
+/** Stream entries older than this (ms) are trimmed so messages are not kept in Redis. Fixed 60s. */
+const GRACEFUL_SHUTDOWN_STREAM_MAXAGE_MS = 60000;
+
 /**
  * RedisMetricsClient extends BaseMetricsClient to collect
  * Redis metrics periodically and push them to Prometheus Pushgateway.
@@ -37,35 +40,25 @@ class RedisMetricsClient extends BaseMetricsClient {
    */
   constructor({
     redisClient,
-    gracefulShutdownRedis,
     ...metricsConfig
   } = {}) {
+    if (redisClient == null) {
+      throw new Error('RedisMetricsClient requires redisClient');
+    }
     const intervalSec = metricsConfig.intervalSec || parseInt(process.env.METRICS_QUEUE_INTERVAL_SEC || '', 10) || 5;
     super({
       ...metricsConfig,
       processType: metricsConfig.processType || 'queue-metrics',
-      intervalSec,
-      skipFirstPush: metricsConfig.skipFirstPush !== false
+      intervalSec
     });
 
     /** Redis client used for metrics */
     this.redisClient = redisClient;
     this.redisClientType = getRedisClientType(redisClient);
 
-    /** When true, new instance publishes once to Redis on start; old instances subscribed to same channel exit immediately. Channel = metrics:graceful-shutdown:{app}:{process_type}. Default true; set METRICS_GRACEFUL_SHUTDOWN_REDIS=false or gracefulShutdownRedis: false to disable. */
-    const disabledByParam = gracefulShutdownRedis === false;
-    const disabledByEnv = process.env.METRICS_GRACEFUL_SHUTDOWN_REDIS === 'false';
-    this._gracefulShutdownRedis = !disabledByParam && !disabledByEnv;
-    this._gracefulShutdownChannel = this._gracefulShutdownRedis ? `metrics:graceful-shutdown:${this.appName}:${this.processType}` : null;
     /** Dedicated Redis connection for subscribe (subscriber mode); closed in cleanup. */
     this._subClient = null;
-
-    /** Log prefix for graceful-shutdown messages (always logged, not behind METRICS_LOG_VALUES). */
-    this._gracefulShutdownLogPrefix = `[graceful-shutdown] [${this.processType}] [${this.appName}] [${this.dynoId}]`;
-    console.info(`${this._gracefulShutdownLogPrefix} startup: graceful_shutdown_redis=${this._gracefulShutdownRedis} channel=${this._gracefulShutdownChannel || 'none'}`);
-    if (this._gracefulShutdownRedis && this._gracefulShutdownChannel) {
-      this._setupGracefulShutdownSubscribe();
-    }
+    this._initGracefulShutdown(metricsConfig.gracefulShutdownRedis);
 
     /** Counter for Redis client connections */
     this.redisConnectionsGauge = this.createGauge({
@@ -105,92 +98,190 @@ class RedisMetricsClient extends BaseMetricsClient {
   }
 
   /**
-   * Set up Redis subscribe for graceful shutdown. Uses one connection: either redisClient.duplicate() (ioredis) or a client created from REDIS_URL (node-redis). Caller passes only redisClient.
+   * Initialize graceful-shutdown state and subscribe when enabled. Called from constructor.
+   * @param {boolean} [gracefulShutdownRedis] - Explicit false to disable; otherwise enabled unless METRICS_GRACEFUL_SHUTDOWN_REDIS=false.
    */
-  _setupGracefulShutdownSubscribe() {
-    const channel = this._gracefulShutdownChannel;
-    if (!channel) return;
-    let subClient = null;
-    if (this.redisClient && typeof this.redisClient.duplicate === 'function') {
-      subClient = this.redisClient.duplicate();
-      console.info(`${this._gracefulShutdownLogPrefix} setup_subscribe: using redisClient.duplicate() for channel=${channel}`);
-    } else if (process.env.REDIS_URL) {
+  _initGracefulShutdown(gracefulShutdownRedis) {
+    const disabledByParam = gracefulShutdownRedis === false;
+    const disabledByEnv = process.env.METRICS_GRACEFUL_SHUTDOWN_REDIS === 'false';
+    this._gracefulShutdownRedis = !disabledByParam && !disabledByEnv;
+    this._gracefulShutdownStream = this._gracefulShutdownRedis ? `metrics:graceful-shutdown:${this.appName}:${this.processType}` : null;
+    this._gracefulShutdownAckChannel = this._gracefulShutdownRedis ? `metrics:graceful-shutdown-ack:${this.appName}:${this.processType}` : null;
+    this._gracefulShutdownLogPrefix = `[graceful-shutdown] [${this.processType}] [${this.appName}] [${this.dynoId}]`;
+    if (this._gracefulShutdownRedis && this._gracefulShutdownStream) {
+      this._setupGracefulShutdownSubscribe();
+    }
+  }
+
+  /**
+   * Create a dedicated Redis client for subscribe (pub/sub). Uses duplicate() when available, else createClient from REDIS_URL. Branches by redisClientType (IOREDIS, REDIS_V3, REDIS_V4).
+   * @returns {any|null} Subscriber client or null if not possible.
+   */
+  _createSubscriberClient() {
+    if (this.redisClientType === IOREDIS && this.redisClient && typeof this.redisClient.duplicate === 'function') {
+      return this.redisClient.duplicate();
+    }
+    if ((this.redisClientType === REDIS_V3 || this.redisClientType === REDIS_V4) && this.redisClient && typeof this.redisClient.duplicate === 'function') {
+      return this.redisClient.duplicate();
+    }
+    if ((this.redisClientType === REDIS_V3 || this.redisClientType === REDIS_V4) && process.env.REDIS_URL) {
       try {
         const redis = require('redis');
-        subClient = redis.createClient({
-          url: process.env.REDIS_URL
-        });
-        if (subClient && typeof subClient.on === 'function') {
-          subClient.on('error', err => {
-            console.error(`${this._gracefulShutdownLogPrefix} subscriber client error:`, err.message);
+        if (typeof redis.createClient !== 'function') return null;
+        try {
+          return redis.createClient({
+            url: process.env.REDIS_URL
           });
+        } catch {
+          return redis.createClient(process.env.REDIS_URL);
         }
-        console.info(`${this._gracefulShutdownLogPrefix} setup_subscribe: created subscriber from REDIS_URL for channel=${channel}`);
-      } catch (e) {
-        console.info(`${this._gracefulShutdownLogPrefix} setup_subscribe: could not create subscriber from REDIS_URL:`, e.message);
+      } catch {
+        return null;
       }
     }
-    if (!subClient) {
-      console.info(`${this._gracefulShutdownLogPrefix} No subscriber (need ioredis or REDIS_URL). Graceful shutdown via Redis disabled.`);
-      return;
+    return null;
+  }
+
+  /**
+   * Set up Redis subscribe for graceful shutdown. Uses _createSubscriberClient() so subscriber matches client type (ioredis vs node-redis v3/v4).
+   */
+  /**
+   * Set up Redis stream read for graceful shutdown. Uses _createSubscriberClient() and XREAD BLOCK; stream is trimmed (MAXLEN and MINID) so messages are not kept in Redis forever.
+   */
+  _setupGracefulShutdownSubscribe() {
+    const streamKey = this._gracefulShutdownStream;
+    if (!streamKey) return;
+    const subClient = this._createSubscriberClient();
+    if (subClient && typeof subClient.on === 'function') {
+      subClient.on('error', () => {});
     }
-    console.info(`${this._gracefulShutdownLogPrefix} setup_subscribe: channel=${channel} hasSubClient=true`);
+    if (!subClient) return;
     this._subClient = subClient;
-    const onMessage = () => {
-      console.info(`${this._gracefulShutdownLogPrefix} OLD: received new-instance message on channel ${channel}; exiting.`);
-      this.cleanup();
+    this._streamReadLoop(streamKey);
+  }
+  _streamReadLoop(streamKey) {
+    const self = this;
+    const blockMs = 5000;
+    const runRead = () => {
+      if (!self._subClient) return;
+      self._xreadBlock(streamKey, blockMs).then(entries => {
+        if (!entries || entries.length === 0) {
+          setImmediate(runRead);
+          return;
+        }
+        self._cleanupAndPublishAck();
+      }).catch(() => {
+        setImmediate(runRead);
+      });
     };
+    runRead();
+  }
+  _xreadBlock(streamKey, blockMs) {
+    const client = this._subClient || this.redisClient;
+    if (!client) return Promise.resolve([]);
     if (this.redisClientType === REDIS_V3) {
-      subClient.on('subscribe', () => {
-        console.info(`${this._gracefulShutdownLogPrefix} Subscribed to channel=${channel} (waiting for new-instance message).`);
-      });
-      subClient.on('message', (ch, _msg) => {
-        if (ch === channel) onMessage();
-      });
-      subClient.subscribe(channel);
-    } else if (this.redisClientType === REDIS_V4) {
-      subClient.on('subscribe', () => {
-        console.info(`${this._gracefulShutdownLogPrefix} Subscribed to channel=${channel} (waiting for new-instance message).`);
-      });
-      subClient.on('message', (ch, _msg) => {
-        if (ch === channel) onMessage();
+      return new Promise((resolve, reject) => {
+        client.send_command('XREAD', ['BLOCK', String(blockMs), 'STREAMS', streamKey, '$'], (err, result) => {
+          if (err) return reject(err);
+          resolve(this._parseXreadReply(result, streamKey));
+        });
       });
-      subClient.subscribe(channel);
-    } else if (this.redisClientType === IOREDIS) {
-      subClient.subscribe(channel, (err, count) => {
-        if (err) {
-          console.error(`${this._gracefulShutdownLogPrefix} Subscribe error:`, err);
-          return;
+    }
+    if (this.redisClientType === REDIS_V4) {
+      const p = client.sendCommand(['XREAD', 'BLOCK', String(blockMs), 'STREAMS', streamKey, '$']);
+      return Promise.resolve(p).then(result => this._parseXreadReply(result, streamKey)).catch(() => []);
+    }
+    if (this.redisClientType === IOREDIS) {
+      const p = client.call('XREAD', 'BLOCK', blockMs, 'STREAMS', streamKey, '$');
+      return Promise.resolve(p).then(result => this._parseXreadReply(result, streamKey)).catch(() => []);
+    }
+    return Promise.resolve([]);
+  }
+  _parseXreadReply(reply, streamKey) {
+    if (!reply || !Array.isArray(reply)) return [];
+    const streamReply = reply.find(r => r && r[0] === streamKey);
+    if (!streamReply || !Array.isArray(streamReply[1])) return [];
+    return streamReply[1].map(entry => Array.isArray(entry) ? [entry[0], entry[1] || []] : [entry, []]);
+  }
+
+  /**
+   * Old instance: stop push, clear metrics from VM, then publish ack so new can start; then exit.
+   */
+  async _cleanupAndPublishAck() {
+    this.stopPush();
+    if (this.enabled) {
+      await this.gatewayDelete();
+    }
+    await this._publishAck();
+    if (this._subClient) {
+      try {
+        if (this.redisClientType === REDIS_V3) {
+          await new Promise((resolve, reject) => {
+            if (typeof this._subClient.quit === 'function') {
+              this._subClient.quit(err => err ? reject(err) : resolve());
+            } else resolve();
+          });
+        } else if (this.redisClientType === REDIS_V4) {
+          if (this._subClient.quit) await this._subClient.quit();
+        } else if (this.redisClientType === IOREDIS) {
+          if (this._subClient.disconnect) await this._subClient.disconnect();
         }
-        console.info(`${this._gracefulShutdownLogPrefix} Subscribed to channel=${channel} (waiting for new-instance message).`);
-      });
-      subClient.on('message', (ch, _msg) => {
-        if (ch === channel) onMessage();
+      } catch {
+        // ignore
+      }
+      this._subClient = null;
+    }
+    try {
+      if (this.redisClient) {
+        if (this.redisClientType === REDIS_V3 || this.redisClientType === REDIS_V4) {
+          await this.redisClient.quit();
+        } else if (this.redisClientType === IOREDIS) {
+          await this.redisClient.disconnect();
+        }
+      }
+    } catch {
+      // ignore
+    }
+    process.exit(0);
+  }
+  _publishAck() {
+    const ackChannel = this._gracefulShutdownAckChannel;
+    if (!ackChannel || !this.redisClient) return Promise.resolve();
+    console.warn(`${this._gracefulShutdownLogPrefix} OLD: clearing metrics and exiting.`);
+    const msg = this.dynoId || 'stopped';
+    if (this.redisClientType === REDIS_V3) {
+      return new Promise(resolve => {
+        this.redisClient.send_command('PUBLISH', [ackChannel, msg], () => resolve());
       });
     }
+    if (this.redisClientType === REDIS_V4) {
+      return this.redisClient.sendCommand(['PUBLISH', ackChannel, msg]).catch(() => {});
+    }
+    if (this.redisClientType === IOREDIS) {
+      return this.redisClient.publish(ackChannel, msg).catch(() => {});
+    }
+    return Promise.resolve();
   }
 
   /**
-   * Publish one-time "new instance started" so old instances (subscribed to the same channel) exit. Call from new instance after startPush.
+   * Publish "new instance started" to stream so old instances exit. Stream is trimmed (MAXLEN ~ 10 and MINID older than 1 min) so messages are not kept in Redis forever.
    */
   _publishNewInstanceStarted() {
-    if (!this._gracefulShutdownChannel || !this.redisClient) return;
-    const channel = this._gracefulShutdownChannel;
-    const message = this.dynoId || '1';
-    const done = err => {
-      if (err) {
-        console.info(`${this._gracefulShutdownLogPrefix} NEW: publish failed:`, err.message);
-      } else {
-        console.info(`${this._gracefulShutdownLogPrefix} NEW: published to channel=${channel} (new instance started; old instances will exit).`);
-      }
-    };
-    console.info(`${this._gracefulShutdownLogPrefix} NEW: publishing to channel=${channel} dynoId=${this.dynoId || '1'}`);
+    const streamKey = this._gracefulShutdownStream;
+    if (!streamKey || !this.redisClient) return;
+    const value = this.dynoId || '1';
+    const noop = () => {};
+    const maxAgeMs = GRACEFUL_SHUTDOWN_STREAM_MAXAGE_MS;
+    const minId = `${Date.now() - maxAgeMs}-0`;
     if (this.redisClientType === REDIS_V3) {
-      this.redisClient.send_command('PUBLISH', [channel, message], done);
+      this.redisClient.send_command('XADD', [streamKey, 'MAXLEN', '~', '10', '*', 'dyno_id', value], noop);
+      this.redisClient.send_command('XTRIM', [streamKey, 'MINID', minId], noop);
     } else if (this.redisClientType === REDIS_V4) {
-      this.redisClient.sendCommand(['PUBLISH', channel, message]).then(() => done()).catch(done);
+      this.redisClient.sendCommand(['XADD', streamKey, 'MAXLEN', '~', '10', '*', 'dyno_id', value]).catch(noop);
+      this.redisClient.sendCommand(['XTRIM', streamKey, 'MINID', minId]).catch(noop);
     } else if (this.redisClientType === IOREDIS) {
-      this.redisClient.publish(channel, message).then(() => done()).catch(done);
+      this.redisClient.call('XADD', streamKey, 'MAXLEN', '~', 10, '*', 'dyno_id', value).catch(noop);
+      this.redisClient.call('XTRIM', streamKey, 'MINID', minId).catch(noop);
     }
   }
   getRedisConnections = async () => {
@@ -406,7 +497,7 @@ class RedisMetricsClient extends BaseMetricsClient {
         }, parseInt(stats.instantaneous_ops_per_sec, 10) || 0);
       }
     } catch (error) {
-      console.info(`[queue-metrics] Failed to collect Redis metrics:`, error.message);
+      console.error(`[queue-metrics] Failed to collect Redis metrics:`, error.message);
     }
   };
 
@@ -419,10 +510,6 @@ class RedisMetricsClient extends BaseMetricsClient {
       await this.collectRedisMetrics();
       await this.gatewayPush();
       this.clearAllCounters();
-      if (this.metricsLogValues) {
-        const metricObjects = await this.registry.getMetricsAsJSON();
-        console.info(`[queue-metrics] Collected metrics for Redis`, JSON.stringify(metricObjects, null, 2));
-      }
     } catch (error) {
       console.error(`[queue-metrics] Failed to collect Redis metrics: ${error.message}`);
       throw error;
@@ -430,8 +517,7 @@ class RedisMetricsClient extends BaseMetricsClient {
   };
 
   /**
-   * Start periodic collection.
-   * @param {number} [intervalSec=this.intervalSec] - Interval in seconds
+   * Start periodic collection. When graceful shutdown is on: new publishes "new started" so old exits and clears; new does not push until after one interval (skipFirstPush), giving old time to stop.
    */
   startPush = (intervalSec = this.intervalSec) => {
     this._startPush(intervalSec, () => {
@@ -482,7 +568,7 @@ class RedisMetricsClient extends BaseMetricsClient {
     } catch (err) {
       console.error('[queue-metrics] Error closing Redis client:', err);
     }
-    process.exit(0);
+    await super.cleanup();
   };
   _setCleanupHandlers = () => {
     process.on('SIGINT', this.cleanup);