Log-Meldungen und Fehler beim Einrichten

Fehler "unit not supported" / "No unit defined" – wie trage ich die Einheit ein?

Kurz: SourceAnalytix findet für den Datenpunkt keine Einheit, mit der es rechnen kann, und berechnet ihn nicht. Ab v0.7.0 steht die Quelle dann in den Instanz-Einstellungen im Tab „Probleme“ mit „Einheit fehlt oder wird nicht erkannt“. Klicke dort auf „Beheben“ und wähle die Einheit, in der das Gerät den Wert liefert.

So sieht die Meldung im Log aus:

No unit defined for <Datenpunkt>, cannot execute calculations !
Please choose unit manually in state configuration
Cannot handle calculations for <Datenpunkt>, check log messages and adjust settings!

Der Datenpunkt wird dann nicht berechnet, und SourceAnalytix legt für ihn keine States an. Die Meldung Sorry unite type … not supported stammt aus alten Versionen bis v0.4.2. Seit v0.4.7 heißt sie No unit defined.

Woher die Meldung kommt

SourceAnalytix nimmt die Einheit, die du bei der Quelle gewählt hast (ab v0.7.0 in der Detailansicht der Quelle unter „Einheit“, bis v0.6.x im Dialog am Datenpunkt unter „Wählen Sie Einheit“). Steht dort „Automatisch erkennen“, nimmt es die Einheit am Objekt des Datenpunkts. Die Meldung erscheint, wenn beides nicht klappt:

• Das Objekt hat keine Einheit. Das ist oft bei Datenpunkten aus Skripten oder bei selbst angelegten Datenpunkten so.
• Die Einheit am Objekt ist nicht in der Liste, zum Beispiel Watt statt W, m3 statt m³ oder m³/h.
• Die Größe wird gar nicht unterstützt, zum Beispiel Stück, Impulse, Betriebsstunden oder %. Ab v0.7.0 gibt es für Stück und Impulse die Einheiten piece und piece/min (siehe Stück und Impulse).

Welche Einheiten es gibt, steht in der Referenz der Einheiten.

So gehst du vor (ab v0.7.0)

1. Öffne unter „Instanzen“ die Einstellungen der SourceAnalytix-Instanz und dort den Tab „Probleme“. Die Instanz muss laufen.
2. Suche die Zeile deiner Quelle mit „Einheit fehlt oder wird nicht erkannt“ und klicke auf „Beheben“.
3. Der Dialog „Einheit beheben“ zeigt, welche Einheit der Datenpunkt meldet. Wähle unter „Einheit“ die Einheit, in der das Gerät zählt. Liefert dein Gaszähler m3, wählst du m³. Liefert die Steckdose Watt, wählst du W.
4. Klicke auf „Übernehmen“. Die Einstellung wirkt sofort, ohne Neustart. Im Log steht danach Enable SourceAnalytix for : <Datenpunkt> ohne Fehlermeldung, und nach „Erneut prüfen“ ist die Zeile im Tab „Probleme“ verschwunden.

Dieselbe Auswahl findest du in der Detailansicht der Quelle unter „Einstellungen“, Feld „Einheit“. Eine neue Quelle legst du am besten mit „Quelle hinzufügen“ an: Der Assistent geht erst weiter, wenn eine Einheit gewählt ist.

Bis v0.6.x: Öffne die SourceAnalytix-Einstellungen des Datenpunkts (so findest du sie), wähle unter „Wählen Sie Einheit“ die Einheit und speichere. Findet der Dialog keine passende Einheit, zeigt er „Keine passende Einheit erkannt. Bitte eine Einheit auswählen“ und speichert nicht.

IMPORTANT

Wähle die Einheit, die das Gerät liefert, nicht die, die du sehen willst. In welcher Einheit SourceAnalytix rechnet und anzeigt, legt die Preisdefinition fest. Wählst du kWh, obwohl das Gerät Wh liefert, sind alle Werte 1.000-mal zu groß.

Steht im Log stattdessen reading incorrect after conversion contact DEV, passt die Einheit des Datenpunkts nicht zur Einheit der Preisdefinition, zum Beispiel kg und kWh. Ab v0.6.2 meldet SourceAnalytix das schon beim Start: Unit <Einheit> of <Datenpunkt> cannot be converted to unit <Einheit> of price definition <Name> (#1278). Wähle dann eine Preisdefinition mit passender Einheit. Ab v0.7.0 steht die Quelle in diesem Fall im Tab „Probleme“ mit „Einheit passt nicht zum Preis“. Bis v0.6.1 erscheint dieselbe Meldung auch, wenn die Quelle Text statt einer Zahl liefert (siehe Quelle liefert Text statt Zahl).

Ab v0.6.2: SourceAnalytix erkennt am Objekt auch die Schreibweisen m3, kwh und ähnliche und rechnet mit m³ bzw. kWh (#1264). Im Log steht dann Unit "m3" of <Datenpunkt> is used as m³. Auch der Einstellungsdialog nimmt diese Schreibweisen bei „Automatisch erkennen“ an (#1278). Ausgeschriebene Namen wie Watt oder Liter wählst du weiterhin von Hand aus.

Siehe auch: Welche Einheiten werden unterstützt? · Welche Einheit stelle ich am Datenpunkt ein?

Fehler "Known valueAtDeviceReset > known cumulative value"

Kurz: Der gespeicherte Offset (valueAtDeviceReset) ist größer als der Gesamtstand (cumulativeReading). Ab v0.6.2 ist das nur noch eine Warnung: Die Quelle läuft weiter, und SourceAnalytix richtet den Offset mit dem nächsten Wert selbst aus. Prüfe danach den Gesamtstand und gleiche ihn bei Bedarf mit der Aktion „Zählerstand angleichen“ an deinen Zähler an. Bis v0.6.1 startet die Quelle bei diesem Fehler nicht.

Die Begriffe Gesamtstand, Gerätewert und Offset sind unter Die Begriffe erklärt. Es gilt immer: Gesamtstand = Gerätewert + Offset.

So sieht die Meldung aus

Ab v0.6.2 steht beim Start eine Warnung im Log, mit dem nächsten Wert der Quelle folgt die zweite Zeile:

Known valueAtDeviceReset (<Offset>) of <Datenpunkt> is larger than the known cumulative value (<Gesamtstand>); the offset will be realigned with the next reading so the total continues from <Gesamtstand>
Realigned valueAtDeviceReset of <Datenpunkt> from <alter Offset> to <neuer Offset>: device value <Gerätewert>, total continues from <Gesamtstand>

Bis v0.6.1 ist es ein Fehler, und die Quelle wird nicht gestartet:

Check settings for <Datenpunkt> ! Known valueAtDeviceReset : (<Offset>) > known cumulative value (<Gesamtstand>) cannot proceed
Troubleshoot Data <Datenpunkt> custom Data : {…}
Cannot handle calculations for <Datenpunkt>, check log messages and adjust settings!

Woher die Meldung kommt

Der Offset steht in den SourceAnalytix-Einstellungen des Datenpunkts, der Gesamtstand im State sourceanalytix.0.<Gerät>.cumulativeReading. Passen beide nicht mehr zusammen, kommt die Meldung. Typische Auslöser:

• Du hast nur cumulativeReading von Hand gesenkt oder auf 0 gesetzt, zum Beispiel nach einer alten Anleitung.
• Der State cumulativeReading oder der ganze Ordner der Quelle wurde gelöscht. Ein fehlender Gesamtstand zählt als 0, der Offset in den Einstellungen bleibt.
• Nach einem Zählertausch oder einem Restore stammen Gesamtstand und Einstellungen aus verschiedenen Zeitpunkten.

Leistungsquellen (W) und andere Quellen, deren Gesamtstand SourceAnalytix selbst aufsummiert, haben keinen Offset. Für sie gibt es die Meldung nicht.

So gehst du vor (ab v0.7.0)

1. Öffne unter „Instanzen“ die Einstellungen der SourceAnalytix-Instanz und im Tab „Übersicht“ deine Quelle.
2. Vergleiche den „Gesamtstand“ mit deinem Zähler. Stimmt er, musst du nichts tun. Den Offset richtet SourceAnalytix mit dem nächsten Wert selbst aus.
3. Stimmt er nicht, wähle bei „Aktionen“ den Eintrag „Zählerstand angleichen“, trage bei „Was zeigt dein Zähler jetzt?“ den abgelesenen Stand ein und klicke auf „Angleichen“. SourceAnalytix setzt Gesamtstand und Offset passend zueinander, sofort und ohne Neustart.

Solange der nächste Wert noch nicht da ist, steht die Quelle auch im Tab „Probleme“ mit „Gesamtstand passt nicht zum Zähler“. Der Knopf „Angleichen“ in dieser Zeile öffnet dieselbe Aktion. Den aktuellen Offset zeigt die Detailansicht der Quelle unter „Für Experten“ als valueAtDeviceReset.

WARNING

Die automatische Ausrichtung zählt vom gespeicherten Gesamtstand weiter, auch wenn dieser falsch ist. Wurde cumulativeReading auf 0 gesetzt oder gelöscht, beginnt der Gesamtstand also bei 0. Gleiche ihn dann mit „Zählerstand angleichen“ an deinen Zähler an.

Bis v0.6.1: Aktualisiere auf v0.6.2 oder neuer (siehe Wie aktualisiere ich SourceAnalytix?). Geht das nicht, korrigierst du Gesamtstand und Offset bei gestoppter Instanz von Hand, wie unter Falsche Werte korrigieren im Teil „Bis v0.6.x“ beschrieben.

Siehe auch: Falsche Werte korrigieren · Zähler oder Gerät getauscht · Nach Update oder Restore sind Werte 0

Fehler "No cost type defined" – Preisdefinition fehlt

Kurz: Jede Quelle braucht eine Preisdefinition, auch wenn du nur den Verbrauch willst. Ihre Einheit ist die Zieleinheit, in der SourceAnalytix rechnet. Ab v0.7.0 steht eine Quelle ohne gültige Preisdefinition im Tab „Probleme“. Mit „Preis wählen“ öffnest du die Quelle und wählst unter „Preisdefinition“ eine aus.

So sieht die Meldung aus

Ist bei der Quelle keine Preisdefinition gewählt:

No cost type defined for <Datenpunkt>, please Select Type of calculation at state setting
Cannot handle calculations for <Datenpunkt>, check log messages and adjust settings!

Ist eine Preisdefinition gewählt, die es nicht mehr gibt, zum Beispiel weil ihre „Kategorie“ umbenannt oder gelöscht wurde:

Selected Type <Name> does not exist in Price Definitions
Please choose proper type for state <Datenpunkt>
Or add price definition <Name> in adapter settings

In beiden Fällen wird die Quelle nicht berechnet, und es entstehen keine States. Im Tab „Probleme“ heißen die Fälle „Keine Preisdefinition gewählt“ und „Preisdefinition gibt es nicht mehr“. Die alte Meldung Error in case handling of cost type identification: undefined gibt es in aktuellen Versionen nicht mehr.

So gehst du vor (ab v0.7.0)

1. Gibt es noch keine passende Preisdefinition, lege sie in den Instanz-Einstellungen im Tab „Preisdefinitionen“ an. Wichtig ist die „Einheit“: Sie muss zur Quelle passen, zum Beispiel kWh für einen Stromzähler oder eine Leistung in W. Speichern startet den Adapter neu.
2. Öffne den Tab „Probleme“ und klicke in der Zeile der Quelle auf „Preis wählen“. Die Detailansicht der Quelle öffnet sich.
3. Wähle unter „Einstellungen“ bei „Preisdefinition“ eine Kategorie. Die Liste zeigt die Einheit in Klammern, zum Beispiel Strom (kWh).
4. Klicke auf „Übernehmen“. Die Quelle startet sofort, ohne Neustart.

Passt die Einheit der Preisdefinition nicht zur Quelle, meldet der Tab „Probleme“ danach „Einheit passt nicht zum Preis“ (siehe Fehler „unit not supported“ / „No unit defined“). Der Assistent „Quelle hinzufügen“ bietet nur Preisdefinitionen mit passender Einheit an und geht ohne Auswahl nicht weiter.

Bis v0.6.x: Wähle im Dialog am Datenpunkt bei „Preisdefinition auswählen“ eine Kategorie und speichere (so findest du den Dialog). Seit v0.6.0 lässt sich der Dialog ohne Preisdefinition nicht mehr speichern.

Siehe auch: Wie ist eine Preisdefinition aufgebaut? · Preise zuordnen und eigene Tarife anlegen · Kosten bleiben 0

Meldungen "Initialization failed" / "Cannot handle calculations" / "reading incorrect"

Kurz: Das sind Sammelmeldungen. Sie sagen nur, dass SourceAnalytix eine Quelle nicht gestartet hat oder einen Wert nicht rechnen konnte. Die Ursache steht in den Log-Zeilen direkt davor. Ab v0.7.0 zeigt der Tab „Probleme“ in den Instanz-Einstellungen die Ursache mit einem Vorschlag zur Lösung.

Meldungen beim Start und beim Aktivieren

Meldung	Bedeutung
Initialization of <Datenpunkt> successfully	Die Quelle läuft.
Initialization of <Datenpunkt> failed, check warn messages !	Die Quelle wurde nicht gestartet. Der Grund steht davor.
Cannot handle calculations for <Datenpunkt>, check log messages and adjust settings!	Dasselbe für eine einzelne Quelle, direkt nach dem Grund.
Cannot handle calculations for <n> of <m> enabled states, check error messages	Zusammenfassung am Ende des Starts: n von m Quellen laufen nicht.
Partially activated SourceAnalytix for <k> of <m> states, check error messages!	Die übrigen Quellen laufen.
[Cannot enable SourceAnalytix for <Datenpunkt>, check settings and error messages	Eine Quelle, die du im laufenden Betrieb aktiviert oder geändert hast, konnte nicht starten.
Cannot handle initialisation for <Datenpunkt>	Folgemeldung: Für die Quelle liegen keine geprüften Einstellungen vor. Auch hier steht der Grund davor.

Häufige Gründe in den Zeilen davor:

• No unit defined for …: siehe Fehler „unit not supported“ / „No unit defined“.
• No cost type defined for … oder Selected Type … does not exist in Price Definitions: siehe Fehler „No cost type defined“.
• Unit … of … cannot be converted to unit … of price definition …: Einheit und Preisdefinition passen nicht zusammen, siehe ebenfalls Fehler „unit not supported“.
• Cannot use output ID … no existing output tree to keep: Die gewünschte technische ID ist ungültig oder schon vergeben, siehe Name, Alias und Output-ID.
• Bis v0.6.1 auch Check settings for … Known valueAtDeviceReset …: siehe Fehler „Known valueAtDeviceReset > known cumulative value“.

Sobald du die Ursache in den Einstellungen behebst und übernimmst, startet SourceAnalytix die Quelle ohne Neustart. Im Log steht dann Enable SourceAnalytix for : <Datenpunkt> ohne Fehler danach.

Meldung „reading incorrect after conversion“

[calculationHandler] reading incorrect after conversion contact DEV and provide these info | Reading : null | start reading {…} | stateDetails {…}

Bis v0.6.1 kommt sie bei jedem Wert, wenn die Quelle keine Zahl liefert (zum Beispiel null oder Text wie "12,5") oder wenn die Einheit der Quelle nicht zur Preisdefinition passt, zum Beispiel kg und kWh. Die Quelle läuft, rechnet aber nichts. Schau im Verlauf des Quell-Datenpunkts nach, was zur Zeit der Meldung ankam, und prüfe die Einheit.

Ab v0.6.2 fängt SourceAnalytix beide Ursachen vorher ab: Zahlen in Text liest es selbst, einen Wert ohne Zahl überspringt es mit der Warnung Value <Wert> of <Datenpunkt> is not a number, reading ignored (siehe Quelle liefert Text statt Zahl). Unpassende Einheiten lehnt es schon beim Start ab. Erscheint die Meldung trotzdem, melde sie mit der ganzen Log-Zeile als Issue im Adapter-Repository.

Siehe auch: Datenpunkt aktiviert, aber es entstehen keine Ordner · Hohe CPU-Last und zu viel Log-Ausgabe

Quelle liefert Text statt Zahl (string statt number, Dezimalpunkt)

Kurz: Ab v0.6.2 liest SourceAnalytix Zahlen aus Text selbst, mit Komma oder Punkt, zum Beispiel "12,5" oder ".14". Text mit Einheit oder Tausenderpunkt, zum Beispiel "12,5 kWh" oder "1.234,5", kann es nicht lesen und überspringt den Wert mit einer Warnung. Am sichersten ist ein Quell-Datenpunkt vom Typ Zahl.

So erkennst du es

• Ab v0.7.0 steht die Quelle im Tab „Probleme“ mit dem Hinweis „Datenpunkt liefert Text statt einer Zahl“, solange der letzte Wert Text ist. Der Knopf „Anleitung“ führt hierher.
• Ab v0.6.2 steht bei einem Text ohne lesbare Zahl im Log Value "<Wert>" of <Datenpunkt> is not a number, reading ignored. Der Wert zählt nicht, der nächste lesbare Wert schon.
• Bis v0.6.1 rechnet SourceAnalytix mit keinem Text-Wert. Bei Zählerständen steht bei jedem Wert reading incorrect after conversion contact DEV … Reading : null im Log, die Quelle bleibt ohne Werte.

Ab v0.7.0 liest SourceAnalytix auch bei Leistungsquellen (W) Text mit Komma oder Punkt, zum Beispiel "1,5", so wie bei Zählerständen. Ist der Text keine Zahl, steht Value "<Wert>" of <Datenpunkt> is not a number, reading ignored im Log, und der Wert zählt nicht (#1288).

Bis v0.6.x wandelt SourceAnalytix Text bei Leistungsquellen nur mit Dezimalpunkt um ("12.5"). Mit Komma steht bei jedem Wert [wattToWattHour] Invalid power reading interval for <Datenpunkt>, using current reading as new baseline im Log, und es entsteht kein Verbrauch.

So stellst du auf eine Zahl um

1. Prüfe zuerst, ob der Quell-Adapter eine Einstellung für Zahlen hat oder einen anderen Datenpunkt mit dem Zählerstand als Zahl anbietet. Den nimmst du.
2. Sonst legst du einen eigenen Datenpunkt vom Typ „Zahl“ an, zum Beispiel einen Alias vom Typ Zahl, dessen Lesefunktion den Text umwandelt, oder ein Skript, das den Text mit parseFloat umwandelt und in den neuen Datenpunkt schreibt. Ersetze dabei vorher das Komma durch einen Punkt.
3. Gib dem neuen Datenpunkt die Einheit, in der das Gerät zählt, zum Beispiel kWh.
4. Richte den neuen Datenpunkt mit „Quelle hinzufügen“ als Quelle ein.

NOTE

Der neue Datenpunkt ist für SourceAnalytix eine neue Quelle mit einem eigenen Ordner. Die Werte der alten Quelle bleiben in ihrem Ordner stehen. Den Zählerstand übernimmst du mit Startwerten oder mit „Zählerstand angleichen“.

Siehe auch: Skript-Datenpunkte und unzuverlässige Quellen · Meldung „reading incorrect after conversion“

Datenpunkt aktiviert, aber es entstehen keine Ordner oder States

Kurz: Fast immer hat SourceAnalytix die Quelle abgelehnt, meist wegen einer fehlenden Preisdefinition oder Einheit. Ab v0.7.0 siehst du das in den Instanz-Einstellungen: Im Tab „Übersicht“ hat die Quelle den Status „Problem“, im Tab „Probleme“ stehen der Grund und ein Knopf zur Lösung.

Checkliste (ab v0.7.0)

1. Läuft die Instanz? Ohne laufende Instanz rechnet SourceAnalytix nicht, und die Übersicht zeigt „Die Übersicht braucht eine laufende Instanz.“
2. Steht die Quelle im Tab „Übersicht“? Wenn nicht, ist der Datenpunkt nicht für diese Instanz eingerichtet, zum Beispiel für sourceanalytix.1 statt sourceanalytix.0. Richte ihn mit „Quelle hinzufügen“ ein. Der Assistent prüft Einheit und Preis, bevor er speichert.
3. Welchen Status hat sie? „Deaktiviert“: Öffne die Quelle und wähle bei „Aktionen“ den Eintrag „Aktivieren“. „Problem“ oder „Hinweis“: weiter mit Schritt 4.
4. Was steht im Tab „Probleme“? „Keine Preisdefinition gewählt“, „Preisdefinition gibt es nicht mehr“, „Einheit fehlt oder wird nicht erkannt“, „Einheit passt nicht zum Preis“ oder „Datenpunkt existiert nicht mehr“. Der Knopf in der Zeile behebt das Problem oder öffnet die passende Stelle.
5. Was steht im Log? Nach Enable SourceAnalytix for : <Datenpunkt> folgt bei einem Fehler der Grund, siehe Meldungen „Initialization failed“ / „Cannot handle calculations“.
6. Ist „Verbrauch“ angehakt? Ohne den Haken bei „Verbrauch“ in den Einstellungen der Quelle entstehen keine Verbrauchswerte für Tag, Woche, Monat, Quartal und Jahr.

Läuft die Quelle, legt SourceAnalytix sofort den Ordner sourceanalytix.0.<Gerät> an. Die ersten Werte erscheinen mit dem nächsten Wert des Datenpunkts. Siehst du den Ordner im Reiter „Objekte“ trotzdem nicht, lade die Ansicht neu und prüfe, ob ein Filter der Objektliste aktiv ist.

Ab v0.7.0: Hast du die Quelle im Reiter „Objekte“ am Datenpunkt über „aktiviert“ eingeschaltet, ist noch keine Preisdefinition gewählt. Die Quelle steht dann im Tab „Probleme“ mit „Keine Preisdefinition gewählt“. Wähle die Preisdefinition in ihrer Detailansicht und klicke auf „⚡ Übernehmen“ (#1286).

Bis v0.6.x: Prüfe dieselben Punkte im Dialog am Datenpunkt und im Log. Seit v0.6.0 speichert der Dialog nicht ohne Preisdefinition und Einheit. Alte Hinweise, man müsse einen Startwert eintragen, gelten nicht mehr: Leere Startwerte setzt SourceAnalytix bei der ersten Aktivierung selbst.

Siehe auch: Wo konfiguriere ich SourceAnalytix für einen Datenpunkt? · Wo finde ich meine Werte?

Hohe CPU-/Speicherlast und zu viel Log-Ausgabe

Kurz: SourceAnalytix rechnet bei jedem neuen Wert jeder Quelle. Viel Last entsteht durch Quellen, die sehr oft senden. Bis v0.6.1 kam eine Dauerlast durch ständiges Neu-Initialisieren dazu, die ab v0.6.2 behoben ist. Für weniger Log-Ausgabe stellst du die Instanz auf die Log-Stufe „warn“.

Last senken

• Aktualisieren: Bis v0.6.1 baut SourceAnalytix bei jeder Änderung am Objekt einer aktiven Quelle die Quelle neu auf, auch wenn sich nichts geändert hat. Ab v0.6.2 übergeht es solche Änderungen und schreibt Objekte nur, wenn sich ihre Definition ändert (#1233).
• Seltener senden: Jede Aktualisierung des Quell-Datenpunkts löst eine Berechnung aus. Sendet ein Gerät jede Sekunde, stelle im Quell-Adapter ein längeres Intervall ein, wenn das geht.
• Zählerstand statt Leistung: Liefert dein Gerät einen Zählerstand (kWh), nimm ihn statt der Leistung (W). Siehe Zähler (kWh) oder Leistung (W)?.
• Nur nötige Quellen: Quellen, die du nicht brauchst, schaltest du ab v0.7.0 bei der Quelle mit „Deaktivieren“ ab. Die Daten bleiben erhalten.

Weniger Log-Ausgabe

Eine neue Instanz startet mit der Log-Stufe „info“. Dann schreibt SourceAnalytix beim Start mehrere Zeilen je Quelle. Für den Dauerbetrieb empfiehlt sich „warn“: Warnungen und Fehler siehst du weiter. Die Log-Stufe stellst du im Reiter „Instanzen“ bei der SourceAnalytix-Instanz ein (im Expertenmodus).

Bis v0.6.1 schreibt eine Quelle mit ausgeschalteter Reset-Erkennung bei jedem fallenden Wert Cumulative reading for … decreased while reset detection is disabled auf Stufe Info. Ab v0.6.2 steht die Meldung nur noch im Debug-Log (#1262).

Füllt ein anderer Adapter das Log, zum Beispiel ein History-Adapter, hilft dessen Log-Stufe, nicht die von SourceAnalytix.

Siehe auch: Warnung zum Objektlimit · Bekannte Fehler älterer Versionen

Probleme bei Installation und Admin-Anzeige

Kurz: Installiere SourceAnalytix aus dem Repository „latest“ (Beta), nicht direkt von GitHub. Ab v0.7.0 braucht es Admin 8.0.0 oder neuer, js-controller 6.0.11 und Node.js 22. Fehlt nach der Installation etwas in Admin, lade die Adapterdateien in der Konsole mit iobroker upload sourceanalytix neu hoch.

Wie die Installation geht, steht unter Installation und Instanz anlegen.

Installation von GitHub bricht mit 404 oder 422 ab

Das ist ein Problem der ioBroker-Installation, nicht von SourceAnalytix. In den gemeldeten Fällen half ein Update des js-controllers. Einfacher ist die Installation aus dem Repository „latest“.

SourceAnalytix oder seine Einstellungen fehlen in Admin

• Kein Eintrag unter „Instanzen“: Nach der Installation musst du eine Instanz anlegen.
• Cannot load jsonConfig of sourceanalytix: Not exists oder index_m.html not found: Admin findet die Dateien der Einstellungsseite nicht. Führe iobroker upload sourceanalytix aus und lade die Admin-Seite neu. Bei Versionen vor v0.4.9 fehlte diese Seite ganz, dann hilft nur ein Update.
• Tabs „Übersicht“ und „Probleme“ leer (ab v0.7.0): Steht dort „Die Übersicht braucht eine laufende Instanz.“ oder „Quellen konnten nicht geladen werden“, starte die Instanz und klicke auf „Erneut versuchen“. Ist die Instanz gestoppt, sind die Aktionen gesperrt. Einstellungen kannst du weiter ändern und speichern.

„Nicht gepflegt“ und unterschiedlich große Symbole

Das Kennzeichen „nicht gepflegt“ hängt am Repository, aus dem du installiert hast. Bei einer Installation von GitHub fehlen diese Angaben. Unterschiedlich große Ordner-Symbole sind ein Darstellungseffekt von Admin im Browser am Handy. Beides ändert nichts an der Funktion von SourceAnalytix.

Multihost: „admin not found“

SourceAnalytix setzt Admin voraus, ab v0.7.0 in Version 8.0.0 oder neuer. Meldet ein Host beim Start oder bei der Installation „admin not found“, installiere oder aktualisiere Admin. Im gemeldeten Fall fehlte Admin auf dem Host, auf dem die Instanz laufen sollte.

Siehe auch: Was brauche ich für SourceAnalytix? · Wie aktualisiere ich SourceAnalytix?

Mitternacht: Absturz oder Tageswechsel zur falschen Zeit

Kurz: Der Periodenwechsel läuft um 0:00 Uhr nach der Systemzeit des Rechners oder Containers, auf dem ioBroker läuft. Ein Absturz mit ENOENT um Mitternacht kommt vom js-controller, nicht von SourceAnalytix. Einen verpassten Wechsel holt SourceAnalytix selbst nach. Ab v0.7.0 holst du ihn auch mit „Nachholen“ im Tab „Probleme“ nach.

Absturz mit ENOENT um Mitternacht

Um Mitternacht wechselt der js-controller die Log-Datei. Fehlt die Datei dabei, kann ein Adapter mit ENOENT abstürzen. Das lässt sich in SourceAnalytix nicht verhindern. Wichtig ist nur, dass der verpasste Wechsel nachgeholt wird.

So holt SourceAnalytix einen Wechsel nach

• Beim Start prüft SourceAnalytix jede Quelle und holt einen verpassten Wechsel sofort nach.
• Läuft der Adapter, prüft er zusätzlich jede Stunde, ob ein Wechsel fehlt.
• Ab v0.7.0 steht ein verpasster Wechsel im Tab „Probleme“ als „Periodenwechsel verpasst“. Der Knopf „Nachholen“ holt ihn für diese Quelle nach. Dasselbe macht die Aktion „Perioden nachholen“ bei der Quelle.
• In allen Versionen ab v0.5.5 geht es auch über den Knopf-State sourceanalytix.0.info.recoverPeriods.

Im Log steht dann Processing calendar rollover for <Datenpunkt>: {…}. Mehr dazu unter ioBroker war über Mitternacht aus.

Ab v0.6.2: War ioBroker über Mitternacht aus, verteilt SourceAnalytix den Verbrauch der Lücke nach der Zeit auf beide Tage. Bis v0.6.1 landete alles im neuen Tag (#1260).

Der Tageswechsel kommt zur falschen Uhrzeit

SourceAnalytix hat keine eigene Zeitzone. Der Wechsel folgt der Zeitzone des Prozesses, in dem ioBroker läuft. Steht ein Docker-Container zum Beispiel auf UTC, wechselt der Tag in Deutschland um 1:00 oder 2:00 Uhr. Stelle dann die Zeitzone des Rechners oder Containers richtig ein, bei Docker etwa mit der Umgebungsvariable TZ=Europe/Berlin, und starte den Container neu.

Siehe auch: Werden die Werte live aktualisiert, was passiert um Mitternacht? · Vorperioden (previous-States)

Warnung zum Objektlimit (5000)

Kurz: Die Warnung kommt vom js-controller, nicht von SourceAnalytix. Der Adapter selbst kennt kein Objektlimit. Jede aktive Quelle legt einen eigenen Ordner mit vielen States an. Prüfe zuerst, welche Optionen und Quellen du brauchst, und hebe das Limit nur an, wenn die Zahl gewollt ist.

Weniger Objekte

• In den Instanz-Einstellungen unter „Haupteinstellungen“ legen die Bereiche „Jahresstatistik“ („Wochen“, „Monate“, „Quartale“) und „Laufendes Jahr“ („Wochentag“, „Wochen“, „Monate“, „Quartale“, „Vorheriger Zeitraum“) fest, welche States jede Quelle bekommt. Schaltest du eine Option ab, entfernt SourceAnalytix die zugehörigen States.
• Quellen, die du nicht mehr brauchst, entfernst du ab v0.7.0 mit der Aktion „Daten löschen“ samt Ordner und allen Jahren.
• Alte Jahres- und Wochenordner kannst du gefahrlos löschen.

CAUTION

„Daten löschen“ entfernt den Ordner der Quelle mit allen Werten und Jahren endgültig. Willst du nur pausieren, nimm „Deaktivieren“.

Limit anheben

Das Limit gehört zum js-controller. Im gemeldeten Fall ließ es sich im Expertenmodus am Objekt der Instanz (system.adapter.sourceanalytix.0) anheben.

Siehe auch: Welche Einstellungen hat die Instanz? · Quelle deaktivieren oder entfernen

Quell-Adapter oder History zeigt 0 oder alte Werte

Kurz: SourceAnalytix liest nur den Datenpunkt, den du als Quelle eingerichtet hast, und schreibt nie in dessen Wert. Zeigt SourceAnalytix 0 oder alte Werte, kommt am Quell-Datenpunkt meist nichts mehr an. Nullen im Verlauf des Quell-Datenpunkts stammen vom Quell-Adapter oder von einem Skript.

Der Quell-Adapter hat seine Datenpunkte umbenannt

Benennt ein Adapter nach einem Update seine Datenpunkte um, kommen die Werte in neuen Datenpunkten an. SourceAnalytix hört weiter auf den alten, und seine Werte bleiben stehen.

1. Öffne in den Instanz-Einstellungen die Quelle und prüfe „Letzte Aktualisierung“.
2. Ist der alte Datenpunkt gelöscht, steht die Quelle ab v0.7.0 im Tab „Probleme“ mit „Datenpunkt existiert nicht mehr“. Der Knopf „Deaktivieren“ hält die Quelle an, die Daten bleiben erhalten.
3. Richte den neuen Datenpunkt mit „Quelle hinzufügen“ als neue Quelle ein und übernimm den Zählerstand mit „Zählerstand angleichen“.
4. Passe Verknüpfungen in VIS oder Skripten auf den neuen Ordner an. Der alte Ordner bleibt als Archiv stehen.

Die Aktion „Datenpunkt wechseln“, die die Daten zum neuen Datenpunkt mitnimmt, ist geplant (#1271).

Nullen im Verlauf des Quell-Datenpunkts

SourceAnalytix schreibt Werte nur in seinen eigenen Ordner sourceanalytix.0.<Gerät>. Am Objekt des Quell-Datenpunkts ändert es nur seine eigenen Einstellungen, zum Beispiel den Offset, nicht den Wert. Eine 0 im Verlauf des Quell-Datenpunkts schreibt also ein anderer Adapter oder ein Skript.

Siehe auch: Datenpunkt aktiviert, aber es entstehen keine Ordner · Quelle deaktivieren oder entfernen