iobroker.data-solectrus 0.2.9 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.3.0 - 2026-02-03
+
+### BREAKING CHANGES
+
+- **Diagnostics state reorganization**: States moved to hierarchical structure for better organization
+  - `info.itemsConfigured` → `info.diagnostics.itemsTotal`
+  - `info.itemsEnabled` → `info.itemsActive`
+  - `info.evalTimeMs` → `info.lastRunMs`
+  - `info.timeBudgetMs` → `info.diagnostics.evalBudgetMs`
+  - `info.skippedItems` → `info.diagnostics.evalSkipped`
+  - Old flat timing states → `info.diagnostics.timing.*`
+- **Note**: Existing visualizations and scripts need to be updated to use new state paths
+
+### Added
+
+- New hierarchical state structure with `info.diagnostics.*` and `info.diagnostics.timing.*` channels
+- Enhanced timing diagnostics:
+  - Active vs sleeping source detection (30s threshold)
+  - `info.diagnostics.timing.sourcesActive` and `sourcesSleeping`
+  - Newest/oldest source tracking with IDs and age metrics
+  - `info.diagnostics.timing.newestAgeMs`, `newestId`, `oldestAgeMs`, `oldestId`
+  - Separate gap calculations for all sources vs active sources only
+  - `info.diagnostics.timing.gapActiveMs` and `gapActiveOk`
+
+### Changed
+
+- Improved state organization: all timing-related states now grouped under `info.diagnostics.timing.*`
+- Better state naming for clarity (e.g., `lastRunMs` instead of `evalTimeMs`)
+
 ## 0.2.9 - 2026-02-03
 
 ### Added

package/README.md

@@ -71,18 +71,30 @@ Direktlinks (Auswahl):
 Unter `data-solectrus.0.info.*` werden Status/Diagnosewerte gepflegt:
 
 - `info.status`: `starting`, `ok`, `no_items_enabled`
-- `info.itemsConfigured`, `info.itemsEnabled`
-- `info.lastError`
-- `info.lastRun`, `info.evalTimeMs`
-- `info.timeBudgetMs`, `info.skippedItems`
-
-Timing/Sync-Diagnose (hilft bei kurzzeitig „unplausiblen“ Kombinationen, wenn Quellen zeitversetzt updaten):
-
-- `info.inputTsGapMs`: Differenz zwischen ältestem und neuestem Input-Timestamp (ms) der im Tick genutzten Quellen
-- `info.inputTsGapOk`: `true/false` basierend auf einem konservativen Threshold
-- `info.inputTsGapThresholdMs`: verwendeter Threshold (ms)
-- `info.inputTsSources`: Anzahl Inputs mit Timestamp
-- `info.inputTsMissing`: Anzahl Inputs ohne Timestamp
+- `info.itemsActive`: Anzahl aktiver Items
+- `info.lastError`: Letzter Fehler
+- `info.lastRun`: Zeitstempel des letzten Ticks (ISO)
+- `info.lastRunMs`: Dauer des letzten Ticks (ms)
+
+Unter `info.diagnostics.*` liegen erweiterte Diagnose-Informationen:
+
+- `info.diagnostics.itemsTotal`: Gesamtzahl konfigurierter Items
+- `info.diagnostics.evalBudgetMs`: Verfügbares Zeitbudget pro Tick (ms)
+- `info.diagnostics.evalSkipped`: Anzahl übersprungener Items (bei Budget-Überschreitung)
+
+Unter `info.diagnostics.timing.*` finden sich detaillierte Timing-Analysen (hilft bei kurzzeitig „unplausiblen" Kombinationen, wenn Quellen zeitversetzt updaten):
+
+- `info.diagnostics.timing.gapMs`: Zeitdifferenz zwischen ältestem und neuestem Source-Timestamp (alle Quellen)
+- `info.diagnostics.timing.gapOk`: `true/false` basierend auf Threshold
+- `info.diagnostics.timing.gapActiveMs`: Zeitdifferenz nur für aktive Quellen (< 30s alt)
+- `info.diagnostics.timing.gapActiveOk`: `true/false` für aktive Quellen
+- `info.diagnostics.timing.newestAgeMs`: Alter der neuesten Quelle (ms)
+- `info.diagnostics.timing.newestId`: State-ID der neuesten Quelle
+- `info.diagnostics.timing.oldestAgeMs`: Alter der ältesten Quelle (ms)
+- `info.diagnostics.timing.oldestId`: State-ID der ältesten Quelle
+- `info.diagnostics.timing.sources`: Anzahl Quellen mit Timestamp
+- `info.diagnostics.timing.sourcesActive`: Anzahl aktiver Quellen (< 30s alt)
+- `info.diagnostics.timing.sourcesSleeping`: Anzahl inaktiver Quellen (≥ 30s alt)
 
 Zusätzlich gibt es per Item Diagnose-States unter `data-solectrus.0.items.<outputId>.*`:
 

package/io-package.json

@@ -1,7 +1,7 @@
 {
   "common": {
     "name": "data-solectrus",
-    "version": "0.2.9",
+    "version": "0.3.0",
     "title": "Data-SOLECTRUS",
     "icon": "data-solectrus.png",
     "extIcon": "https://raw.githubusercontent.com/Felliglanz/ioBroker.data-solectrus/main/admin/data-solectrus.png",
@@ -30,6 +30,10 @@
     "license": "MIT",
     "readme": "https://github.com/Felliglanz/ioBroker.data-solectrus/blob/main/README.md",
     "news": {
+      "0.3.0": {
+        "en": "BREAKING: Restructured diagnostics states with hierarchical organization. Enhanced timing analytics.",
+        "de": "BREAKING: Diagnose-States neu strukturiert mit hierarchischer Organisation. Erweiterte Timing-Analysen."
+      },
       "0.2.9": {
         "en": "Added package metadata (repository, bugs, homepage) and .npmignore",
         "de": "Package-Metadaten (repository, bugs, homepage) und .npmignore hinzugefügt"

package/lib/services/stateRegistry.js

@@ -145,6 +145,7 @@ async function ensureItemInfoStatesForCompiled(adapter, compiled) {
 }
 
 async function createInfoStates(adapter) {
+	// === info.* (top-level status states) ===
 	await adapter.setObjectNotExistsAsync('info.status', {
 		type: 'state',
 		common: {
@@ -157,10 +158,10 @@ async function createInfoStates(adapter) {
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.itemsConfigured', {
+	await adapter.setObjectNotExistsAsync('info.itemsActive', {
 		type: 'state',
 		common: {
-			name: 'Configured items',
+			name: 'Active items',
 			type: 'number',
 			role: 'value',
 			read: true,
@@ -169,84 +170,123 @@ async function createInfoStates(adapter) {
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.itemsEnabled', {
+	await adapter.setObjectNotExistsAsync('info.lastError', {
 		type: 'state',
 		common: {
-			name: 'Enabled items',
-			type: 'number',
-			role: 'value',
+			name: 'Last error',
+			type: 'string',
+			role: 'text',
 			read: true,
 			write: false,
 		},
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.lastError', {
+	await adapter.setObjectNotExistsAsync('info.lastRun', {
 		type: 'state',
 		common: {
-			name: 'Last Error',
+			name: 'Last run',
 			type: 'string',
-			role: 'text',
+			role: 'date',
 			read: true,
 			write: false,
 		},
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.lastRun', {
+	await adapter.setObjectNotExistsAsync('info.lastRunMs', {
 		type: 'state',
 		common: {
-			name: 'Last Run',
-			type: 'string',
-			role: 'date',
+			name: 'Last run duration',
+			type: 'number',
+			role: 'value',
+			unit: 'ms',
 			read: true,
 			write: false,
 		},
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.evalTimeMs', {
+	// === info.diagnostics.* (diagnostics channel) ===
+	await adapter.setObjectNotExistsAsync('info.diagnostics', {
+		type: 'channel',
+		common: { name: 'diagnostics' },
+		native: {},
+	});
+
+	await adapter.setObjectNotExistsAsync('info.diagnostics.evalBudgetMs', {
 		type: 'state',
 		common: {
-			name: 'Evaluation time (ms)',
+			name: 'Evaluation budget',
 			type: 'number',
 			role: 'value',
+			unit: 'ms',
 			read: true,
 			write: false,
 		},
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.timeBudgetMs', {
+	await adapter.setObjectNotExistsAsync('info.diagnostics.evalSkipped', {
 		type: 'state',
 		common: {
-			name: 'Tick time budget (ms)',
+			name: 'Skipped items (last tick)',
 			type: 'number',
 			role: 'value',
-			unit: 'ms',
 			read: true,
 			write: false,
 		},
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.skippedItems', {
+	await adapter.setObjectNotExistsAsync('info.diagnostics.itemsTotal', {
 		type: 'state',
 		common: {
-			name: 'Skipped items (last tick)',
+			name: 'Total configured items',
+			type: 'number',
+			role: 'value',
+			read: true,
+			write: false,
+		},
+		native: {},
+	});
+
+	// === info.diagnostics.timing.* (timing sub-channel) ===
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing', {
+		type: 'channel',
+		common: { name: 'timing' },
+		native: {},
+	});
+
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.gapMs', {
+		type: 'state',
+		common: {
+			name: 'Timestamp gap (all sources)',
 			type: 'number',
 			role: 'value',
+			unit: 'ms',
+			read: true,
+			write: false,
+		},
+		native: {},
+	});
+
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.gapOk', {
+		type: 'state',
+		common: {
+			name: 'Timestamp gap OK',
+			type: 'boolean',
+			role: 'indicator',
 			read: true,
 			write: false,
 		},
 		native: {},
 	});
 
-	// Input timestamp skew diagnostics (helps spot timing/cache issues when combining many sources).
-	await adapter.setObjectNotExistsAsync('info.inputTsGapMs', {
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.gapActiveMs', {
 		type: 'state',
 		common: {
-			name: 'Input timestamp gap (ms)',
+			name: 'Timestamp gap (active sources)',
 			type: 'number',
 			role: 'value',
 			unit: 'ms',
@@ -256,10 +296,10 @@ async function createInfoStates(adapter) {
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.inputTsGapOk', {
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.gapActiveOk', {
 		type: 'state',
 		common: {
-			name: 'Input timestamp gap OK',
+			name: 'Timestamp gap (active) OK',
 			type: 'boolean',
 			role: 'indicator',
 			read: true,
@@ -268,10 +308,35 @@ async function createInfoStates(adapter) {
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.inputTsGapThresholdMs', {
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.newestAgeMs', {
+		type: 'state',
+		common: {
+			name: 'Newest source age',
+			type: 'number',
+			role: 'value',
+			unit: 'ms',
+			read: true,
+			write: false,
+		},
+		native: {},
+	});
+
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.newestId', {
+		type: 'state',
+		common: {
+			name: 'Newest source ID',
+			type: 'string',
+			role: 'text',
+			read: true,
+			write: false,
+		},
+		native: {},
+	});
+
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.oldestAgeMs', {
 		type: 'state',
 		common: {
-			name: 'Input timestamp gap OK threshold (ms)',
+			name: 'Oldest source age',
 			type: 'number',
 			role: 'value',
 			unit: 'ms',
@@ -281,10 +346,34 @@ async function createInfoStates(adapter) {
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.inputTsSources', {
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.oldestId', {
+		type: 'state',
+		common: {
+			name: 'Oldest source ID',
+			type: 'string',
+			role: 'text',
+			read: true,
+			write: false,
+		},
+		native: {},
+	});
+
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.sources', {
+		type: 'state',
+		common: {
+			name: 'Sources with timestamps',
+			type: 'number',
+			role: 'value',
+			read: true,
+			write: false,
+		},
+		native: {},
+	});
+
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.sourcesActive', {
 		type: 'state',
 		common: {
-			name: 'Inputs with timestamps (last tick)',
+			name: 'Active sources',
 			type: 'number',
 			role: 'value',
 			read: true,
@@ -293,10 +382,10 @@ async function createInfoStates(adapter) {
 		native: {},
 	});
 
-	await adapter.setObjectNotExistsAsync('info.inputTsMissing', {
+	await adapter.setObjectNotExistsAsync('info.diagnostics.timing.sourcesSleeping', {
 		type: 'state',
 		common: {
-			name: 'Inputs missing timestamps (last tick)',
+			name: 'Sleeping sources',
 			type: 'number',
 			role: 'value',
 			read: true,
@@ -305,19 +394,26 @@ async function createInfoStates(adapter) {
 		native: {},
 	});
 
+	// Initialize all states with default values
 	await adapter.setStateAsync('info.status', 'starting', true);
-	await adapter.setStateAsync('info.itemsConfigured', 0, true);
-	await adapter.setStateAsync('info.itemsEnabled', 0, true);
+	await adapter.setStateAsync('info.itemsActive', 0, true);
 	await adapter.setStateAsync('info.lastError', '', true);
 	await adapter.setStateAsync('info.lastRun', '', true);
-	await adapter.setStateAsync('info.evalTimeMs', 0, true);
-	await adapter.setStateAsync('info.timeBudgetMs', 0, true);
-	await adapter.setStateAsync('info.skippedItems', 0, true);
-	await adapter.setStateAsync('info.inputTsGapMs', 0, true);
-	await adapter.setStateAsync('info.inputTsGapOk', true, true);
-	await adapter.setStateAsync('info.inputTsGapThresholdMs', 0, true);
-	await adapter.setStateAsync('info.inputTsSources', 0, true);
-	await adapter.setStateAsync('info.inputTsMissing', 0, true);
+	await adapter.setStateAsync('info.lastRunMs', 0, true);
+	await adapter.setStateAsync('info.diagnostics.evalBudgetMs', 0, true);
+	await adapter.setStateAsync('info.diagnostics.evalSkipped', 0, true);
+	await adapter.setStateAsync('info.diagnostics.itemsTotal', 0, true);
+	await adapter.setStateAsync('info.diagnostics.timing.gapMs', 0, true);
+	await adapter.setStateAsync('info.diagnostics.timing.gapOk', true, true);
+	await adapter.setStateAsync('info.diagnostics.timing.gapActiveMs', 0, true);
+	await adapter.setStateAsync('info.diagnostics.timing.gapActiveOk', true, true);
+	await adapter.setStateAsync('info.diagnostics.timing.newestAgeMs', 0, true);
+	await adapter.setStateAsync('info.diagnostics.timing.newestId', '', true);
+	await adapter.setStateAsync('info.diagnostics.timing.oldestAgeMs', 0, true);
+	await adapter.setStateAsync('info.diagnostics.timing.oldestId', '', true);
+	await adapter.setStateAsync('info.diagnostics.timing.sources', 0, true);
+	await adapter.setStateAsync('info.diagnostics.timing.sourcesActive', 0, true);
+	await adapter.setStateAsync('info.diagnostics.timing.sourcesSleeping', 0, true);
 }
 
 module.exports = {

package/lib/services/tickRunner.js

@@ -60,11 +60,11 @@ async function runTick(adapter) {
 
 	// Keep status in sync even if config changes without a restart
 	try {
-		await adapter.setStateAsync('info.itemsConfigured', items.filter(it => it && typeof it === 'object').length, true);
-		await adapter.setStateAsync('info.itemsEnabled', enabledItems.length, true);
+		await adapter.setStateAsync('info.diagnostics.itemsTotal', items.filter(it => it && typeof it === 'object').length, true);
+		await adapter.setStateAsync('info.itemsActive', enabledItems.length, true);
 		await adapter.setStateAsync('info.status', enabledItems.length ? 'ok' : 'no_items_enabled', true);
-		await adapter.setStateAsync('info.timeBudgetMs', timeBudgetMs, true);
-		await adapter.setStateAsync('info.skippedItems', 0, true);
+		await adapter.setStateAsync('info.diagnostics.evalBudgetMs', timeBudgetMs, true);
+		await adapter.setStateAsync('info.diagnostics.evalSkipped', 0, true);
 	} catch {
 		// ignore
 	}
@@ -84,33 +84,83 @@ async function runTick(adapter) {
 	}
 	adapter.currentSnapshot = snapshot;
 
-	// Publish input timestamp skew diagnostics.
+	// Publish comprehensive timing diagnostics.
 	// This helps explain "impossible" transient combinations when snapshot is off or sources update slightly offset.
 	try {
 		const ids = snapshot && typeof snapshot.keys === 'function' ? Array.from(snapshot.keys()) : [];
+		const now = Date.now();
+		const sleepThresholdMs = 30000; // Sources not updated in 30s are considered "sleeping"
+		
 		let minTs = Infinity;
 		let maxTs = -Infinity;
+		let minActiveTs = Infinity;
+		let maxActiveTs = -Infinity;
+		let newestTs = -Infinity;
+		let oldestTs = Infinity;
+		let newestId = '';
+		let oldestId = '';
 		let withTs = 0;
+		let activeSources = 0;
+		let sleepingSources = 0;
 		let total = 0;
+
 		for (const id of ids) {
 			if (!id) continue;
 			total++;
 			const ts = adapter.cacheTs.get(id);
 			if (typeof ts !== 'number' || !Number.isFinite(ts)) continue;
+			
 			withTs++;
+			const age = now - ts;
+			const isActive = age < sleepThresholdMs;
+			
+			// Track overall min/max timestamps
 			if (ts < minTs) minTs = ts;
 			if (ts > maxTs) maxTs = ts;
+			
+			// Track active sources min/max
+			if (isActive) {
+				activeSources++;
+				if (ts < minActiveTs) minActiveTs = ts;
+				if (ts > maxActiveTs) maxActiveTs = ts;
+			} else {
+				sleepingSources++;
+			}
+			
+			// Track newest (most recent)
+			if (ts > newestTs) {
+				newestTs = ts;
+				newestId = id;
+			}
+			
+			// Track oldest (least recent)
+			if (ts < oldestTs) {
+				oldestTs = ts;
+				oldestId = id;
+			}
 		}
+
 		const gapMs = withTs >= 2 ? Math.max(0, Math.round(maxTs - minTs)) : 0;
+		const gapActiveMs = activeSources >= 2 ? Math.max(0, Math.round(maxActiveTs - minActiveTs)) : 0;
 		const intervalMs = getTickIntervalMs(adapter);
 		const thresholdMs = Math.max(200, Math.min(5000, Math.floor(intervalMs * 0.2)));
-		const ok = withTs <= 1 ? true : gapMs <= thresholdMs;
+		const gapOk = withTs <= 1 ? true : gapMs <= thresholdMs;
+		const gapActiveOk = activeSources <= 1 ? true : gapActiveMs <= thresholdMs;
+		const newestAgeMs = newestTs > -Infinity ? Math.max(0, now - newestTs) : 0;
+		const oldestAgeMs = oldestTs < Infinity ? Math.max(0, now - oldestTs) : 0;
 
-		await adapter.setStateAsync('info.inputTsGapMs', gapMs, true);
-		await adapter.setStateAsync('info.inputTsGapOk', ok, true);
-		await adapter.setStateAsync('info.inputTsGapThresholdMs', thresholdMs, true);
-		await adapter.setStateAsync('info.inputTsSources', withTs, true);
-		await adapter.setStateAsync('info.inputTsMissing', Math.max(0, total - withTs), true);
+		// Write all timing diagnostics
+		await adapter.setStateAsync('info.diagnostics.timing.gapMs', gapMs, true);
+		await adapter.setStateAsync('info.diagnostics.timing.gapOk', gapOk, true);
+		await adapter.setStateAsync('info.diagnostics.timing.gapActiveMs', gapActiveMs, true);
+		await adapter.setStateAsync('info.diagnostics.timing.gapActiveOk', gapActiveOk, true);
+		await adapter.setStateAsync('info.diagnostics.timing.newestAgeMs', newestAgeMs, true);
+		await adapter.setStateAsync('info.diagnostics.timing.newestId', newestId, true);
+		await adapter.setStateAsync('info.diagnostics.timing.oldestAgeMs', oldestAgeMs, true);
+		await adapter.setStateAsync('info.diagnostics.timing.oldestId', oldestId, true);
+		await adapter.setStateAsync('info.diagnostics.timing.sources', withTs, true);
+		await adapter.setStateAsync('info.diagnostics.timing.sourcesActive', activeSources, true);
+		await adapter.setStateAsync('info.diagnostics.timing.sourcesSleeping', sleepingSources, true);
 	} catch {
 		// ignore
 	}
@@ -194,9 +244,9 @@ async function runTick(adapter) {
 	adapter.currentSnapshot = null;
 
 	try {
-		await adapter.setStateAsync('info.skippedItems', skippedItems, true);
+		await adapter.setStateAsync('info.diagnostics.evalSkipped', skippedItems, true);
 		await adapter.setStateAsync('info.lastRun', new Date().toISOString(), true);
-		await adapter.setStateAsync('info.evalTimeMs', Date.now() - start, true);
+		await adapter.setStateAsync('info.lastRunMs', Date.now() - start, true);
 	} catch {
 		// ignore
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.data-solectrus",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "ioBroker adapter to compute/mirror PV & consumption values for SOLECTRUS dashboards",
   "author": "Sven",
   "main": "main.js",