@adalo/metrics 0.1.17 → 0.1.18

package/lib/metricsClient.d.ts

@@ -15,6 +15,8 @@ export class MetricsClient {
      * @param {string} [config.pushgatewayPassword] PushGateway password
      * @param {number} [config.intervalSec] Interval in seconds for pushing metrics
      * @param {boolean} [config.removeAllJobs] Enable to clear all jobs at startup
+     * @param {boolean} [config.scripDefaultMetrics] Enable to scip default metrics creation
+     * @param {function} [config.startupValidation] Add to validate on start push.
      */
     constructor(config?: {
         appName?: string | undefined;
@@ -27,6 +29,8 @@ export class MetricsClient {
         pushgatewayPassword?: string | undefined;
         intervalSec?: number | undefined;
         removeAllJobs?: boolean | undefined;
+        scripDefaultMetrics?: boolean | undefined;
+        startupValidation?: Function | undefined;
     });
     appName: string;
     dynoId: string;
@@ -37,25 +41,27 @@ export class MetricsClient {
     pushgatewayUser: string;
     pushgatewayPassword: string;
     intervalSec: number;
+    startupValidation: Function | undefined;
     prefixLogs: string;
-    registry: client.Registry<"text/plain; version=0.0.4; charset=utf-8">;
+    get registry(): any;
     defaultLabels: {
         app: string;
         dyno_id: string;
         process_type: string;
     };
     authToken: string;
-    gateway: client.Pushgateway<"text/plain; version=0.0.4; charset=utf-8">;
+    gateway: client.Pushgateway<client.RegistryContentType>;
     gauges: {};
     counters: {};
     /** @type {Object<string, function(): number | Promise<number>>} */
     gaugeUpdaters: {
         [x: string]: () => number | Promise<number>;
     };
+    customsMetricsTracking: {};
     _lastUsageMicros: number;
     _lastCheckTime: number;
     /**
-     * Register default gauges and counters.
+     * Register all built-in default Gauges and Counters.
      * @private
      */
     private _initDefaultMetrics;
@@ -67,16 +73,25 @@ export class MetricsClient {
      * @param {string[]} [labelNames]
      * @returns {client.Gauge}
      */
-    createGauge: (name: string, help: string, updateFn?: (() => number | Promise<number>) | undefined, labelNames?: string[] | undefined) => client.Gauge;
+    createGauge: ({ name, help, updateFn, labelNames, }: string) => client.Gauge;
     /**
-     * Create a counter metric.
-     * Returns a trigger function to increment the counter manually.
-     * @param {string} name
-     * @param {string} help
-     * @param {string[]} [labelNames]
-     * @returns {function(data?: object, value?: number): void} triggerFn
+     * Create a Prometheus Counter metric.
+     *
+     * @param {object} params
+     * @param {string} params.name Metric name
+     * @param {string} params.help Metric description
+     * @param {string[]} [params.labelNames]
+     *        Optional list of label names. Defaults to this.defaultLabels keys.
+     *
+     * @returns {function(data?: object, value?: number): void}
+     *          A trigger function to increment the counter:
+     *          triggerFn(labels?, incrementValue?)
      */
-    createCounter(name: string, help: string, labelNames?: string[] | undefined): (arg0: data | null, arg1: object, arg2: value | null, arg3: number) => void;
+    createCounter({ name, help, labelNames }: {
+        name: string;
+        help: string;
+        labelNames?: string[] | undefined;
+    }): (arg0: data | null, arg1: object, arg2: value | null, arg3: number) => void;
     /**
      * Get CPU usage percent (cgroup-aware)
      * @returns {number}
@@ -112,13 +127,70 @@ export class MetricsClient {
      */
     pushMetrics: () => Promise<void>;
     /**
-     * Start automatic periodic push of metrics.
+     * Start periodic metrics collection + push.
+     *
      * @param {number} [interval] Interval in seconds
+     * @param {function(): void|Promise<void>} [customPushMetics]
+     *        Optional custom push function. If provided, Prometheus push is skipped.
      */
-    startPush: (interval?: number | undefined) => void;
+    startPush: (interval?: number | undefined, customPushMetics?: (() => void | Promise<void>) | undefined) => void;
     cleanup: () => Promise<never>;
-    _clearOldWorkers: (removeAllJobs: any) => Promise<void>;
+    /**
+     * Remove old/stale dyno/instance metrics from PushGateway.
+     *
+     * Compares existing PushGateway metrics for this job and deletes any instances
+     * that do not match the current dynoId.
+     *
+     * @param {boolean} removeAllJobs If true, performs cleanup; otherwise does nothing
+     * @returns {Promise<void>}
+     * @private
+     */
+    private _clearOldWorkers;
+    /**
+     * Delete metrics for this job/instance from PushGateway.
+     *
+     * @param {Object} [params]
+     * @param {string} [params.jobName] Job name (defaults to appName)
+     * @param {Object} [params.groupings] Grouping labels
+     * @param {string} [params.groupings.process_type] Process type label
+     * @param {string} [params.groupings.instance] Instance/dyno ID
+     * @returns {Promise<void>}
+     */
+    gatewayDelete: (params?: {
+        jobName?: string | undefined;
+        groupings?: {
+            process_type?: string | undefined;
+            instance?: string | undefined;
+        } | undefined;
+    } | undefined) => Promise<void>;
+    /**
+     * Push metrics to PushGateway.
+     *
+     * @param {object} [params]
+     * @param {string} [params.jobName]
+     * @param {object} [params.groupings]
+     * @returns {Promise<void>}
+     */
+    gatewayPush: (params?: {
+        jobName?: string | undefined;
+        groupings?: object | undefined;
+    } | undefined) => Promise<void>;
+    /**
+     * Merge the default metric labels (`app`, `dyno_id`, `process_type`)
+     * with custom label names.
+     *
+     * @param {string[]} labels Additional label names
+     * @returns {string[]} Combined label names
+     */
+    withDefaultLabels: (labels?: string[]) => string[];
+    getDefaultLabels: (labels?: any[]) => {
+        app: string;
+        dyno_id: string;
+        process_type: string;
+    };
     _setCleanupHandlers: () => void;
+    get metricsEnabled(): boolean;
+    get metricsLogValues(): boolean;
 }
 import client = require("prom-client");
 //# sourceMappingURL=metricsClient.d.ts.map

package/lib/metricsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metricsClient.d.ts","sourceRoot":"","sources":["../src/metricsClient.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH;IACE;;;;;;;;;;;;OAYG;IACH;QAX2B,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,eAAe;QACf,mBAAmB;QACnB,WAAW;QACV,aAAa;OA4DxC;IAzDC,gBACiE;IACjE,eAAqE;IACrE,oBAG6B;IAC7B,iBAAuE;IACvE,mBAC+D;IAC/D,uBACoE;IACpE,wBACsE;IACtE,4BAGI;IACJ,oBAGI;IAEJ,mBAAyF;IAEzF,sEAAqC;IAGrC;;;;MAIC;IAED,kBAEoB;IACpB,wEAOC;IAED,WAAgB;IAChB,aAAkB;IAElB,mEAAmE;IACnE;YADkB,MAAM,SAAc,MAAM,GAAG,QAAQ,MAAM,CAAC;MACvC;IACvB,yBAAyB;IACzB,uBAAgC;IAOlC;;;OAGG;IACH,4BA8CC;IAED;;;;;;;OAOG;IACH,oBANW,MAAM,QACN,MAAM,oBACM,MAAM,GAAC,QAAQ,MAAM,CAAC,qDAEhC,OAAO,KAAK,CAqBxB;IAED;;;;;;;OAOG;IACH,oBALW,MAAM,QACN,MAAM,gEAEY,MAAM,4BAAU,MAAM,KAAG,IAAI,CAmBzD;IAED;;;OAGG;IACH,0BAFa,MAAM,CA2BlB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAiBlB;IAED;;;OAGG;IACH,2BAFa,MAAM,CAWlB;IAED;;;OAGG;IACH,2BAFa,MAAM,CAgBlB;IAED;;;OAGG;IACH,cAFa,QAAQ,MAAM,CAAC,CAO3B;IAED;;;OAGG;IACH,oEA0BC;IAED;;OAEG;IACH,iCAgCC;IAED;;;OAGG;IACH,mDAYC;IAED,8BAWC;IAED,wDAyDC;IAED,gCAGC;CACF"}
+{"version":3,"file":"metricsClient.d.ts","sourceRoot":"","sources":["../src/metricsClient.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH;IACE;;;;;;;;;;;;;;OAcG;IACH;QAb2B,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,eAAe;QACf,mBAAmB;QACnB,WAAW;QACV,aAAa;QACb,mBAAmB;QAClB,iBAAiB;OAgE7C;IA7DC,gBACiE;IACjE,eAAqE;IACrE,oBAG6B;IAC7B,iBAAuE;IACvE,mBAC+D;IAC/D,uBACoE;IACpE,wBACsE;IACtE,4BAGI;IACJ,oBAGI;IACJ,wCAAiD;IAEjD,mBAAyF;IAqf3F,oBAEC;IAlfC;;;;MAIC;IAED,kBAEoB;IACpB,wDAOC;IAED,WAAgB;IAChB,aAAkB;IAElB,mEAAmE;IACnE;YADkB,MAAM,SAAc,MAAM,GAAG,QAAQ,MAAM,CAAC;MACvC;IACvB,2BAAgC;IAChC,yBAAyB;IACzB,uBAAgC;IASlC;;;OAGG;IACH,4BAkDC;IAED;;;;;;;OAOG;IACH,qDANW,MAAM,KAIJ,OAAO,KAAK,CAsBxB;IAED;;;;;;;;;;;;OAYG;IACH;QAT0B,IAAI,EAAnB,MAAM;QACS,IAAI,EAAnB,MAAM;QACY,UAAU;kCAGV,MAAM,4BAAU,MAAM,KAAG,IAAI,CAqBzD;IAED;;;OAGG;IACH,0BAFa,MAAM,CA2BlB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAiBlB;IAED;;;OAGG;IACH,2BAFa,MAAM,CAWlB;IAED;;;OAGG;IACH,2BAFa,MAAM,CAgBlB;IAED;;;OAGG;IACH,cAFa,QAAQ,MAAM,CAAC,CAO3B;IAED;;;OAGG;IACH,oEA0BC;IAED;;OAEG;IACH,iCAmCC;IAED;;;;;;OAMG;IACH,qEAHuB,IAAI,GAAC,QAAQ,IAAI,CAAC,uBA0BxC;IAED,8BAKC;IAED;;;;;;;;;OASG;IACH,yBAuDC;IAED;;;;;;;;;OASG;IACH;;;;;;sBAFa,QAAQ,IAAI,CAAC,CAUzB;IAED;;;;;;;OAOG;IACH;;;sBAFa,QAAQ,IAAI,CAAC,CAUzB;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;MAEC;IAED,gCAGC;IAID,8BAEC;IAED,gCAEC;CAKF"}

package/lib/metricsClient.js

@@ -22,6 +22,8 @@ class MetricsClient {
    * @param {string} [config.pushgatewayPassword] PushGateway password
    * @param {number} [config.intervalSec] Interval in seconds for pushing metrics
    * @param {boolean} [config.removeAllJobs] Enable to clear all jobs at startup
+   * @param {boolean} [config.scripDefaultMetrics] Enable to scip default metrics creation
+   * @param {function} [config.startupValidation] Add to validate on start push.
    */
   constructor(config = {}) {
     this.appName = config.appName || process.env.METRICS_APP_NAME || 'unknown-app';
@@ -33,6 +35,7 @@ class MetricsClient {
     this.pushgatewayUser = config.pushgatewayUser || process.env.METRICS_PUSHGATEWAY_USER || '';
     this.pushgatewayPassword = config.pushgatewayPassword || process.env.METRICS_PUSHGATEWAY_PASSWORD || '';
     this.intervalSec = config.intervalSec || parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) || 15;
+    this.startupValidation = config.startupValidation;
     this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`;
     this.registry = new client.Registry();
     client.collectDefaultMetrics({
@@ -57,26 +60,57 @@ class MetricsClient {
 
     /** @type {Object<string, function(): number | Promise<number>>} */
     this.gaugeUpdaters = {};
+    this.customsMetricsTracking = {};
     this._lastUsageMicros = 0;
     this._lastCheckTime = Date.now();
     this._clearOldWorkers(config.removeAllJobs).then(_ => {
-      this._initDefaultMetrics();
+      if (config.scripDefaultMetrics) {
+        this._initDefaultMetrics();
+      }
       this._setCleanupHandlers();
     });
   }
 
   /**
-   * Register default gauges and counters.
+   * Register all built-in default Gauges and Counters.
    * @private
    */
   _initDefaultMetrics = () => {
-    this.createGauge('app_process_cpu_usage_percent', 'Current CPU usage of the Node.js process in percent', this.getCpuUsagePercent);
-    this.createGauge('app_available_cpu_count', 'How many CPU cores are available to this process', this.getAvailableCPUs);
-    this.createGauge('app_container_memory_usage_bytes', 'Current container RAM usage from cgroup', this.getContainerMemoryUsage);
-    this.createGauge('app_event_loop_lag_ms', 'Estimated event loop lag in milliseconds', this.measureLag);
-    this.createGauge('app_container_memory_limit_bytes', 'Max RAM available to container from cgroup (memory.max)', this.getContainerMemoryLimit);
-    this.createGauge('app_uptime_seconds', 'How long the process has been running', process.uptime);
-    this.createCounter('app_http_requests_total', 'Total number of HTTP requests handled by this process', [...Object.keys(this.defaultLabels), 'method', 'route', 'appId', 'databaseId', 'duration', 'requestSize', 'status_code']);
+    this.createGauge({
+      name: 'app_process_cpu_usage_percent',
+      help: 'Current CPU usage of the Node.js process in percent',
+      updateFn: this.getCpuUsagePercent
+    });
+    this.createGauge({
+      name: 'app_available_cpu_count',
+      help: 'How many CPU cores are available to this process',
+      updateFn: this.getAvailableCPUs
+    });
+    this.createGauge({
+      name: 'app_container_memory_usage_bytes',
+      help: 'Current container RAM usage from cgroup',
+      updateFn: this.getContainerMemoryUsage
+    });
+    this.createGauge({
+      name: 'app_event_loop_lag_ms',
+      help: 'Estimated event loop lag in milliseconds',
+      updateFn: this.measureLag
+    });
+    this.createGauge({
+      name: 'app_container_memory_limit_bytes',
+      help: 'Max RAM available to container from cgroup (memory.max)',
+      updateFn: this.getContainerMemoryLimit
+    });
+    this.createGauge({
+      name: 'app_uptime_seconds',
+      help: 'How long the process has been running',
+      updateFn: process.uptime
+    });
+    this.createCounter({
+      name: 'app_http_requests_total',
+      help: 'Total number of HTTP requests handled by this process',
+      labelNames: this.withDefaultLabels(['method', 'route', 'appId', 'databaseId', 'duration', 'requestSize', 'status_code'])
+    });
   };
 
   /**
@@ -87,7 +121,12 @@ class MetricsClient {
    * @param {string[]} [labelNames]
    * @returns {client.Gauge}
    */
-  createGauge = (name, help, updateFn, labelNames = Object.keys(this.defaultLabels)) => {
+  createGauge = ({
+    name,
+    help,
+    updateFn,
+    labelNames = Object.keys(this.defaultLabels)
+  }) => {
     if (this.gauges[name]) return this.gauges[name];
     const g = new client.Gauge({
       name,
@@ -96,19 +135,28 @@ class MetricsClient {
       registers: [this.registry]
     });
     this.gauges[name] = g;
-    if (typeof updateFn === 'function') this.gaugeUpdaters[name] = updateFn;
+    if (updateFn && typeof updateFn === 'function') this.gaugeUpdaters[name] = updateFn;
     return g;
   };
 
   /**
-   * Create a counter metric.
-   * Returns a trigger function to increment the counter manually.
-   * @param {string} name
-   * @param {string} help
-   * @param {string[]} [labelNames]
-   * @returns {function(data?: object, value?: number): void} triggerFn
+   * Create a Prometheus Counter metric.
+   *
+   * @param {object} params
+   * @param {string} params.name Metric name
+   * @param {string} params.help Metric description
+   * @param {string[]} [params.labelNames]
+   *        Optional list of label names. Defaults to this.defaultLabels keys.
+   *
+   * @returns {function(data?: object, value?: number): void}
+   *          A trigger function to increment the counter:
+   *          triggerFn(labels?, incrementValue?)
    */
-  createCounter(name, help, labelNames = Object.keys(this.defaultLabels)) {
+  createCounter({
+    name,
+    help,
+    labelNames = Object.keys(this.defaultLabels)
+  }) {
     if (this.counters[name]) return this.counters[name].triggerFn;
     const c = new client.Counter({
       name,
@@ -244,6 +292,9 @@ class MetricsClient {
     try {
       for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {
         try {
+          if (!updateFn) {
+            return;
+          }
           const result = updateFn();
           const val = result instanceof Promise ? await result : result;
           if (val !== undefined) this.gauges[name].set(this.defaultLabels, val);
@@ -251,7 +302,7 @@ class MetricsClient {
           console.error(`${this.prefixLogs} Failed to update gauge ${name}:`, err);
         }
       }
-      await this.gateway.push({
+      await this.gatewayPush({
         jobName: this.appName,
         groupings: {
           process_type: this.processType,
@@ -269,32 +320,48 @@ class MetricsClient {
   };
 
   /**
-   * Start automatic periodic push of metrics.
+   * Start periodic metrics collection + push.
+   *
    * @param {number} [interval] Interval in seconds
+   * @param {function(): void|Promise<void>} [customPushMetics]
+   *        Optional custom push function. If provided, Prometheus push is skipped.
    */
-  startPush = (interval = this.intervalSec) => {
+  startPush = (interval = this.intervalSec, customPushMetics = () => {}) => {
     if (!this.enabled) {
       console.warn(`${this.prefixLogs} Metrics disabled`);
+      return;
     }
-    setInterval(() => {
-      this.pushMetrics().catch(err => {
-        console.error(`${this.prefixLogs} Failed to push metrics:`, err);
-      });
-    }, interval * 1000);
-    console.warn(`${this.prefixLogs} Metrics collection started.`);
+    if (this.startupValidation && !this.startupValidation()) {
+      return;
+    }
+    if (customPushMetics) {
+      setInterval(customPushMetics, interval * 1000);
+    } else {
+      setInterval(() => {
+        this.pushMetrics().catch(err => {
+          console.error(`${this.prefixLogs} Failed to push metrics:`, err);
+        });
+      }, interval * 1000);
+    }
+    console.warn(`${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s)`);
   };
   cleanup = async () => {
     if (this.enabled) {
-      await this.gateway.delete({
-        jobName: this.appName,
-        groupings: {
-          process_type: this.processType,
-          instance: this.dynoId
-        }
-      });
+      await this.gatewayDelete();
     }
     process.exit(0);
   };
+
+  /**
+   * Remove old/stale dyno/instance metrics from PushGateway.
+   *
+   * Compares existing PushGateway metrics for this job and deletes any instances
+   * that do not match the current dynoId.
+   *
+   * @param {boolean} removeAllJobs If true, performs cleanup; otherwise does nothing
+   * @returns {Promise<void>}
+   * @private
+   */
   _clearOldWorkers = async removeAllJobs => {
     if (!removeAllJobs) return;
     try {
@@ -323,10 +390,8 @@ class MetricsClient {
         return;
       }
       for (const instance of instances) {
-        await this.gateway.delete({
-          jobName: this.appName,
+        await this.gatewayDelete({
           groupings: {
-            process_type: this.processType,
             instance
           }
         });
@@ -337,10 +402,74 @@ class MetricsClient {
       console.error(`${this.prefixLogs} Error deleting old metrics:`, err);
     }
   };
+
+  /**
+   * Delete metrics for this job/instance from PushGateway.
+   *
+   * @param {Object} [params]
+   * @param {string} [params.jobName] Job name (defaults to appName)
+   * @param {Object} [params.groupings] Grouping labels
+   * @param {string} [params.groupings.process_type] Process type label
+   * @param {string} [params.groupings.instance] Instance/dyno ID
+   * @returns {Promise<void>}
+   */
+  gatewayDelete = async (params = {}) => {
+    return this.gateway.delete({
+      jobName: params.jobName || this.appName,
+      groupings: {
+        process_type: params.groupings?.process_type || this.processType,
+        instance: params.groupings?.instance || this.dynoId
+      }
+    });
+  };
+
+  /**
+   * Push metrics to PushGateway.
+   *
+   * @param {object} [params]
+   * @param {string} [params.jobName]
+   * @param {object} [params.groupings]
+   * @returns {Promise<void>}
+   */
+  gatewayPush = async (params = {}) => {
+    return this.gateway.push({
+      jobName: params.jobName || this.appName,
+      groupings: {
+        process_type: params.groupings?.process_type || this.processType,
+        instance: params.groupings?.instance || this.dynoId
+      }
+    });
+  };
+
+  /**
+   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)
+   * with custom label names.
+   *
+   * @param {string[]} labels Additional label names
+   * @returns {string[]} Combined label names
+   */
+  withDefaultLabels = (labels = []) => {
+    return [...Object.keys(this.defaultLabels), labels];
+  };
+  getDefaultLabels = (labels = []) => {
+    return this.defaultLabels;
+  };
   _setCleanupHandlers = () => {
     process.on('SIGINT', this.cleanup);
     process.on('SIGTERM', this.cleanup);
   };
+
+  // GETTERS
+
+  get metricsEnabled() {
+    return this.enabled;
+  }
+  get metricsLogValues() {
+    return this.logValues;
+  }
+  get registry() {
+    return this.registry;
+  }
 }
 module.exports = {
   MetricsClient

package/lib/metricsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"metricsClient.js","names":["client","require","fs","os","https","MetricsClient","constructor","config","appName","process","env","METRICS_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","pushgatewayUser","METRICS_PUSHGATEWAY_USER","pushgatewayPassword","METRICS_PUSHGATEWAY_PASSWORD","intervalSec","parseInt","METRICS_INTERVAL_SEC","prefixLogs","registry","Registry","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","authToken","Buffer","from","toString","gateway","Pushgateway","headers","Authorization","agent","Agent","keepAlive","gauges","counters","gaugeUpdaters","_lastUsageMicros","_lastCheckTime","Date","now","_clearOldWorkers","removeAllJobs","then","_","_initDefaultMetrics","_setCleanupHandlers","createGauge","getCpuUsagePercent","getAvailableCPUs","getContainerMemoryUsage","measureLag","getContainerMemoryLimit","uptime","createCounter","Object","keys","name","help","updateFn","labelNames","g","Gauge","registers","triggerFn","c","Counter","data","value","inc","stat","readFileSync","match","currentUsage","deltaUsage","deltaTime","cpuMaxPath","existsSync","quotaStr","periodStr","trim","split","cpus","length","memoryUsage","rss","path","val","parsed","totalmem","Promise","resolve","start","setImmediate","countHttpRequestMiddleware","req","res","next","on","route","appId","params","body","query","databaseId","app_http_requests_total","method","status_code","statusCode","duration","requestSize","pushMetrics","entries","result","undefined","set","err","console","error","push","jobName","groupings","instance","values","forEach","counter","reset","metrics","getMetricsAsJSON","log","JSON","stringify","startPush","interval","warn","setInterval","catch","cleanup","delete","exit","url","fetch","Accept","ok","status","text","regex","RegExp","instances","Set","exec","add","size","module","exports"],"sources":["../src/metricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst fs = require('fs')\nconst os = require('os')\nconst https = require('https')\n\n/**\n * MetricsClient handles Prometheus metrics collection and push.\n * Supports gauges, counters, default metrics, and custom metrics.\n */\nclass MetricsClient {\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] PushGateway URL\n   * @param {string} [config.pushgatewayUser] PushGateway username\n   * @param {string} [config.pushgatewayPassword] PushGateway password\n   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics\n   * @param {boolean} [config.removeAllJobs] Enable to clear all jobs at startup\n   */\n  constructor(config = {}) {\n    this.appName =\n      config.appName || process.env.METRICS_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.pushgatewayUser =\n      config.pushgatewayUser || process.env.METRICS_PUSHGATEWAY_USER || ''\n    this.pushgatewayPassword =\n      config.pushgatewayPassword ||\n      process.env.METRICS_PUSHGATEWAY_PASSWORD ||\n      ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\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    this.authToken = Buffer.from(\n      `${this.pushgatewayUser}:${this.pushgatewayPassword}`\n    ).toString('base64')\n    this.gateway = new client.Pushgateway(\n      this.pushgatewayUrl,\n      {\n        headers: { Authorization: `Basic ${this.authToken}` },\n        agent: new https.Agent({ keepAlive: true }),\n      },\n      this.registry\n    )\n\n    this.gauges = {}\n    this.counters = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n    this._lastUsageMicros = 0\n    this._lastCheckTime = Date.now()\n    this._clearOldWorkers(config.removeAllJobs).then(_ => {\n      this._initDefaultMetrics()\n      this._setCleanupHandlers()\n    })\n  }\n\n  /**\n   * Register default gauges and counters.\n   * @private\n   */\n  _initDefaultMetrics = () => {\n    this.createGauge(\n      'app_process_cpu_usage_percent',\n      'Current CPU usage of the Node.js process in percent',\n      this.getCpuUsagePercent\n    )\n    this.createGauge(\n      'app_available_cpu_count',\n      'How many CPU cores are available to this process',\n      this.getAvailableCPUs\n    )\n    this.createGauge(\n      'app_container_memory_usage_bytes',\n      'Current container RAM usage from cgroup',\n      this.getContainerMemoryUsage\n    )\n    this.createGauge(\n      'app_event_loop_lag_ms',\n      'Estimated event loop lag in milliseconds',\n      this.measureLag\n    )\n    this.createGauge(\n      'app_container_memory_limit_bytes',\n      'Max RAM available to container from cgroup (memory.max)',\n      this.getContainerMemoryLimit\n    )\n    this.createGauge(\n      'app_uptime_seconds',\n      'How long the process has been running',\n      process.uptime\n    )\n\n    this.createCounter(\n      'app_http_requests_total',\n      'Total number of HTTP requests handled by this process',\n      [\n        ...Object.keys(this.defaultLabels),\n        'method',\n        'route',\n        'appId',\n        'databaseId',\n        'duration',\n        'requestSize',\n        'status_code',\n      ]\n    )\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {string} name\n   * @param {string} help\n   * @param {function(): number|Promise<number>} [updateFn] Optional function returning value\n   * @param {string[]} [labelNames]\n   * @returns {client.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 (typeof updateFn === 'function') this.gaugeUpdaters[name] = updateFn\n\n    return g\n  }\n\n  /**\n   * Create a counter metric.\n   * Returns a trigger function to increment the counter manually.\n   * @param {string} name\n   * @param {string} help\n   * @param {string[]} [labelNames]\n   * @returns {function(data?: object, value?: number): void} triggerFn\n   */\n  createCounter(name, help, labelNames = Object.keys(this.defaultLabels)) {\n    if (this.counters[name]) return this.counters[name].triggerFn\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    const triggerFn = (data = {}, value = 1) => {\n      c.inc({ ...this.defaultLabels, ...data }, value)\n    }\n\n    this.counters[name].triggerFn = triggerFn\n    return triggerFn\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   * Express middleware to count HTTP requests.\n   * Increments the `app_http_requests_total` counter.\n   */\n  countHttpRequestMiddleware = (req, res, next) => {\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        ''\n\n      this.counters?.app_http_requests_total?.triggerFn({\n        method: req.method,\n        route,\n        status_code: res.statusCode,\n        appId,\n        databaseId,\n        duration: Date.now() - start,\n        requestSize: req.headers['content-length']\n          ? parseInt(req.headers['content-length'], 10)\n          : 0,\n      })\n    })\n\n    next()\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          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      await this.gateway.push({\n        jobName: this.appName,\n        groupings: { process_type: this.processType, instance: this.dynoId },\n      })\n\n      Object.values(this.counters).forEach(counter => counter.reset())\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  /**\n   * Start automatic periodic push of metrics.\n   * @param {number} [interval] Interval in seconds\n   */\n  startPush = (interval = this.intervalSec) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n    }\n\n    setInterval(() => {\n      this.pushMetrics().catch(err => {\n        console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n      })\n    }, interval * 1000)\n\n    console.warn(`${this.prefixLogs} Metrics collection started.`)\n  }\n\n  cleanup = async () => {\n    if (this.enabled) {\n      await this.gateway.delete({\n        jobName: this.appName,\n        groupings: {\n          process_type: this.processType,\n          instance: this.dynoId,\n        },\n      })\n    }\n    process.exit(0)\n  }\n\n  _clearOldWorkers = async removeAllJobs => {\n    if (!removeAllJobs) return\n\n    try {\n      const url = `${this.pushgatewayUrl}/metrics`\n      const res = await fetch(url, {\n        headers: {\n          Authorization: `Basic ${this.authToken}`,\n          Accept: 'text/plain',\n        },\n      })\n\n      if (!res.ok) {\n        console.error(\n          `${this.prefixLogs} Failed to fetch metrics: ${res.status}`\n        )\n        return\n      }\n\n      const text = await res.text()\n\n      const regex = new RegExp(\n        `(?:instance=\"([^\"]+)\".*job=\"${this.appName}\"|job=\"${this.appName}\".*instance=\"([^\"]+)\")`,\n        'g'\n      )\n      const instances = new Set()\n      let match\n      // eslint-disable-next-line no-cond-assign\n      while ((match = regex.exec(text)) !== null) {\n        const instance = match[1] || match[2]\n        if (instance && instance !== this.dynoId) instances.add(instance)\n      }\n\n      if (instances.size === 0) {\n        console.log(`${this.prefixLogs} No old dynos to delete.`)\n        return\n      }\n\n      for (const instance of instances) {\n        await this.gateway.delete({\n          jobName: this.appName,\n          groupings: {\n            process_type: this.processType,\n            instance,\n          },\n        })\n        console.log(\n          `${this.prefixLogs} Deleted metrics for old dyno: ${instance}`\n        )\n      }\n\n      console.log(\n        `${this.prefixLogs} Cleared all old instances for job ${this.appName}`\n      )\n    } catch (err) {\n      console.error(`${this.prefixLogs} Error deleting old metrics:`, err)\n    }\n  }\n\n  _setCleanupHandlers = () => {\n    process.on('SIGINT', this.cleanup)\n    process.on('SIGTERM', this.cleanup)\n  }\n}\n\nmodule.exports = { MetricsClient }\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"metricsClient.js","names":["client","require","fs","os","https","MetricsClient","constructor","config","appName","process","env","METRICS_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","pushgatewayUser","METRICS_PUSHGATEWAY_USER","pushgatewayPassword","METRICS_PUSHGATEWAY_PASSWORD","intervalSec","parseInt","METRICS_INTERVAL_SEC","startupValidation","prefixLogs","registry","Registry","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","authToken","Buffer","from","toString","gateway","Pushgateway","headers","Authorization","agent","Agent","keepAlive","gauges","counters","gaugeUpdaters","customsMetricsTracking","_lastUsageMicros","_lastCheckTime","Date","now","_clearOldWorkers","removeAllJobs","then","_","scripDefaultMetrics","_initDefaultMetrics","_setCleanupHandlers","createGauge","name","help","updateFn","getCpuUsagePercent","getAvailableCPUs","getContainerMemoryUsage","measureLag","getContainerMemoryLimit","uptime","createCounter","labelNames","withDefaultLabels","Object","keys","g","Gauge","registers","triggerFn","c","Counter","data","value","inc","stat","readFileSync","match","currentUsage","deltaUsage","deltaTime","cpuMaxPath","existsSync","quotaStr","periodStr","trim","split","cpus","length","memoryUsage","rss","path","val","parsed","totalmem","Promise","resolve","start","setImmediate","countHttpRequestMiddleware","req","res","next","on","route","appId","params","body","query","databaseId","app_http_requests_total","method","status_code","statusCode","duration","requestSize","pushMetrics","entries","result","undefined","set","err","console","error","gatewayPush","jobName","groupings","instance","values","forEach","counter","reset","metrics","getMetricsAsJSON","log","JSON","stringify","startPush","interval","customPushMetics","warn","setInterval","catch","cleanup","gatewayDelete","exit","url","fetch","Accept","ok","status","text","regex","RegExp","instances","Set","exec","add","size","delete","push","labels","getDefaultLabels","metricsEnabled","metricsLogValues","module","exports"],"sources":["../src/metricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst fs = require('fs')\nconst os = require('os')\nconst https = require('https')\n\n/**\n * MetricsClient handles Prometheus metrics collection and push.\n * Supports gauges, counters, default metrics, and custom metrics.\n */\nclass MetricsClient {\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] PushGateway URL\n   * @param {string} [config.pushgatewayUser] PushGateway username\n   * @param {string} [config.pushgatewayPassword] PushGateway password\n   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics\n   * @param {boolean} [config.removeAllJobs] Enable to clear all jobs at startup\n   * @param {boolean} [config.scripDefaultMetrics] Enable to scip default metrics creation\n   * @param {function} [config.startupValidation] Add to validate on start push.\n   */\n  constructor(config = {}) {\n    this.appName =\n      config.appName || process.env.METRICS_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.pushgatewayUser =\n      config.pushgatewayUser || process.env.METRICS_PUSHGATEWAY_USER || ''\n    this.pushgatewayPassword =\n      config.pushgatewayPassword ||\n      process.env.METRICS_PUSHGATEWAY_PASSWORD ||\n      ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\n    this.startupValidation = config.startupValidation\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    this.authToken = Buffer.from(\n      `${this.pushgatewayUser}:${this.pushgatewayPassword}`\n    ).toString('base64')\n    this.gateway = new client.Pushgateway(\n      this.pushgatewayUrl,\n      {\n        headers: { Authorization: `Basic ${this.authToken}` },\n        agent: new https.Agent({ keepAlive: true }),\n      },\n      this.registry\n    )\n\n    this.gauges = {}\n    this.counters = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n    this.customsMetricsTracking = {}\n    this._lastUsageMicros = 0\n    this._lastCheckTime = Date.now()\n    this._clearOldWorkers(config.removeAllJobs).then(_ => {\n      if (config.scripDefaultMetrics) {\n        this._initDefaultMetrics()\n      }\n      this._setCleanupHandlers()\n    })\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    this.createCounter({\n      name: 'app_http_requests_total',\n      help: 'Total number of HTTP requests handled by this process',\n      labelNames: this.withDefaultLabels([\n        'method',\n        'route',\n        'appId',\n        'databaseId',\n        'duration',\n        'requestSize',\n        'status_code',\n      ]),\n    })\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {string} name\n   * @param {string} help\n   * @param {function(): number|Promise<number>} [updateFn] Optional function returning value\n   * @param {string[]} [labelNames]\n   * @returns {client.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    return g\n  }\n\n  /**\n   * Create a Prometheus Counter metric.\n   *\n   * @param {object} params\n   * @param {string} params.name Metric name\n   * @param {string} params.help Metric description\n   * @param {string[]} [params.labelNames]\n   *        Optional list of label names. Defaults to this.defaultLabels keys.\n   *\n   * @returns {function(data?: object, value?: number): void}\n   *          A trigger function to increment the counter:\n   *          triggerFn(labels?, incrementValue?)\n   */\n  createCounter({ name, help, labelNames = Object.keys(this.defaultLabels) }) {\n    if (this.counters[name]) return this.counters[name].triggerFn\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    const triggerFn = (data = {}, value = 1) => {\n      c.inc({ ...this.defaultLabels, ...data }, value)\n    }\n\n    this.counters[name].triggerFn = triggerFn\n    return triggerFn\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   * Express middleware to count HTTP requests.\n   * Increments the `app_http_requests_total` counter.\n   */\n  countHttpRequestMiddleware = (req, res, next) => {\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        ''\n\n      this.counters?.app_http_requests_total?.triggerFn({\n        method: req.method,\n        route,\n        status_code: res.statusCode,\n        appId,\n        databaseId,\n        duration: Date.now() - start,\n        requestSize: req.headers['content-length']\n          ? parseInt(req.headers['content-length'], 10)\n          : 0,\n      })\n    })\n\n    next()\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            return\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      await this.gatewayPush({\n        jobName: this.appName,\n        groupings: { process_type: this.processType, instance: this.dynoId },\n      })\n\n      Object.values(this.counters).forEach(counter => counter.reset())\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  /**\n   * Start periodic metrics collection + push.\n   *\n   * @param {number} [interval] Interval in seconds\n   * @param {function(): void|Promise<void>} [customPushMetics]\n   *        Optional custom push function. If provided, Prometheus push is skipped.\n   */\n  startPush = (interval = this.intervalSec, customPushMetics = () => {}) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n      return\n    }\n\n    if (this.startupValidation && !this.startupValidation()) {\n      return\n    }\n\n    if (customPushMetics) {\n      setInterval(customPushMetics, interval * 1000)\n    } else {\n      setInterval(() => {\n        this.pushMetrics().catch(err => {\n          console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n        })\n      }, interval * 1000)\n    }\n\n    console.warn(\n      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s)`\n    )\n  }\n\n  cleanup = async () => {\n    if (this.enabled) {\n      await this.gatewayDelete()\n    }\n    process.exit(0)\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} removeAllJobs If true, performs cleanup; otherwise does nothing\n   * @returns {Promise<void>}\n   * @private\n   */\n  _clearOldWorkers = async removeAllJobs => {\n    if (!removeAllJobs) return\n\n    try {\n      const url = `${this.pushgatewayUrl}/metrics`\n      const res = await fetch(url, {\n        headers: {\n          Authorization: `Basic ${this.authToken}`,\n          Accept: 'text/plain',\n        },\n      })\n\n      if (!res.ok) {\n        console.error(\n          `${this.prefixLogs} Failed to fetch metrics: ${res.status}`\n        )\n        return\n      }\n\n      const text = await res.text()\n\n      const regex = new RegExp(\n        `(?:instance=\"([^\"]+)\".*job=\"${this.appName}\"|job=\"${this.appName}\".*instance=\"([^\"]+)\")`,\n        'g'\n      )\n      const instances = new Set()\n      let match\n      // eslint-disable-next-line no-cond-assign\n      while ((match = regex.exec(text)) !== null) {\n        const instance = match[1] || match[2]\n        if (instance && instance !== this.dynoId) instances.add(instance)\n      }\n\n      if (instances.size === 0) {\n        console.log(`${this.prefixLogs} No old dynos to delete.`)\n        return\n      }\n\n      for (const instance of instances) {\n        await this.gatewayDelete({\n          groupings: {\n            instance,\n          },\n        })\n        console.log(\n          `${this.prefixLogs} Deleted metrics for old dyno: ${instance}`\n        )\n      }\n\n      console.log(\n        `${this.prefixLogs} Cleared all old instances for job ${this.appName}`\n      )\n    } catch (err) {\n      console.error(`${this.prefixLogs} Error deleting old metrics:`, err)\n    }\n  }\n\n  /**\n   * Delete metrics for this job/instance from PushGateway.\n   *\n   * @param {Object} [params]\n   * @param {string} [params.jobName] Job name (defaults to appName)\n   * @param {Object} [params.groupings] Grouping labels\n   * @param {string} [params.groupings.process_type] Process type label\n   * @param {string} [params.groupings.instance] Instance/dyno ID\n   * @returns {Promise<void>}\n   */\n  gatewayDelete = async (params = {}) => {\n    return this.gateway.delete({\n      jobName: params.jobName || this.appName,\n      groupings: {\n        process_type: params.groupings?.process_type || this.processType,\n        instance: params.groupings?.instance || this.dynoId,\n      },\n    })\n  }\n\n  /**\n   * Push metrics to PushGateway.\n   *\n   * @param {object} [params]\n   * @param {string} [params.jobName]\n   * @param {object} [params.groupings]\n   * @returns {Promise<void>}\n   */\n  gatewayPush = async (params = {}) => {\n    return this.gateway.push({\n      jobName: params.jobName || this.appName,\n      groupings: {\n        process_type: params.groupings?.process_type || this.processType,\n        instance: params.groupings?.instance || this.dynoId,\n      },\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    process.on('SIGINT', this.cleanup)\n    process.on('SIGTERM', this.cleanup)\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\nmodule.exports = { MetricsClient }\n"],"mappings":"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","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adalo/metrics",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "Reusable metrics utilities for Node.js and Laravel apps",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/metricsClient.js

@@ -20,6 +20,8 @@ class MetricsClient {
    * @param {string} [config.pushgatewayPassword] PushGateway password
    * @param {number} [config.intervalSec] Interval in seconds for pushing metrics
    * @param {boolean} [config.removeAllJobs] Enable to clear all jobs at startup
+   * @param {boolean} [config.scripDefaultMetrics] Enable to scip default metrics creation
+   * @param {function} [config.startupValidation] Add to validate on start push.
    */
   constructor(config = {}) {
     this.appName =
@@ -44,6 +46,7 @@ class MetricsClient {
       config.intervalSec ||
       parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||
       15
+    this.startupValidation = config.startupValidation
 
     this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`
 
@@ -73,55 +76,62 @@ class MetricsClient {
 
     /** @type {Object<string, function(): number | Promise<number>>} */
     this.gaugeUpdaters = {}
+    this.customsMetricsTracking = {}
     this._lastUsageMicros = 0
     this._lastCheckTime = Date.now()
     this._clearOldWorkers(config.removeAllJobs).then(_ => {
-      this._initDefaultMetrics()
+      if (config.scripDefaultMetrics) {
+        this._initDefaultMetrics()
+      }
       this._setCleanupHandlers()
     })
   }
 
   /**
-   * Register default gauges and counters.
+   * Register all built-in default Gauges and Counters.
    * @private
    */
   _initDefaultMetrics = () => {
-    this.createGauge(
-      'app_process_cpu_usage_percent',
-      'Current CPU usage of the Node.js process in percent',
-      this.getCpuUsagePercent
-    )
-    this.createGauge(
-      'app_available_cpu_count',
-      'How many CPU cores are available to this process',
-      this.getAvailableCPUs
-    )
-    this.createGauge(
-      'app_container_memory_usage_bytes',
-      'Current container RAM usage from cgroup',
-      this.getContainerMemoryUsage
-    )
-    this.createGauge(
-      'app_event_loop_lag_ms',
-      'Estimated event loop lag in milliseconds',
-      this.measureLag
-    )
-    this.createGauge(
-      'app_container_memory_limit_bytes',
-      'Max RAM available to container from cgroup (memory.max)',
-      this.getContainerMemoryLimit
-    )
-    this.createGauge(
-      'app_uptime_seconds',
-      'How long the process has been running',
-      process.uptime
-    )
+    this.createGauge({
+      name: 'app_process_cpu_usage_percent',
+      help: 'Current CPU usage of the Node.js process in percent',
+      updateFn: this.getCpuUsagePercent,
+    })
+
+    this.createGauge({
+      name: 'app_available_cpu_count',
+      help: 'How many CPU cores are available to this process',
+      updateFn: this.getAvailableCPUs,
+    })
+
+    this.createGauge({
+      name: 'app_container_memory_usage_bytes',
+      help: 'Current container RAM usage from cgroup',
+      updateFn: this.getContainerMemoryUsage,
+    })
+
+    this.createGauge({
+      name: 'app_event_loop_lag_ms',
+      help: 'Estimated event loop lag in milliseconds',
+      updateFn: this.measureLag,
+    })
+
+    this.createGauge({
+      name: 'app_container_memory_limit_bytes',
+      help: 'Max RAM available to container from cgroup (memory.max)',
+      updateFn: this.getContainerMemoryLimit,
+    })
+
+    this.createGauge({
+      name: 'app_uptime_seconds',
+      help: 'How long the process has been running',
+      updateFn: process.uptime,
+    })
 
-    this.createCounter(
-      'app_http_requests_total',
-      'Total number of HTTP requests handled by this process',
-      [
-        ...Object.keys(this.defaultLabels),
+    this.createCounter({
+      name: 'app_http_requests_total',
+      help: 'Total number of HTTP requests handled by this process',
+      labelNames: this.withDefaultLabels([
         'method',
         'route',
         'appId',
@@ -129,8 +139,8 @@ class MetricsClient {
         'duration',
         'requestSize',
         'status_code',
-      ]
-    )
+      ]),
+    })
   }
 
   /**
@@ -141,12 +151,12 @@ class MetricsClient {
    * @param {string[]} [labelNames]
    * @returns {client.Gauge}
    */
-  createGauge = (
+  createGauge = ({
     name,
     help,
     updateFn,
-    labelNames = Object.keys(this.defaultLabels)
-  ) => {
+    labelNames = Object.keys(this.defaultLabels),
+  }) => {
     if (this.gauges[name]) return this.gauges[name]
 
     const g = new client.Gauge({
@@ -157,20 +167,26 @@ class MetricsClient {
     })
     this.gauges[name] = g
 
-    if (typeof updateFn === 'function') this.gaugeUpdaters[name] = updateFn
+    if (updateFn && typeof updateFn === 'function')
+      this.gaugeUpdaters[name] = updateFn
 
     return g
   }
 
   /**
-   * Create a counter metric.
-   * Returns a trigger function to increment the counter manually.
-   * @param {string} name
-   * @param {string} help
-   * @param {string[]} [labelNames]
-   * @returns {function(data?: object, value?: number): void} triggerFn
+   * Create a Prometheus Counter metric.
+   *
+   * @param {object} params
+   * @param {string} params.name Metric name
+   * @param {string} params.help Metric description
+   * @param {string[]} [params.labelNames]
+   *        Optional list of label names. Defaults to this.defaultLabels keys.
+   *
+   * @returns {function(data?: object, value?: number): void}
+   *          A trigger function to increment the counter:
+   *          triggerFn(labels?, incrementValue?)
    */
-  createCounter(name, help, labelNames = Object.keys(this.defaultLabels)) {
+  createCounter({ name, help, labelNames = Object.keys(this.defaultLabels) }) {
     if (this.counters[name]) return this.counters[name].triggerFn
 
     const c = new client.Counter({
@@ -326,6 +342,9 @@ class MetricsClient {
     try {
       for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {
         try {
+          if (!updateFn) {
+            return
+          }
           const result = updateFn()
           const val = result instanceof Promise ? await result : result
           if (val !== undefined) this.gauges[name].set(this.defaultLabels, val)
@@ -337,7 +356,7 @@ class MetricsClient {
         }
       }
 
-      await this.gateway.push({
+      await this.gatewayPush({
         jobName: this.appName,
         groupings: { process_type: this.processType, instance: this.dynoId },
       })
@@ -357,36 +376,54 @@ class MetricsClient {
   }
 
   /**
-   * Start automatic periodic push of metrics.
+   * Start periodic metrics collection + push.
+   *
    * @param {number} [interval] Interval in seconds
+   * @param {function(): void|Promise<void>} [customPushMetics]
+   *        Optional custom push function. If provided, Prometheus push is skipped.
    */
-  startPush = (interval = this.intervalSec) => {
+  startPush = (interval = this.intervalSec, customPushMetics = () => {}) => {
     if (!this.enabled) {
       console.warn(`${this.prefixLogs} Metrics disabled`)
+      return
     }
 
-    setInterval(() => {
-      this.pushMetrics().catch(err => {
-        console.error(`${this.prefixLogs} Failed to push metrics:`, err)
-      })
-    }, interval * 1000)
+    if (this.startupValidation && !this.startupValidation()) {
+      return
+    }
 
-    console.warn(`${this.prefixLogs} Metrics collection started.`)
+    if (customPushMetics) {
+      setInterval(customPushMetics, interval * 1000)
+    } else {
+      setInterval(() => {
+        this.pushMetrics().catch(err => {
+          console.error(`${this.prefixLogs} Failed to push metrics:`, err)
+        })
+      }, interval * 1000)
+    }
+
+    console.warn(
+      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s)`
+    )
   }
 
   cleanup = async () => {
     if (this.enabled) {
-      await this.gateway.delete({
-        jobName: this.appName,
-        groupings: {
-          process_type: this.processType,
-          instance: this.dynoId,
-        },
-      })
+      await this.gatewayDelete()
     }
     process.exit(0)
   }
 
+  /**
+   * Remove old/stale dyno/instance metrics from PushGateway.
+   *
+   * Compares existing PushGateway metrics for this job and deletes any instances
+   * that do not match the current dynoId.
+   *
+   * @param {boolean} removeAllJobs If true, performs cleanup; otherwise does nothing
+   * @returns {Promise<void>}
+   * @private
+   */
   _clearOldWorkers = async removeAllJobs => {
     if (!removeAllJobs) return
 
@@ -426,10 +463,8 @@ class MetricsClient {
       }
 
       for (const instance of instances) {
-        await this.gateway.delete({
-          jobName: this.appName,
+        await this.gatewayDelete({
           groupings: {
-            process_type: this.processType,
             instance,
           },
         })
@@ -446,10 +481,77 @@ class MetricsClient {
     }
   }
 
+  /**
+   * Delete metrics for this job/instance from PushGateway.
+   *
+   * @param {Object} [params]
+   * @param {string} [params.jobName] Job name (defaults to appName)
+   * @param {Object} [params.groupings] Grouping labels
+   * @param {string} [params.groupings.process_type] Process type label
+   * @param {string} [params.groupings.instance] Instance/dyno ID
+   * @returns {Promise<void>}
+   */
+  gatewayDelete = async (params = {}) => {
+    return this.gateway.delete({
+      jobName: params.jobName || this.appName,
+      groupings: {
+        process_type: params.groupings?.process_type || this.processType,
+        instance: params.groupings?.instance || this.dynoId,
+      },
+    })
+  }
+
+  /**
+   * Push metrics to PushGateway.
+   *
+   * @param {object} [params]
+   * @param {string} [params.jobName]
+   * @param {object} [params.groupings]
+   * @returns {Promise<void>}
+   */
+  gatewayPush = async (params = {}) => {
+    return this.gateway.push({
+      jobName: params.jobName || this.appName,
+      groupings: {
+        process_type: params.groupings?.process_type || this.processType,
+        instance: params.groupings?.instance || this.dynoId,
+      },
+    })
+  }
+
+  /**
+   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)
+   * with custom label names.
+   *
+   * @param {string[]} labels Additional label names
+   * @returns {string[]} Combined label names
+   */
+  withDefaultLabels = (labels = []) => {
+    return [...Object.keys(this.defaultLabels), labels]
+  }
+
+  getDefaultLabels = (labels = []) => {
+    return this.defaultLabels
+  }
+
   _setCleanupHandlers = () => {
     process.on('SIGINT', this.cleanup)
     process.on('SIGTERM', this.cleanup)
   }
+
+  // GETTERS
+
+  get metricsEnabled() {
+    return this.enabled
+  }
+
+  get metricsLogValues() {
+    return this.logValues
+  }
+
+  get registry() {
+    return this.registry
+  }
 }
 
 module.exports = { MetricsClient }