@twin.org/node-core 0.9.2-next.12 → 0.9.2-next.14

package/dist/types/models/IEngineEnvironmentVariables.d.ts

@@ -508,6 +508,19 @@ export interface IEngineEnvironmentVariables {
      * Maximum number of values retained per telemetry metric (count-based history cap). Defaults to 1440.
      */
     telemetryMetricsProducerMaxHistory?: string;
+    /**
+     * The batch size for the telemetry connector, set to 1 to disable size-based flushing.
+     */
+    telemetryBatchSize?: string;
+    /**
+     * The batch flush interval in seconds for the telemetry connector, how often to flush when using batching, defaults to 5 seconds.
+     */
+    telemetryBatchFlushInterval?: string;
+    /**
+     * The maximum number of metric values to hold in the write-ahead cache for the telemetry connector. Set to 0 for unlimited.
+     * @default 1000
+     */
+    telemetryMaxCacheSize?: string;
     /**
      * The mutex timeout in milliseconds for the telemetry connector.
      */

package/dist/types/models/IEngineServerEnvironmentVariables.d.ts

@@ -66,4 +66,8 @@ export interface IEngineServerEnvironmentVariables {
      * Comma-separated list of URL path prefixes excluded from metrics collection.
      */
     routeMetricsExcludePaths?: string;
+    /**
+     * Comma-separated list of URL path prefixes excluded from tracing.
+     */
+    routeTracingExcludePaths?: string;
 }

package/docs/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.9.2-next.14](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.2-next.13...node-core-v0.9.2-next.14) (2026-08-19)
+
+
+### Features
+
+* telemetry batching ([#347](https://github.com/iotaledger/twin-node/issues/347)) ([5d5b0a9](https://github.com/iotaledger/twin-node/commit/5d5b0a91396298fe774ae26193b0595875cd118a))
+
+## [0.9.2-next.13](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.2-next.12...node-core-v0.9.2-next.13) (2026-08-18)
+
+
+### Features
+
+* add tracing ([#344](https://github.com/iotaledger/twin-node/issues/344)) ([4fa71cd](https://github.com/iotaledger/twin-node/commit/4fa71cd0eafd7d708df15c8f0a85323fecd05561))
+
 ## [0.9.2-next.12](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.2-next.11...node-core-v0.9.2-next.12) (2026-08-17)
 
 

package/docs/reference/functions/isTracingRequired.md

@@ -0,0 +1,20 @@
+# Function: isTracingRequired()
+
+> **isTracingRequired**(`envVars`): `boolean`
+
+Checks if the tracing subsystem is required.
+Returns true when any component that depends on the tracing subsystem is enabled.
+
+## Parameters
+
+### envVars
+
+[`IEngineEnvironmentVariables`](../interfaces/IEngineEnvironmentVariables.md)
+
+The environment variables.
+
+## Returns
+
+`boolean`
+
+True if tracing is enabled.

package/docs/reference/index.md

@@ -49,6 +49,7 @@
 - [isTaskSchedulerRequired](functions/isTaskSchedulerRequired.md)
 - [isAutomationRequired](functions/isAutomationRequired.md)
 - [isTelemetryRequired](functions/isTelemetryRequired.md)
+- [isTracingRequired](functions/isTracingRequired.md)
 - [buildEngineServerConfiguration](functions/buildEngineServerConfiguration.md)
 - [isAuthEntityStorageRequired](functions/isAuthEntityStorageRequired.md)
 - [extensionsConfiguration](functions/extensionsConfiguration.md)

package/docs/reference/interfaces/IEngineEnvironmentVariables.md

@@ -1023,6 +1023,36 @@ Maximum number of values retained per telemetry metric (count-based history cap)
 
 ***
 
+### telemetryBatchSize? {#telemetrybatchsize}
+
+> `optional` **telemetryBatchSize?**: `string`
+
+The batch size for the telemetry connector, set to 1 to disable size-based flushing.
+
+***
+
+### telemetryBatchFlushInterval? {#telemetrybatchflushinterval}
+
+> `optional` **telemetryBatchFlushInterval?**: `string`
+
+The batch flush interval in seconds for the telemetry connector, how often to flush when using batching, defaults to 5 seconds.
+
+***
+
+### telemetryMaxCacheSize? {#telemetrymaxcachesize}
+
+> `optional` **telemetryMaxCacheSize?**: `string`
+
+The maximum number of metric values to hold in the write-ahead cache for the telemetry connector. Set to 0 for unlimited.
+
+#### Default
+
+```ts
+1000
+```
+
+***
+
 ### telemetryMutexTimeout? {#telemetrymutextimeout}
 
 > `optional` **telemetryMutexTimeout?**: `string`

package/docs/reference/interfaces/IEngineServerEnvironmentVariables.md

@@ -129,3 +129,11 @@ List of properties to obfuscate in the REST logging output, comma separated.
 > `optional` **routeMetricsExcludePaths?**: `string`
 
 Comma-separated list of URL path prefixes excluded from metrics collection.
+
+***
+
+### routeTracingExcludePaths? {#routetracingexcludepaths}
+
+> `optional` **routeTracingExcludePaths?**: `string`
+
+Comma-separated list of URL path prefixes excluded from tracing.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node-core",
-	"version": "0.9.2-next.12",
+	"version": "0.9.2-next.14",
 	"description": "TWIN Node Core for serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -42,6 +42,7 @@
 		"@twin.org/standards-w3c-odrl": "next",
 		"@twin.org/telemetry-connector-opentelemetry": "next",
 		"@twin.org/tracing-connector-opentelemetry": "next",
+		"@twin.org/tracing-models": "next",
 		"@twin.org/vault-models": "next",
 		"@twin.org/wallet-connector-entity-storage": "next",
 		"@twin.org/wallet-models": "next",