Neue Adresse: die ioBroker-Webseite liegt jetzt auf iobroker.com

[Shadowhunter23]

Hallo!

Ein Werkzeug, das ein Backitup-Backup offline einliest und auswertet — ohne laufendes ioBroker, ohne Adapter, ohne Anmeldung. Es liest nur: Es schreibt nichts zurück und löscht nichts.

Was es zeigt

• Skripte — JavaScript und Blockly, letzteres mit lesbarem XML und erzeugtem JavaScript
• Verwendung — welches Skript welchen Datenpunkt anfasst, in beide Richtungen
• VIS-Datenpunkte — alles, was in VIS 1 und VIS 2 verwendet wird, mit Fundstelle
• Skripte — JavaScript und Blockly, letzteres mit lesbarem XML und erzeugtem JavaScript
• Verwendung — welches Skript welchen Datenpunkt anfasst, in beide Richtungen
• VIS-Datenpunkte — alles, was in VIS 1 und VIS 2 verwendet wird, mit Fundstelle
• Verwaiste Datenpunkte — Objekte ohne Adapter, Datenpunkte ohne Verwendung
• Aliasse, Logging, Dateien — samt Export einzelner Dateien aus dem Backup
• Vergleich zweier Backups — was sich geändert hat, mit Zeilenvergleich der Skripte

Die Listen sind Prüflisten, keine Löschlisten. Was gelöscht wird, entscheidest du.

Einfach ausprobieren, ohne irgendetwas zu installieren

https://brainbug01.github.io/iobroker-backup-analyzer/

Aufrufen, Backup hineinziehen, fertig. Das Backup verlässt deinen Rechner nicht — die Seite liefert nur das Programm aus, gelesen und ausgewertet wird im Browser. Nachprüfbar in den Entwicklerwerkzeugen: Nach dem Laden der Seite ist unter „Netzwerk" keine weitere Übertragung zu sehen. Die Seite wird bei jeder Version aus dem offenen Quelltext gebaut, nachvollziehbar unter „Actions" im Repository.

Oder als Programm — alle Downloads unter

https://github.com/Brainbug01/iobroker-backup-analyzer/releases/latest

Windows	_Ordner.zip (empfohlen), entpacken und starten
macOS	_macOS-AppleSilicon bzw. _macOS-Intel
Linux mit Oberfläche	_Linux-x64.tar.gz — ein Desktop-Rechner, nicht der ioBroker-Host
Eigener Webserver	_Browser.zip auf den Server legen, im Netz aufrufen

Alle Fassungen zeigen dieselben Reiter und dieselben Zahlen.

Mit KI erstellt. Programmcode, Auswertungslogik und sämtliche Texte stammen von
Claude (Anthropic), erarbeitet in Claude Code. Vor jeder Auslieferung läuft ein
Verifikationslauf mit derzeit 634 Einzelprüfungen gegen echte Backups.

Quelltext, ausführliche Beschreibung und Bilder:
https://github.com/Brainbug01/iobroker-backup-analyzer

Ein Dank an @bluefox: Er hat sich den Quellcode angesehen und Hinweise gegeben, die in die aktuelle Fassung ( Stand 20.08. ) eingeflossen sind.

[guitardoc]

Vielen Dank für die Erstellung dieses nützlichen Tools! Ich habe damit schon einige Datenleichen in meinem System entdecken und beseitigen können.

Besonders hilfreich ist es, wenn mehrere Skripte einen Datenpunkt beschreiben oder ihn auslesen. Da sieht man mit dem Tool schnell, welches Skript welchen Datenpunkt beeinflusst.

[Shadowhunter23]

Die Funktion in der 1.20.0 ist z.B. durch diesen Beitrag entstanden:
https://forum.iobroker.net/topic/85202/vis-ausversehen-gelöscht
Hier hätte man mit dem Tool ab heute das ältere Backup öffnen können und die Vis exportieren.
Diese Vis im Editor importieren und der Vorgang wäre erledigt gewesen.

Quelltext, ausführliche Beschreibung und Bilder:
https://github.com/Brainbug01/iobroker-backup-analyzer

Wünsche und Anregungen sind herzlich willkommen.

[guitardoc]

Eigentlich trifft es der Name Backup-Analyzer nicht richtig. Ja, es wird ein Backup analysiert, aber es ist ja eine Analyse des gesamten ioBroker-Datenbestandes auf Fehler, Inkonsistenzen, etc. und geht weit weit über eine Beurteilung der Gültigkeit eines Backups hinaus.

Namen sind zwar Schall und Rauch, aber vielleicht lässt sich da doch noch ein treffenderer Name finden, der auch mehr Interessenten dafür anzieht? Nur so eine Idee.

[Shadowhunter23]

Der Name kommt von der Anweisung an Claude das ich gerne mein Backup analysieren möchte und dafür ein Tool brauche. Und da KI sehr einfallsreich ist kam es zu der spektakulären Namensgebung
Ob ein anderer Name mehr Leute ansprechen würde kann ich nicht beurteilen. Vielleicht ist die Kategorie Off topic auch wenig besucht. Mal abwarten, vielleicht kommen noch mehr Tester hinzu und schreiben etwas dazu.

[Bernd1967]

@shadowhunter23
Hab gerade mal die Version v1.22.0 getestet.
Nach der Auswahl des Backup fängt das Programm an einzulesen und bleibt dann bei "VIS View werden gelesen.." hängen (ca. bei 50% Progressbar).
Programm Titel zeigt (Keine Rückmeldung).
Hast Du eine Idee ?

Nachtrag:
Kein Fehler, durch sehr viele states dauert es bei mir fast 5 Minuten.

[Shadowhunter23]

@bernd1967
Danke für die Hilfe per Chat und es gibt nun 1.22.2

Was langsam war: Die Analyse „unbenutzte Datenpunkte" prüft für jeden selbst angelegten Datenpunkt, ob in einem Skript oder einer VIS-Ansicht erwähnt. Dafür hat sie bisher für jeden einzelnen Datenpunkt den kompletten VIS- und Skripttext durchsucht. Solange beides klein ist, merkt man das nicht. Bei einem umfangreichen VIS-Projekt und einigen tausend Datenpunkten unter 0_userdata wächst der Aufwand zu Minuten — in denen scheinbar nichts passiert.

Quelltext, ausführliche Beschreibung und Bilder:
https://github.com/Brainbug01/iobroker-backup-analyzer

[Shadowhunter23]

Neu: eine Fassung für den Browser 1.23.1

Quelltext, ausführliche Beschreibung und Bilder:
https://github.com/Brainbug01/iobroker-backup-analyzer

[mcm1957]

Wenn das alles statisch ist und im Prinzip nur Code ausliefert der lokal im Browser läuft - also der Server keine Zugriff auf das Backup oder sonst was braucht - kannst du das dann auch gleich über eine Github Page (xxx.github.io) anbieten?

[Shadowhunter23]

@mcm1957 danke für den Schubser in die Richtung!
@guitardoc auch dir danke ich für den Hinweis das ganze auch als Browser Version zu bauen!
Du hast im Hintergrund getestet und für Verbesserungen mitgewirkt.

Der Analyzer läuft jetzt auch als fertige Seite — ohne Installation, ohne eigenen Server

https://brainbug01.github.io/iobroker-backup-analyzer/

Aufrufen, Backup hineinziehen, fertig.

[ioT4db]

@shadowhunter23 moin, tolles tool, danke dafür! meinst du man könnte auch die states bzw. den Objektbaum darstellen lassen? hatte vor ein paar tagen den fall, dass ich einen alten state aus einem bestimmten DP rauskopieren wollte. dafür habe ich dann einen temporären Container erzeugt aus meinem proxmox backup. funktionierte, ja, aber mit deinem tool wäre das viel einfacher/schneller gewesen...

VG

[Shadowhunter23]

Damit ich das Richtige baue, drei Fragen:

1. Brauchst du wirklich den navigierbaren Baum wie im Admin, oder hätte dir eine Suche über die Datenpunkt-ID mit Wertanzeige genauso geholfen?
2. Wolltest du den Wert nur sehen, oder wieder ins laufende System zurückschreiben? Im zweiten Fall könnte das Tool gleich einen fertigen setState-Befehl ausgeben.
3. Ging es nur um den Wert, oder auch um die Definition des Datenpunkts (Name, Typ, Einheit, Rolle) — also eher „Datenpunkt wiederherstellen"?

[ioT4db]

Hi, @Shadowhunter23

also aus user-sicht würd ich mir natürlich wünschen, je mehr Infos man rausbekommt, desto besser, aber mir hätte bei meinem beschriebenen Problem auch schon folgendes geholfen:

zu 1. > eine suche über Name oder ID wäre ausreichend
zu 2. > ich wollte den wert, in dem fall ein json, manuell in meinen Produktiv-state kopieren. einen setState-bräuchte ich nicht extra
zu 3. > mir ging es nur um den wert, aber wer weiß wann man die Definition vielleicht doch mal braucht

am Ende ist es (für mich) ein Notfall-Tool, also muss ja auch nicht alles abbilden

in meinem Fall kam ich im ersten Schritt über das Proxmox-Backup sehr easy an die states.jsonl ran, konnte damit auf die Schnelle keinen kopierbaren json-wert extrahieren (gefunden hatte ich den schon, aber am ende war ich schneller mit dem container und konnte für mich das Problem lösen)

VG

[Shadowhunter23]

So, ist drin — Version 1.25.1 ist raus.

Neuer Reiter "Datenpunkte": Suche über ID und Name (mehrere Begriffe, Reihenfolge egal), darunter der vollständige Wert zum Kopieren. Genau dein Fall: JSON-Werte kommen entmaskiert und eingerückt heraus, nicht als eine lange Zeile mit "Anführungszeichen". Daneben stehen Typ, Einheit, Rolle, Grenzen und Vorgabewert — du meintest ja, die Definition könnte man mal brauchen.

setState-Generator und Objektbaum habe ich weggelassen, wie von dir beschrieben.
Notfall-Tool eben.

https://brainbug01.github.io/iobroker-backup-analyzer/

[guitardoc]

Wow - das geht ja Holterdipolter mit den neuen Versionen, da komme ich gar nicht hinterher mit testen...
Wahnsinn. Das Tool ist wirklich richtig toll!!!!

[ioT4db]

@Shadowhunter23 sagte:

Neuer Reiter "Datenpunkte":

sehr cool, danke. genau das hätte ich vor ner woche gebraucht . das tool ist eine super ergänzung zum Backup!

VG

[Rico Sander]

Kurze Frage:

Ein history-Backup - z.B. "historyDB_2026_09_11-09_06_01_Intern_RPi-9_backupiobroker.tar.gz" - auszuwerten und zu prüfen geht wohl nicht?

[Shadowhunter23]

Nein geht nicht, hatte bisher keinen Fall gesehen dass ich das einbauen sollte.

[Rico Sander]

Ah, ok und danke für Deine Antwort.
Hintergrund der Frage:

Seit Tagen erzeugt BackItUp offenbar ein fehlerhaftes(?) Archiv der historyDB.
Bei geplanten (automatischen) BackUps ist es kleiner als wenn ich den Prozess über das UI starte (ca 60 KB).

Ich hatte gehofft über das hilfreiche Tool (danke dafür) der Ursache auf den Grund zu kommen. Es gibt dazu auch ein noch unbeantwortetes Thema (https://forum.iobroker.net/post/1354211).

Aber egal, ich habe schon eine Ersatzlösung gefunden.

[Shadowhunter23]

Für dich noch als Anmerkung, was das Tool kann ist zu prüfen ob der Pfad in der History gesetzt ist.
Bei deinem Fehler wird es schwierig zur Laufzeit zu analysieren.