@platformatic/runtime 3.29.1 → 3.30.0

package/lib/runtime.js

@@ -710,6 +710,56 @@ export class Runtime extends EventEmitter {
     }
   }
 
+  /**
+   * Updates the metrics configuration at runtime without restarting the runtime or workers.
+   *
+   * This method allows you to:
+   * - Enable or disable metrics collection
+   * - Change Prometheus server settings (port, endpoint, authentication)
+   * - Update custom labels for metrics
+   *
+   * @example
+   * // Enable metrics with custom port
+   * await runtime.updateMetricsConfig({
+   *   enabled: true,
+   *   port: 9091,
+   *   labels: { environment: 'production' }
+   * })
+   *
+   * // Disable metrics
+   * await runtime.updateMetricsConfig({ enabled: false })
+   */
+  async updateMetricsConfig (metricsConfig) {
+    if (this.#prometheusServer) {
+      await this.#prometheusServer.close()
+      this.#prometheusServer = null
+    }
+
+    this.#config.metrics = metricsConfig
+    this.#metricsLabelName = metricsConfig?.applicationLabel || 'applicationId'
+
+    if (metricsConfig.enabled !== false) {
+      this.#prometheusServer = await startPrometheusServer(this, metricsConfig)
+    }
+
+    const promises = []
+    for (const worker of this.#workers.values()) {
+      if (worker[kWorkerStatus] === 'started') {
+        promises.push(sendViaITC(worker, 'updateMetricsConfig', metricsConfig))
+      }
+    }
+
+    const results = await Promise.allSettled(promises)
+    for (const result of results) {
+      if (result.status === 'rejected') {
+        this.logger.error({ err: result.reason }, 'Cannot update metrics config on worker')
+      }
+    }
+
+    this.logger.info({ metricsConfig }, 'Metrics configuration updated')
+    return { success: true, config: metricsConfig }
+  }
+
   // TODO: Remove in next major version
   startCollectingMetrics () {
     this.logger.warn(

package/lib/worker/controller.js

@@ -92,6 +92,13 @@ export class Controller extends EventEmitter {
     }
   }
 
+  async updateMetricsConfig (metricsConfig) {
+    this.#context.metricsConfig = metricsConfig
+    if (this.capability && typeof this.capability.updateMetricsConfig === 'function') {
+      await this.capability.updateMetricsConfig(metricsConfig)
+    }
+  }
+
   // Note: capability's init() is executed within start
   async init () {
     try {

package/lib/worker/itc.js

@@ -2,8 +2,8 @@ import { ensureLoggableError, executeInParallel, executeWithTimeout, kTimeout }
 import { ITC } from '@platformatic/itc'
 import { Unpromise } from '@watchable/unpromise'
 import { once } from 'node:events'
-import repl from 'node:repl'
 import { Duplex } from 'node:stream'
+import { createRequire } from 'node:module'
 import { parentPort, workerData } from 'node:worker_threads'
 import {
   ApplicationExitedError,
@@ -176,6 +176,13 @@ export function setupITC (controller, application, dispatcher, sharedContext) {
         await updateUndiciInterceptors(undiciConfig)
       },
 
+      async updateMetricsConfig (metricsConfig) {
+        if (controller && typeof controller.updateMetricsConfig === 'function') {
+          await controller.updateMetricsConfig(metricsConfig)
+        }
+        return { success: true }
+      },
+
       async updateWorkersCount (data) {
         const { workers } = data
         workerData.applicationConfig.workers = workers
@@ -266,6 +273,14 @@ export function setupITC (controller, application, dispatcher, sharedContext) {
       },
 
       startRepl (port) {
+        // We are loading the repl module dynamically here to avoid loading it
+        // when not needed (since it pulls in domain, which is quite expensive
+        // as it monkey patches EventEmitter).
+        // We must use local require() instead of import
+        // because dynamic import() is async and the
+        // startRepl handler is sync.
+        const repl = createRequire(import.meta.url)('node:repl')
+
         // Create a duplex stream that wraps the MessagePort
         const replStream = new Duplex({
           read () {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/runtime",
-  "version": "3.29.1",
+  "version": "3.30.0",
   "description": "",
   "main": "index.js",
   "type": "module",
@@ -35,14 +35,14 @@
     "typescript": "^5.5.4",
     "undici-oidc-interceptor": "^0.5.0",
     "why-is-node-running": "^2.2.2",
-    "@platformatic/composer": "3.29.1",
-    "@platformatic/db": "3.29.1",
-    "@platformatic/node": "3.29.1",
-    "@platformatic/gateway": "3.29.1",
-    "@platformatic/service": "3.29.1",
-    "@platformatic/sql-graphql": "3.29.1",
-    "@platformatic/sql-mapper": "3.29.1",
-    "@platformatic/wattpm-pprof-capture": "3.29.1"
+    "@platformatic/composer": "3.30.0",
+    "@platformatic/db": "3.30.0",
+    "@platformatic/gateway": "3.30.0",
+    "@platformatic/node": "3.30.0",
+    "@platformatic/sql-graphql": "3.30.0",
+    "@platformatic/sql-mapper": "3.30.0",
+    "@platformatic/service": "3.30.0",
+    "@platformatic/wattpm-pprof-capture": "3.30.0"
   },
   "dependencies": {
     "@fastify/accepts": "^5.0.0",
@@ -58,7 +58,7 @@
     "cron": "^4.1.0",
     "debounce": "^2.0.0",
     "fastest-levenshtein": "^1.0.16",
-    "fastify": "^5.0.0",
+    "fastify": "^5.7.0",
     "graphql": "^16.8.1",
     "help-me": "^5.0.0",
     "minimist": "^1.2.8",
@@ -71,12 +71,12 @@
     "undici": "^7.0.0",
     "undici-thread-interceptor": "^1.0.0",
     "ws": "^8.16.0",
-    "@platformatic/basic": "3.29.1",
-    "@platformatic/generators": "3.29.1",
-    "@platformatic/itc": "3.29.1",
-    "@platformatic/foundation": "3.29.1",
-    "@platformatic/metrics": "3.29.1",
-    "@platformatic/telemetry": "3.29.1"
+    "@platformatic/foundation": "3.30.0",
+    "@platformatic/basic": "3.30.0",
+    "@platformatic/generators": "3.30.0",
+    "@platformatic/itc": "3.30.0",
+    "@platformatic/telemetry": "3.30.0",
+    "@platformatic/metrics": "3.30.0"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.29.1.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.30.0.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic Runtime Config",
   "type": "object",