Skip to content
  • Home
  • Aktuell
  • Tags
  • 0 Ungelesen 0
  • Kategorien
  • Unreplied
  • Beliebt
  • GitHub
  • Docu
  • Hilfe
Skins
  • Light
  • Brite
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Standard: (Kein Skin)
  • Kein Skin
Einklappen
ioBroker Logo

Community Forum

  1. ioBroker Community Home
  2. Deutsch
  3. Skripten / Logik
  4. JavaScript
  5. [Vorlage] JS: Log-Datei aufbereiten für VIS

NEWS

  • UPDATE 31.10.: Amazon Alexa - ioBroker Skill läuft aus ?
    apollon77A
    apollon77
    48
    3
    8.3k

  • Monatsrückblick – September 2025
    BluefoxB
    Bluefox
    13
    1
    2.0k

  • Neues Video "KI im Smart Home" - ioBroker plus n8n
    BluefoxB
    Bluefox
    15
    1
    2.4k

[Vorlage] JS: Log-Datei aufbereiten für VIS

Geplant Angeheftet Gesperrt Verschoben JavaScript
617 Beiträge 60 Kommentatoren 153.1k Aufrufe 49 Watching
  • Älteste zuerst
  • Neuste zuerst
  • Meiste Stimmen
Antworten
  • In einem neuen Thema antworten
Anmelden zum Antworten
Dieses Thema wurde gelöscht. Nur Nutzer mit entsprechenden Rechten können es sehen.
  • P Offline
    P Offline
    PatrickFro
    schrieb am zuletzt editiert von
    #403

    Bei mir will das neue Skript leider nicht laufen. Ich erhalte immer wieder 7c0f97cfd-31f2-409b-bcda-9c4c9c9c05ba-image.png

    6e312311-b434-4a52-87f9-34ddf50ae4b0-image.png

    c06dd4ee-afe8-49c0-9d04-beeb47c96da3-image.png

    351cff50-461b-4b2f-af8a-cb3990bddfd8-image.png

    502c9915-a135-4772-b0e2-513e79a2ba64-image.png

    Was ist bei mir anders als bei allen, bei denen es funktioniert??

    GlasfaserG 1 Antwort Letzte Antwort
    0
    • P PatrickFro

      Bei mir will das neue Skript leider nicht laufen. Ich erhalte immer wieder 7c0f97cfd-31f2-409b-bcda-9c4c9c9c05ba-image.png

      6e312311-b434-4a52-87f9-34ddf50ae4b0-image.png

      c06dd4ee-afe8-49c0-9d04-beeb47c96da3-image.png

      351cff50-461b-4b2f-af8a-cb3990bddfd8-image.png

      502c9915-a135-4772-b0e2-513e79a2ba64-image.png

      Was ist bei mir anders als bei allen, bei denen es funktioniert??

      GlasfaserG Offline
      GlasfaserG Offline
      Glasfaser
      schrieb am zuletzt editiert von
      #404

      @PatrickFro

      Du hast ein Fehler in den User Einstellungen !
      Poste mal hier dein Teil der Einstellungen .

      Synology 918+ 16GB - ioBroker in Docker v9 , VISO auf Trekstor Primebook C13 13,3" , Hikvision Domkameras mit Surveillance Station .. CCU RaspberryMatic in Synology VM .. Zigbee CC2538+CC2592 .. Sonoff .. KNX .. Modbus ..

      1 Antwort Letzte Antwort
      0
      • P Offline
        P Offline
        PatrickFro
        schrieb am zuletzt editiert von
        #405

        @Glasfaser said in [Vorlage] JS: Log-Datei aufbereiten für VIS:

        User Einstellungen !

        Von User-Einstellungen höre ich das erste Mal. Was ist das bzw. wo sind die?

        1 Antwort Letzte Antwort
        0
        • P Offline
          P Offline
          PatrickFro
          schrieb am zuletzt editiert von
          #406

          Ah, noch nie gesehen... Meinst Du das?

          dd64c4c9-1af0-4df2-bdf7-e59283208f70-image.png

          MicM 1 Antwort Letzte Antwort
          0
          • P PatrickFro

            Ah, noch nie gesehen... Meinst Du das?

            dd64c4c9-1af0-4df2-bdf7-e59283208f70-image.png

            MicM Offline
            MicM Offline
            Mic
            Developer
            schrieb am zuletzt editiert von Mic
            #407

            @PatrickFro

            Sind im Script. Egal :-)
            Poste einfach mal das komplette Script, also so wie du es verändert hast.

            1 Antwort Letzte Antwort
            0
            • P Offline
              P Offline
              PatrickFro
              schrieb am zuletzt editiert von PatrickFro
              #408

              @Mic Ich habe keine Änderungen vorgenommen, 1:1 übernommen. Steht ja im Script, dass es auch so schon funktionieren sollte ;-)

              /*************************************************************************************************************************
               * ---------------------------
               * Log Script für ioBroker zum Aufbereiten des Logs für Visualisierungen (vis), oder um
               * auf Log-Ereignisse zu reagieren.
               * ---------------------------
               *
               * Das Script nimmt jeden neuen Logeintrag des ioBrokers und wendet entsprechend gesetzte
               * Filter an, um den Eintrag dann in den entsprechenden Datenpunkten dieses Scripts abzulegen.
               
               * Es stehen auch JSON-Datenpunkte zur Verfügung, mit diesen kann im vis eine
               * Tabelle ausgegeben werden (z.B. über das Widget 'basic - Table' oder 'materialdesign - Table').
               *
               * Aktuelle Version: https://github.com/Mic-M/iobroker.logfile-script
               * Support:          https://forum.iobroker.net/topic/13971/vorlage-log-datei-aufbereiten-f%C3%BCr-vis-javascript
               * Autor:            Mic (ioBroker) | Mic-M (github)
               * -----------------------------------------------------------------------------------------------------------------------
               * VORAUSSETZUNGEN
               * 1.) Nur falls Datenpunkte unterhalb '0_userdata.0' abgelegt werden sollen:
               *     In der Instanz des JavaScript-Adapters die Option [Erlaube das Kommando "setObject"] aktivieren.
               *     Siehe auch: https://github.com/Mic-M/iobroker.createUserStates
               * 2.) Dieses Script benötigt die JavaScript-Adapter-Version 4.3.0 (2019-10-09) oder höher.
               *     Wer eine ältere Version einsetzt: Bitte Script-Version 2.0.2 verwenden.
               * =====================================================================================
               * -----------------------------------------------------------------------------------------------------------------------
               * Change Log:
               *  4.0.1 Mic   - Add "jsonDateFormat: 'dd.mm. hh:mm'," to FILTER_LOG, id 'all'.
               *  4.0 Mic     + To allow individual settings per each defined LOG_FILTER, the following global 
               *                settings were moved to LOG_FILTER:
               *                 * JSON_DATE_FORMAT                   -> jsonDateFormat
               *                 * JSON_LEN                           -> jsonLogLength
               *                 * JSON_NO_ENTRIES                    -> jsonMaxLines
               *                 * JSON_APPLY_CSS_LIMITED_TO_LEVEL    -> jsonCssToLevel
               *                 * L_SORT_ORDER_DESC                  -> sortDescending
               *              + Code improvements
               *              + Renamed LOG_NO_OF_ENTRIES to MAX_LOG_LINES
               *  ---------------------------------------------------------------------------------------------------- 
               *  3.4 Mic     + Support both '0_userdata.0' and 'javascript.x' for state creation
               *  3.3 Mic     - Fix state path
               *  3.2 Mic     + Create all states under 0_userdata.0, and no longer under javascript.<instance> (like javascript.0)
               *  3.1 Mic     + Change to stable as tests were successful
               *              + Add new option REMOVE_PID: The js-controller version 2.0+ adds the PID number inside brackets 
               *                to the beginning of the message. Setting REMOVE_PID = false will remove it.
               *  3.0Alpha Mic + Major Change: JavaScript adapter 4.3+ now provides onLog() function: 
               *                 https://github.com/ioBroker/ioBroker.javascript/blob/master/docs/en/javascript.md#onlog 
               *                 We are using this new function to streamline this log script tremendously and to remove node-tail.
               *  ---------------------------------------------------------------------------------------------------- 
               *  2.0.2 Mic   + Changed certain functions to async to get rid of setTimout() and for the sake of better error handling.
               *              + startTailingProcess(): ensure the tailing starts if the file is present (wait to be created)
               *  2.0.1a Mic  Removed constant MERGE_LOGLINES_ACTIVE
               *  2.0.0a Mic  Major improvements and fixes:
               *              + Change from instant state update to schedule (STATE_UPDATE_SCHEDULE). The instant update, so once
               *                new log entries coming in, caused several issues (setting and getting state values (getState() and 
               *                setState()) within <1ms simply does not work.
               *              - Fix issue with merging log lines
               *              + Moved global option MERGE_LOGLINES_ACTIVE to LOG_FILTER, for allowing turning on/off for each filter id.
               *              + Several other code improvements
               *              Note: For upgrading from previous version: replace script entirely, re-enter all your options, 
               *                    and delete all existing states prior to first activation of this script.
               *  ---------------------------------------------------------------------------------------------------- 
               *  1.5.1 Mic - Set option MERGE_LOGLINES_ACTIVE to 'false' as default, as users reported issues. See 
               *              https://forum.iobroker.net/post/288772 . Also option MERGE_LOGLINES_ACTIVE being marked as "experimental"
               *              in the comments. Requires further investigation.
               *  1.5  Mic - Fix issue with option MERGE_LOGLINES_ACTIVE
               *  1.4  Mic + New option MERGE_LOGLINES_TXT for an individual (e.g. localized) string other than 'entries'.
                           - Fix JSON span class closing
               *  1.3  Mic + New option MERGE_LOGLINES_ACTIVE: Merge Loglines with same log message to only one line and adds leading
               *             '[123 entries]' to log message.
               *  1.2  Mic - Fixed issue #6 (Button javascript.0.Log-Script.logXxxx.clearJSON not working reliably)
               *  1.1  Mic + 1. 1.0x script seems to work reliable per user feedback and my own test, so pushing into 1.1 stable.
               *           + New state '.logMostRecent': provides just the most recent log entry to work with "on /
               *             subscribe" on this state and trigger actions accordingly.
               *  1.02 alpha  Mic  - fix restarting at 0:00 (note: restarting is needed due to log file name change)
               *  1.01 alpha  Mic  - fix: creating new file system log file only if not yet existing
               *  1.00 alpha  Mic  + Entirely recoded to implement node-tail (https://github.com/lucagrulla/node-tail).
               *  ----------------------------------------------------------------------------------------------------
               *  0.8.1 Mic - Fix: L_SORT_ORDER_DESC was not defined (renamed constant name was not changed in config)
               *  0.8 Mic - Fix: Script caused a "file not found" error if executed right at or shortly after midnight.
               *  0.7 Mic - Fix: States "...clearDateTime" will not get an initial date value on first script start,
               *                 also fix for "on({id: ".
               *  0.6 Mic + Put 0.5.1 BETA into stable
               *          + New option L_APPLY_CSS. If true, it will add <span class='log-info'>xxx</span>
               *            to each log string. 'log-info' for level info, 'log-error' for error, etc.
               *            This makes it easy to format a JSON table with CSS.
               *  0.5.1 BETA Mic + New States "Clear JSON log ..." and "Clear JSON log - Date/Time ...".
               *                   When the button "Clear JSON log" is pushed, the current date/time
               *                   will be set into the date/time state. Once refreshed
               *                   (per schedule in the script, e.g. after 2 minutes), the JSON
               *                   will be cleaned and display just newer logs.
               *                   Use Case: In vis, you can now add a button "clear log" or
               *                   "Mark as read". If you hit the button, the log will be
               *                   cleared and just new log items will be displayed.
               *                   *** THIS IS STILL BEING TESTED *** therefore a beta release...
               *  0.5  Mic + New parameter 'clean' to remove certain strings
               *             from the log line.
               *           + New parameter 'columns' for JSON output to specify which columns
               *             to be shown, and in which order.
               *           + New state "JSONcount" to have the number of log lines in state
               *           - Fixed a few issues
               *  0.4  Mic - Bug fix: improved validation of log line consistency
               *  0.3  Mic + Added filtering and blacklist
               *           - Several fixes
               *  0.2  Mic - Bug fix: corrected wrong function name
               *  0.1  Mic * Initial release
               ************************************************************************************************************************/
              
              /*******************************************************************************
               * Konfiguration: Pfade
               ******************************************************************************/
              // Pfad, unter dem die States (Datenpunkte) in den Objekten angelegt werden.
              // Es wird die Anlage sowohl unterhalb '0_userdata.0' als auch 'javascript.x' unterstützt.
              const LOG_STATE_PATH = '0_userdata.0.Log-Script';
              
              
              // Pfad zum Log-Verzeichnis auf dem Server.
              // Standard-Pfad unter Linux: '/opt/iobroker/log/'. Wenn das bei dir auch so ist, dann einfach belassen.
              const LOG_FS_PATH = '/opt/iobroker/log/';
              
              /*******************************************************************************
               * Konfiguration: Alle Logeinträge - Global
               ******************************************************************************/
              
              // Zahl: Maximale Anzahl der letzten Logeinträge in den Datenpunkten. Alle älteren werden entfernt.
              // Bitte nicht allzu viele behalten, denn das kostet Performance.
              const MAX_LOG_LINES = 100;
              
              // Der js-Controller Version 2.0 oder größer fügt Logs teils vorne die PID in Klammern hinzu, 
              // also z.B. "(12234) Terminated (15): Without reason". 
              // Mit dieser Option lassen sich die PIDs aus den Logzeilen entfernen.
              const REMOVE_PID = true;
              
              /**
               * Schwarze Liste (Black list)
               * Falls einer dieser Satzteile/Begriffe in einer Logzeile enthalten ist, dann wird der Log-Eintrag
               * komplett ignoriert, egal was weiter unten eingestellt wird.
               * Dies dient dazu, um penetrante Logeinträge gar nicht erst zu berücksichtigen.
               * Bitte beachten: 
               * 1. Mindestens 3 Zeichen erforderlich, sonst wird es nicht berücksichtigt (würde auch wenig Sinn ergeben).
               * 2. Bestehende Datenpunkt-Inhalte dieses Scripts bei Anpassung dieser Option werden nicht nachträglich neu gefiltert,
               *    sondern nur alle neu hinzugefügten Log-Einträge ab Speichern des Scripts werden berücksichtigt.
               */
              const BLACKLIST_GLOBAL = [
                  '<==Disconnect system.user.admin from ::ffff:', // web.0 Adapter
                  'system.adapter.ical.0 terminated with code 0 (OK)', 
                  'bring.0 Cannot get translations: RequestError',
                  ' reconnected. Old secret ', // Sonoff
                  'Popup-News readed...', // info.0 Adapter
                  '[warn] Projects disabled : set editorTheme.projects.enabled=true to enable', // see https://forum.iobroker.net/topic/12260/
              	'',
              	'',
              ];
              
              /**
               * Zusatz-Einstellung für Option "merge" für LOG_FILTER (unter "Konfiguration: Datenpunkte und Filter"):
               * In MERGE_LOGLINES_TXT kann hier ein anderes Wort eingetragen werden, z.B. 'entries' oder 'Zeilen', damit [123 entries] 
               * oder [123 Zeilen] vorangestellt wird anstatt [123 Einträge].
               * HINWEIS: Falls MERGE_LOGLINES_TXT geändert wird: bitte alle Datenpunkte des Scripts löschen und dann Script neu starten.
               */
              const MERGE_LOGLINES_TXT = 'Einträge';
              
              /**
               *  Für JSON-Tabelle: Füge CSS-Klasse hinzu je nach Log-Level (debug, silly, info, warn und error), um Tabellen-Text zu formatieren.
               *  Beispiel für Log-Level "debug": ersetzt "xxx" durch "<span class='log-debug'>xxx</span>""
               *  Es wird jeweils "log-" vorangestellt, also: debug -> log-debug, silly -> log-silly, info -> log-info, etc.
               *  Etwa für Widget "basic - Table" im vis können im Reiter "CSS" z.B. folgende Zeilen hinzugefügt werden,
               *  um Warnungen in oranger und Fehler in roter Farbe anzuzeigen.
               *         .log-warn { color: orange; }
               *         .log-error { color: red; }
               *  Tipp: In LOG_FILTER kann dann bei den einzelnen Filtern mittels "jsonCssToLevel" eingestellt werden, dass das CSS
               *        nur  für die Spalte "level" (also debug, error, info) und nicht auf alle Spalten angewendet wird.
               */
              const JSON_APPLY_CSS = true;
              
              
              /*******************************************************************************
               * Konfiguration: Datenpunkte und Filter
               ******************************************************************************
               * Dies ist das Herzstück dieses Scripts: hier werden die Datenpunkte konfiguriert, die erstellt werden sollen. 
               * Hierbei kannst du entsprechend Filter setzen, also z.B. Wörter/Begriffe, die in Logeinträgen enthalten sein
               * müssen, damit sie in den jeweiligen Datenpunkten aufgenommen werden.
               * --------------------------------------------------------------------------------------------------------------------------
               * id:              Ein Begriff ohne Leerzeichen, z.B. "error", "sonoff", homematic, etc. Die ID wird dann Teil der
               *                  Datenpunkte, z.B. "javascript.0.Log-Script.logHomematic.log" mit automatisch vorangestelltem "log".
               * --------------------------------------------------------------------------------------------------------------------------
               * filter_all:      ALLE Begriffe müssen in der Logzeile enthalten sein. Ist einer der Begriffe nicht enthalten, dann wird der 
               *                  komplette Logeintrag auch nicht übernommen. Leeres Array [] eingeben, falls hier filtern nicht gewünscht.
               * --------------------------------------------------------------------------------------------------------------------------
               * filter_any:      Mindestens einer der gelisteten Begriffe muss enthalten sein. Leeres Array [] eingeben, falls hier filtern
               *                  nicht gewünscht.
               * --------------------------------------------------------------------------------------------------------------------------
               * blacklist:       Schwarze Liste: Wenn einer dieser Begriffe im Logeintrag enthalten ist, so wird der komplette Logeintrag 
               *                  nicht übernommen, egal was vorher in filter_all oder filter_any definiert ist.
               *                  Mindestens 3 Zeichen erforderlich, sonst wird es nicht berücksichtigt.
               *                  HINWEIS: BLACKLIST_GLOBAL wird vorher schon angewendet, hier kannst du einfach nur noch eine individuelle 
               *                  Blackliste pro id definieren.
               * --------------------------------------------------------------------------------------------------------------------------
               * clean:           Der Log-Eintrag wird um diese Zeichenfolgen bereinigt, d.h. diese werden entfernt, aber die restliche Zeile 
               *                  bleibt bestehen. Z.B. um unerwünschte Zeichenfolgen zu entfernen oder Log-Ausgaben zu kürzen.
               * --------------------------------------------------------------------------------------------------------------------------
               * merge:           Log-Einträge mit gleichem Text zusammenfassen. Beispiel:
               *                      -----------------------------------------------------------------------------------
               *                      2019-08-17 20:00:00.335 - info: javascript.0 script.js.Wetter: Wetterdaten abrufen.
               *                      2019-08-17 20:15:00.335 - info: javascript.0 script.js.Wetter: Wetterdaten abrufen.
               *                      2019-08-17 20:30:00.335 - info: javascript.0 script.js.Wetter: Wetterdaten abrufen.
               *                      -----------------------------------------------------------------------------------
               *                  Daraus wird dann nur noch eine Logzeile mit letztem Datum/Uhrzeit und hinzufügen von "[3 Einträge]":
               *                      -----------------------------------------------------------------------------------
               *                      2019-08-17 20:30:00.335 - info: javascript.0 [3 Einträge] script.js.Wetter: Wetterdaten abrufen.
               *                      -----------------------------------------------------------------------------------
               *                  Zum aktivieren: true eintragen, zum deaktivieren: false eintragen.
               * --------------------------------------------------------------------------------------------------------------------------
               * sortDescending:  Wenn true: Sortiert die Logeinträge absteigend, also neuester oben. 
               *                  Wenn false: Sortiert die Logeinträge aufsteigend, also ältester oben. 
               * --------------------------------------------------------------------------------------------------------------------------
               * jsonColumns:     Nur für JSON (für vis). 
               *                  Folgende Spalten gibt es: 'date','level','source','msg'. Hier können einzelne Spalten entfernt oder die 
               *                  Reihenfolge verändert werden. Bitte keine anderen Spalten eintragen, sondern nur 'date','level','source','msg'.
               * --------------------------------------------------------------------------------------------------------------------------
               * jsonDateFormat:  Datumsformat für JSON Log. Z.B. volles Datum mit 'YYYY-MM-DD HH:MM:SS' oder nur Uhrzeit mit "HH:MM:SS". Die 
               *                  Platzhalter YYYY, MM, DD usw. werden jeweils ersetzt.
               *                  YYYY = Jahr 4stellig (z.B. 2019), YY = Jahr 2stellig (z.B. 19), MM = Monat, DD = Tag, HH = Stunde, MM = Minute, 
               *                  SS = Sekunde. Groß- oder Kleinschreibung ist egal, d.h. YYYY ist das gleiche wie yy.
               *                  Die Verbinder (-, :, Leerzeichen, etc.) können im Prinzip frei gewählt werden.
               *                  Beispiele: 'HH:MM:SS' für 19:37:25, 'HH:MM' für 19:37, 'DD.MM. HH:MM' für '25.07. 19:37'
               * --------------------------------------------------------------------------------------------------------------------------
               * jsonLogLength:   Maximale Anzahl Zeichen jeder einzelnen Log-Meldung im JSON-Log. Alles was länger ist, wird abgeschnitten.
               * --------------------------------------------------------------------------------------------------------------------------
               * jsonMaxLines:    Maximale Anzahl der letzten Logeinträge im JSON-Log. Alle älteren werden entfernt.
               *                  Falls in MAX_LOG_LINES z.B. "100" gesetzt wird, wird hier bei 100 der Cut gemacht, selbst wenn in 
               *                  jsonMaxLines etwa 250 eingetragen wird. D.h. im Bedarf zuerst MAX_LOG_LINES anpassen/erhöhen.
               * --------------------------------------------------------------------------------------------------------------------------
               * jsonCssToLevel:  Wenn true, dann wird JSON_APPLY_CSS nur für die Spalte "level" (also debug, error, info) angewendet, 
               *                  aber nicht für die restlichen Spalten wie Datum, Log-Eintrag, etc.
                                  Falls alle Spalten das CSS bekommen sollen: auf false setzen.
               * --------------------------------------------------------------------------------------------------------------------------
               *
               * WEITERER HINWEIS: 
               * Bestehende Datenpunkt-Inhalte dieses Scripts bei Anpassung dieser Option werden nicht nachträglich neu 
               * gefiltert, sondern nur alle neu hinzugefügten Log-Einträge ab Speichern des Scripts werden berücksichtigt.
               * --------------------------------------------------------------------------------------------------------------------------
               */
              const LOG_FILTER = [
              
                // Beispiel für individuellen Eintrag. Hier wird euer Hubschrauber-Landeplatz überwacht :-) Wir wollen nur Einträge 
                // vom Adapter 'hubschr.0'. Dabei sollen entweder Wetterwarnungen, Alarme, oder UFOs gemeldet werden. Alles unter 
                // Windstärke "5 Bft" interessiert uns dabei nicht, daher haben wir '0 Bft' bis '4 Bft' auf die Blackliste gesetzt.
                // Außerdem entfernen wir von der Log-Zeile die Zeichenfolgen '****', '!!!!' und 'ufo gesichtet', der Rest bleibt 
                // aber bestehen. Zudem haben wir unter jsonColumns die Spaltenreihenfolge geändert. 'level' herausgenommen, und Quelle 
                // ganz vorne.
              /*
                {
                  id:             'hubschrauberlandeplatz',
                  filter_all:     ['hubschr.0'],
                  filter_any:     ['wetterwarnung', 'alarm', 'ufo'],
                  blacklist:      ['0 Bft', '1 Bft', '2 Bft', '3 Bft', '4 Bft'],
                  clean:          ['****', '!!!!', 'ufo gesichtet'],
                  merge:          true,
                  sortDescending: true,
                  jsonDateFormat: 'dd.mm. hh:mm',       
                  jsonColumns:    ['source','date','msg'],
                  jsonLogLength:  100,
                  jsonMaxLines:   10,
                  jsonCssToLevel: true,
                }, 
              */
              
              /*
                {
                  id:             'all',    // Beispiel "all": hier kommen alle Logeinträge rein, keine Filterung
                  filter_all:     ['', ''], // wird ignoriert, wenn leer
                  filter_any:     ['', ''], // wird ignoriert, wenn leer
                  blacklist:      ['', ''], // wird ignoriert, wenn leer
                  clean:          ['', '', ''], // wird ignoriert, wenn leer
                  merge:          true,
                  sortDescending: true,
                  jsonDateFormat: 'dd.mm. hh:mm',       
                  jsonColumns:    ['date','level','source','msg'],  // Spaltenreihenfolge für JSON (Tabelle in vis)
                  jsonLogLength:  100,
                  jsonMaxLines:   10,
                  jsonCssToLevel: true,
                },
              */
                {
                  id:             'info',
                  filter_all:     [' - info: '], // nur Logeinträge mit Level 'info'
                  filter_any:     ['', ''],
                  blacklist:      ['', ''],
                  clean:          ['', '', ''],
                  merge:          true,
                  sortDescending: true,
                  jsonDateFormat: 'dd.mm. hh:mm',
                  jsonColumns:    ['date','level','source','msg'],
                  jsonLogLength:  100,
                  jsonMaxLines:   60,
                  jsonCssToLevel: true,
                },
                {
                  id:             'error',
                  filter_all:     [' - error: ', ''],  // nur Logeinträge mit Level 'error'
                  filter_any:     [''],
                  blacklist:      ['', '', ''],
                  clean:          ['', '', ''],
                  merge:          true,
                  sortDescending: true,
                  jsonColumns:    ['date','level','source','msg'],
                  jsonDateFormat: 'dd.mm. hh:mm',
                  jsonLogLength:  100,
                  jsonMaxLines:   60,
                  jsonCssToLevel: true,
                },
                {
                  id:             'warnanderror',
                  filter_all:     ['', ''],
                  filter_any:     [' - error: ', ' - warn: '],  // nur Logeinträge mit Levels 'warn' und 'error'
                  blacklist:      ['', 'no playback content', 'Ignore! Actual secret is '],
                  clean:          ['', '', ''],
                  merge:          true,
                  sortDescending: true,
                  jsonDateFormat: 'dd.mm. hh:mm',
                  jsonColumns:    ['date','level','source','msg'],
                  jsonLogLength:  100,
                  jsonMaxLines:   60,
                  jsonCssToLevel: true,
                },
                {
                  // Beispiel, um einen bestimmten Adapter zu überwachen.
                  // Hier werden alle Fehler und Warnungen des Homematic-Adapters hm-rpc.0 gelistet.
                  id:             'homematic',
                  filter_all:     ['hm-rpc.0', ''],  // hm-rpc.0 muss enthalten sein.
                  filter_any:     [' - error: ', ' - warn: '],  // entweder error oder warn
                  blacklist:      ['', '', ''],
                  clean:          ['', '', ''],
                  merge:          true,
                  sortDescending: true,
                  jsonDateFormat: 'dd.mm. hh:mm',
                  jsonColumns:    ['date','level','source','msg'],
                  jsonLogLength:  100,
                  jsonMaxLines:   60,
                  jsonCssToLevel: true,
                },
              
              ];
              
              
              /*******************************************************************************
               * Konfiguration: Konsolen-Ausgaben
               ******************************************************************************/
              
              // Auf true setzen, wenn zur Fehlersuche einige Meldungen ausgegeben werden sollen.
              // Ansonsten bitte auf false stellen.
              const LOG_DEBUG = false;
              
              // Auf true setzen, wenn ein paar Infos dieses Scripts im Log ausgegeben werden dürfen, bei false bleiben die Infos komplett weg.
              const LOG_INFO = true;
              
              
              /*******************************************************************************
               * Experten-Konfiguration
               ******************************************************************************/
              
              // Wie oft Datenpunkte aktualisieren?
              // Neu reinkommende Logeinträge werden erst mal gesammelt (in Variable G_NewLogLinesArrayToProcess). Diese werden dann 
              // regelmäßig in den Datenpunkten geschrieben. Sinnvoll ist hier nicht kürzer als 2-3 Sekunden, und nicht länger als 
              // ein paar Minuten. Zu kurzes Intervall: Script kommt nicht mehr nach. Zu lange: falls viele Logeinträge reinkommen, 
              // kann sich vieles "aufstauen" zur Abarbeitung. Benutze den "Cron"-Button oben rechts für komfortable Einstellung.
              const STATE_UPDATE_SCHEDULE = '*/20 * * * * *'; // alle 20 Sekunden
              
              
              // Leer lassen! Nur setzen, falls ein eigener Filename für das Logfile verwendet wird für Debug.
              const DEBUG_CUSTOM_FILENAME = '';
              
              // Regex für die Aufteilung des Logs in 1-Datum/Zeit, 3-Level, 5-Quelle und 7-Logtext.
              // Ggf. anzupassen bei anderem Datumsformat im Log. Wir erwarten ein Format
              // wie z.B.: '2018-07-22 12:45:02.769  - info: javascript.0 Stop script script.js.ScriptAbc'
              // Da als String, wurden alle Backslashes "\" mit einem zweiten Backslash escaped.
              const LOG_PATT =  '([0-9_.\\-:\\s]*)(\\s+\\- )(silly|debug|info|warn|error|)(: )([a-z0-9.\\-]*)(\\s)(.*)';
              
              // Debug: Ignore. Wenn dieses String in der Logzeile enthalten ist, dann ignorieren wir es.
              // Dient dazu, dass wir während des Scripts ins Log schreiben können, ohne dass das dieses Script berücksichtigt.
              const DEBUG_IGNORE_STR = '[LOGSCRIPT_IGNORE]'; // Muss ein  individuelles String sein. Sonst gibt es ggf. eine Endlos-Schleife.
              
              
              // Debug: Prüfen, ob jede Logzeile erfasst wird, in dem wir diese direkt danach noch mal ins Log schreiben.
              // Bitte nur auf Anweisung vom Entwickler einschalten. Sonst wird jeder Logeintrag noch einmal wiederholt, 
              // mit führendem DEBUG_EXTENDED_STR am Anfang und max. DEBUG_EXTENDED_NO_OF_CHARS an Anzahl Zeichen.
              const DEBUG_EXTENDED = false;
              const DEBUG_EXTENDED_STR = '[LOGSCRIPT_DEBUG_EXTENDED]'; // Muss ein  individuelles String sein. Sonst gibt es ggf. eine Endlos-Schleife.
              const DEBUG_EXTENDED_NO_OF_CHARS = 120;
              
              
              
              /*************************************************************************************************************************
               * Ab hier nichts mehr ändern / Stop editing here!
               *************************************************************************************************************************/
              
              
              /*************************************************************************************************************************
               * Global variables and constants
               *************************************************************************************************************************/
              
              // Final state path
              const FINAL_STATE_LOCATION = validateStatePath(LOG_STATE_PATH, false);
              const FINAL_STATE_PATH = validateStatePath(LOG_STATE_PATH, true);
              
              
              // Merge loglines: define pattern (and escape the merge text)
              // We added an additional backslash '\' to each backslash as these need to be escaped.
              const MERGE_REGEX_PATT = '^\\[(\\d+)\\s' + escapeRegExp(MERGE_LOGLINES_TXT) + '\\]\\s(.*)';
              
              // Log Handler variable for ioBroker function onLog()
              let G_LogHandler;  // being set later
              
              // Schedule for logfile update
              let G_Schedule_StateUpdate; // being set later
              
              // We add here all the new log lines to be processed regularly (per STATE_UPDATE_SCHEDULE);
              let G_NewLogLinesArrayToProcess = [];
              
              /*************************************************************************************************************************
               * init - This is executed on every script (re)start.
               *************************************************************************************************************************/
              init();
              function init() {
              
                  // Unsubscribe log handler
                  onLogUnregister(G_LogHandler);
                  
                  // Create all script states
                  createUserStates(FINAL_STATE_LOCATION, false, buildNeededStates(), function() {
                      // -- All states created, so we continue by using callback
              
                      // Subscribe on changes: Pressed button "clearJSON"
                      subscribeClearJson();
              
                      // Subscribe to log handler
                      G_LogHandler = onLog('*', data => { // please disregard the red squiggly underline under '*', see Github issue: https://github.com/ioBroker/ioBroker.javascript/issues/457
                          processNewLogLine(data);
                      });
              
                      // Schedule writing changes into states
                      clearSchedule(G_Schedule_StateUpdate);
                      G_Schedule_StateUpdate = schedule(STATE_UPDATE_SCHEDULE, processNewLogsPerSchedule);
              
                      // Message
                      if (LOG_INFO) log('Start monitoring of the ioBroker log...', 'info');
              
                  });
              
              }
              
              function processNewLogLine(data) {
                  
                  // Convert to Log Line
                  // TODO: This is a quick implementation of new function onLog().
                  //       We need to entirely rewrite script later to fully use the data object.
                  //       However, at this time, we convert it to a standard log line being expected.
              
                  // First, remove PID if desired
                  let msg = data.message;
                  if (REMOVE_PID) msg = removePID(msg);
              
                  // Now convert to log line
                  let newLogEntry = timestampToLogDate(data.ts) + '  - ' + data.severity + ': ' + msg;
              
                  // Check if we have DEBUG_IGNORE_STR in the new log line
                  if(! newLogEntry.includes(DEBUG_IGNORE_STR)) {
              
                      if (newLogEntry.length > 45) {  // a log line with less than 45 chars is not a valid log line.
              
                          // Cleanse and apply blacklist
                          newLogEntry = cleanseLogLine(newLogEntry);
              
                          // Push result into logArrayFinal
                          G_NewLogLinesArrayToProcess.push(newLogEntry);
              
                          // some debugging
                          if (LOG_DEBUG) log (DEBUG_IGNORE_STR + '===============================================================');
                          if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'New Log Entry, Len (' + newLogEntry.length + '), content: [' + newLogEntry + ']');
              
                          // This is for debugging purposes, and it will log every new log entry once again. See DEBUG_EXTENDED option above.
                          if (DEBUG_EXTENDED) {
                              if (! newLogEntry.includes(DEBUG_EXTENDED_STR)) { // makes sure no endless loop here.
                                  log(DEBUG_EXTENDED_STR + newLogEntry.substring(0, DEBUG_EXTENDED_NO_OF_CHARS));
                                      
                              }
                          }
                      }
                  }
              
              }
              
              /**
               * Called per schedule STATE_UPDATE_SCHEDULE.
               * It processes G_NewLogLinesArrayToProcess
               */
              function processNewLogsPerSchedule() {
                  if (! isLikeEmpty (G_NewLogLinesArrayToProcess) ) {
              
                      // We use array spreads '...' to copy array. If not, array is changed by reference and not value.
                      // That means, if we change the target array, it will also change the source array.
                      // See https://stackoverflow.com/questions/7486085/copy-array-by-value
                      let logArrayToProcess = [...G_NewLogLinesArrayToProcess];
                      G_NewLogLinesArrayToProcess.length = 0; // emptying array. https://stackoverflow.com/questions/4804235/difference-between-array-length-0-and-array
              
                      /**
                       * Apply the filters as set in LOG_FILTER and split up log levels into elements of an array
                       * logArrayToProcessFiltered will look as follows:
                       *   logArrayToProcessFiltered = [
                       *     ['info':'15.08.2019 09:27:55.476 info adapt.0 some log', 'error':''],
                       *     ['info':'15.08.2019 09:33:58.522 info adapt.0 some more log', 'error':''],
                       *     ['info':'', 'error':'15.08.2019 09:37:55.807 error adapt.0 some error log']
                       *   ]
                       */
                      let logArrayToProcessFiltered = [];
                      for (let lpEntry of logArrayToProcess) {
                          let logEntryFilteredArray = applyFilter(lpEntry);
                          logArrayToProcessFiltered.push(logEntryFilteredArray);
                      }
              
                      // Further process and finally set states with our results.
                      processLogArrayAndSetStates(logArrayToProcessFiltered);
              
                  }
              }
              
              
              
              /*************************************************************************************************************************
               * Filtering
               *************************************************************************************************************************/
              
              /**
               * This function applies the filters as set in LOG_FILTER.
               * Also, it splits up the log levels into elements of an array we return by this function.
               * @param {string} strLogEntry
               * @return {array}  split up log levels as elements within this array, like: ['info':'logtext', 'error':'logtext'] etc.
               */
              function applyFilter(strLogEntry) {
                  // We add one element per each filter to the Array ('all', 'error', etc.)
                  let logArrayProcessed = [];
                  for (let j = 0; j < LOG_FILTER.length; j++) {
                      logArrayProcessed[LOG_FILTER[j].id] = '';
                  }
              
                  // We apply regex here. This will also eliminate all log lines without proper info
                  // like date/time, log level, and entry.
                  let arrSplitLogLine = logLineSplit(strLogEntry);
                  if (arrSplitLogLine !== false) {
              
                      if (isLikeEmpty(LOG_FILTER) === false) {
                                  
                          // Now let's iterate over the filter array elements
                          // We check if both the "all" and "any" filters  apply. If yes, - and blacklist false - we add the log line.
                          for (let k = 0; k < LOG_FILTER.length; k++) {
                              if ( (strMatchesTerms(strLogEntry, LOG_FILTER[k].filter_all, 'every') === true)
                              && (strMatchesTerms(strLogEntry, LOG_FILTER[k].filter_any, 'some') === true)
                              && (strMatchesTerms(strLogEntry, LOG_FILTER[k].blacklist, 'blacklist') === false) ) {
                                  logArrayProcessed[LOG_FILTER[k].id] = logArrayProcessed[LOG_FILTER[k].id] + strLogEntry + "\n";
                              }
                              
                              // Now we remove terms if desired
                              if (isLikeEmpty(LOG_FILTER[k].clean) === false) {
                                  for (let lpTerm of LOG_FILTER[k].clean) {
                                      if (lpTerm !== '') {
                                          logArrayProcessed[LOG_FILTER[k].id] = logArrayProcessed[LOG_FILTER[k].id].replace(lpTerm, '');
                                      }
                                  }
                              }
                          }
                      }
                  }
                  return logArrayProcessed;
              }
              
              /*************************************************************************************************************************
               * Further processing
               *************************************************************************************************************************/
              
              /**
               * Further processes the log array and set states accordingly.
               * 
               * @param  arrayLogInput             The Array of the log input.
               *                                   Array is like: 
               *                                   [
               *                                      ['info':'15.08.2019 09:27:55.476 info adapt.0 some log', 'error':''],
               *                                      ['info':'15.08.2019 09:33:58.522 info adapt.0 some more log', 'error':''],
               *                                      ['info':'', 'error':'15.08.2019 09:37:55.807 error adapt.0 some error log'],
               *                                   ]
               **/
              function processLogArrayAndSetStates(arrayLogInput) {
              
                  /*****************
                   * [1] Build array from LOG_FILTER. Looks like: arrayFilterIds = ['info', 'error', 'warn'].
                   * Also, build result array to keep our results. Lools like resultArr = [info: '', error: '', warn: '']
                   *****************/
                  let arrayFilterIds = [];
                  let resultArr = [];
                  for (let i = 0; i < LOG_FILTER.length; i++) {
                      arrayFilterIds.push(LOG_FILTER[i].id); // each LOG_FILTER id into array
                      resultArr[LOG_FILTER[i].id] = '';
                  }
                  /*****************
                   * [2] Process element by element, so ['info':'log test', 'error':'log test'] of given array.
                   * We fill the result array accordingly.
                   *****************/
                  for (let lpElement of arrayLogInput) {
              
                      // Loop thru our new array arrayFilterIds and fill result array
                      for (let k = 0; k < arrayFilterIds.length; k++) {
              
                          // some variables
                          let lpFilterId = arrayFilterIds[k]; // Filter ID from LOG_FILTER, like 'error', 'info', 'custom', etc.
                          let lpNewLogLine = lpElement[lpFilterId]; // Current log line of provided array element of 'error', 'info', 'custom' etc.
              
                          if (isLikeEmpty(lpNewLogLine)) {
                              // No log content for the given filter id.
                              if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'Filter  [' + lpFilterId + ']: No match.');
                          } else {
              
                              if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'Filter [' + lpFilterId + ']: Match! New Log Line length: (' + lpNewLogLine.length + ')');
              
                              // Append new log line to result array
                              if (isLikeEmpty(resultArr[lpFilterId])) {
                                  resultArr[lpFilterId] = lpNewLogLine; 
                              } else {
                                  resultArr[lpFilterId] = lpNewLogLine + resultArr[lpFilterId]; // "\n" not needed, always added above
                              }
                          }
                      }
                  }
              
                  /*****************
                   * [3] We merge with the current state.
                   *****************/
                  for (let k = 0; k < arrayFilterIds.length; k++) {
                      let lpFilterId = arrayFilterIds[k]; // Filter ID from LOG_FILTER, like 'error', 'info', 'custom', etc.
                      let lpStatePath1stPart = FINAL_STATE_PATH + '.log' + cleanseStatePath(lpFilterId); // Get Path to state
                      let lpNewFinalLog = resultArr[lpFilterId];
              
                      if (! isLikeEmpty(lpNewFinalLog) )  {
              
                          // Get state value
              			let strCurrentStateLog = getState(lpStatePath1stPart + '.log').val; // Get state contents of loop item
                          
                          // Add state log lines to our final log
                          if (! isLikeEmpty(strCurrentStateLog)) {
                              lpNewFinalLog = lpNewFinalLog + strCurrentStateLog; // "\n" not needed, always added above
                          }            
              
                          // Convert to array for easier handling
                          let lpNewFinalLogArray = lpNewFinalLog.split(/\r?\n/);
              
                          // Remove duplicates
                          lpNewFinalLogArray = arrayRemoveDublicates(lpNewFinalLogArray);
              
                          // Remove empty values
                          lpNewFinalLogArray = cleanArray(lpNewFinalLogArray);
              
                          // Sort array descending
                          lpNewFinalLogArray = sortLogArrayByDate(lpNewFinalLogArray, 'desc');
              
                          // Merge Loglines if multiple values and add leading '[123 entries]' to log message
                          let doMerge = getConfigValuePerKey(LOG_FILTER, 'id', lpFilterId, 'merge');
                          if (doMerge || doMerge === 'true') {    // also check for string 'true' in case user used string
                              lpNewFinalLogArray = mergeLogLines(lpNewFinalLogArray);
                          }
              
                          // We need a separate array for JSON
                          let lpNewFinalLogArrayJSON = lpNewFinalLogArray;
              
                          // Let's remove elements if time of when button '.clearJSON' was pressed is greater than log date.
                          lpNewFinalLogArrayJSON = clearJsonByDate(lpNewFinalLogArrayJSON, lpStatePath1stPart + '.clearJSON');              
              
                          // Just keep the first x elements of the log. JSON log length is being set individually.
                          lpNewFinalLogArray = lpNewFinalLogArray.slice(0, MAX_LOG_LINES);
                          lpNewFinalLogArrayJSON = lpNewFinalLogArrayJSON.slice(0, getConfigValuePerKey(LOG_FILTER, 'id', lpFilterId, 'jsonMaxLines'));
              
                          // Get just the most recent log entry into string
                          let lpMostRecent = lpNewFinalLogArray[0];
              
                          // Sort ascending if desired
                          if (!getConfigValuePerKey(LOG_FILTER, 'id', lpFilterId, 'sortDescending')) {
                              lpNewFinalLogArray = lpNewFinalLogArray.reverse();
                              lpNewFinalLogArrayJSON = lpNewFinalLogArrayJSON.reverse();
                          }
              
                          // ** Finally set the states
              
                          ///////////////////////////////
                          // -1- Full Log, String, separated by "\n"
                          ///////////////////////////////
                          let strResult = lpNewFinalLogArray.join("\n");
                          if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'New length to be set into state: (' + strResult.length + '), state: [' + lpStatePath1stPart + '.log' + ']');
              
                          setState(lpStatePath1stPart + '.log', strResult);
              
                          ///////////////////////////////
                          // -2- JSON, with elements date and msg
                          ///////////////////////////////
                          // Let's put together the JSON
                          let jsonArr = [];
                          for (let j = 0; j < lpNewFinalLogArrayJSON.length; j++) {
                              // Get 4 elements in array: datetime, level, source, message
                              let arrSplitLogLine = logLineSplit(lpNewFinalLogArrayJSON[j]);
                              if (arrSplitLogLine !== false) {
                                  let strLogMsg = arrSplitLogLine.message;
                                  // Reduce the length for each log message per "jsonLogLength"
                                  strLogMsg = strLogMsg.substr(0, LOG_FILTER[k].jsonLogLength);
                                  // ++++++
                                  // Build the final Array
                                  // ++++++
                                  // We need this section to generate the JSON with the columns (which ones, and order) as specified in LOG_FILTER
                                  let objectJSONentry = {}; // object (https://stackoverflow.com/a/13488998)
                                  if (isLikeEmpty(LOG_FILTER[k].jsonColumns)) log('Columns not specified in "jsonColumns".', 'warn');
                                  // Prepare CSS
                                  let strCSS1, strCSS2;
                                  let strCSS1_level, strCSS2_level;
                                  if (JSON_APPLY_CSS) {
                                      strCSS1 = "<span class='log-" + arrSplitLogLine.level + "'>";
                                      strCSS2 = '</span>';
                                      strCSS1_level = strCSS1;
                                      strCSS2_level = strCSS2;
                                      if (LOG_FILTER[k].jsonCssToLevel) {
                                          strCSS1 = '';
                                          strCSS2 = '';
                                      }
                                  }
              
                                  for (let lpCol of LOG_FILTER[k].jsonColumns) {
                                      switch (lpCol) {
                                          case 'date' :
                                              objectJSONentry.date = strCSS1 + formatLogDateStr(arrSplitLogLine.datetime, LOG_FILTER[k].jsonDateFormat) + strCSS2;
                                              break;
                                          case 'level' :
                                              objectJSONentry.level = strCSS1_level + arrSplitLogLine.level + strCSS2_level;
                                              break;
                                          case 'source' :
                                              objectJSONentry.source = strCSS1 + arrSplitLogLine.source + strCSS2;
                                              break;
                                          case 'msg' :
                                              objectJSONentry.msg = strCSS1 + strLogMsg + strCSS2;
                                              break;
                                          default:
                                              //nothing;
                                      }
                                  }
                                  // Ok, so now we have the JSON entry.
                                  jsonArr.push(objectJSONentry);
                              }
              
                          }
                          if (! isLikeEmpty(lpNewFinalLogArrayJSON)) {
                              setState(lpStatePath1stPart + '.logJSON', JSON.stringify(jsonArr));
                              setState(lpStatePath1stPart + '.logJSONcount', lpNewFinalLogArrayJSON.length);
                          } 
                      }
                  }
              }
              
              /**
               * This will allow to set Json log to zero if button is pressed.
               */
              function subscribeClearJson() {
                  // Set current date to state if button is pressed
                  let logSubscribe = '';
                  for (let i = 0; i < LOG_FILTER.length; i++) {
                      let lpFilterId = cleanseStatePath(LOG_FILTER[i].id);
                      let lpStateFirstPart = FINAL_STATE_PATH + '.log' + lpFilterId;
                      logSubscribe += ( (logSubscribe === '') ? '' : ', ') + lpFilterId;
                      on({id: lpStateFirstPart + '.clearJSON', change: 'any', val: true}, function(obj) {
                          let stateBtnPth = obj.id // e.g. [javascript.0.Log-Script.logInfo.clearJSON]
                          let firstPart = stateBtnPth.substring(0, stateBtnPth.length-10); // get first part of obj.id, like "javascript.0.Log-Script.logInfo"
                          let filterID = firstPart.slice(firstPart.lastIndexOf('.') + 1); // gets the filter id, like "logInfo"
                          if (LOG_DEBUG) log(DEBUG_IGNORE_STR + 'Clear JSON states for [' + filterID + '].');
                          // We clear the according JSON states
                          setState(firstPart + '.logJSON', '[]');
                          setState(firstPart + '.logJSONcount', 0);
              
                      });
                  }
                  if (LOG_DEBUG) log('Subscribing to Clear JSON Buttons: ' + logSubscribe)
              }
              
              
              /*************************************************************************************************************************
               * Script specific supporting functions
               *************************************************************************************************************************/
              
              /**
               * Reformats a log date string accordingly
               * @param {string}    strDate   The date to convert
               * @param {string}    format    e.g. 'yyyy-mm-dd HH:MM:SS'. Both upper case and lower case letters are allowed.
               * @return {string}             Returns the resulting date string
               */
              function formatLogDateStr(strDate, format) {
              
                  let strResult = format.toLowerCase();
                  strResult = strResult.replace('yyyy', strDate.substr(0,4));
                  strResult = strResult.replace('yy', strDate.substr(2,2));
                  strResult = strResult.replace('mm', strDate.substr(5,2));
                  strResult = strResult.replace('dd', strDate.substr(8,2));
                  strResult = strResult.replace('hh', strDate.substr(11,2));
                  strResult = strResult.replace('mm', strDate.substr(14,2));
                  strResult = strResult.replace('ss', strDate.substr(17,2));
              
                  return strResult;
              
              }
              
              /**
               * Cleanse the log line
               * @param {string}   logLine    The log line to be cleansed.
               * @return {string}             The cleaned log line
               */
              function cleanseLogLine(logLine) {
                  // Remove color escapes - https://stackoverflow.com/questions/25245716/remove-all-ansi-colors-styles-from-strings
                  let logLineResult = logLine.replace(/\u001b\[.*?m/g, ''); 
                  // Sometimes, a log line starts with the term "undefined", so we remove it.
                  if (logLineResult.substr(0,9) === 'undefined') logLineResult = logLineResult.substr(9,99999);
                  // Remove white space, tab stops, new line
                  logLineResult = logLineResult.replace(/\s\s+/g, ' ');
                  // Check against global blacklist
                  if(strMatchesTerms(logLineResult, BLACKLIST_GLOBAL, 'blacklist')) logLineResult = '';
              
              
                  return logLineResult;
              }
              
              
              
              /**
               * Sorts the log array by date. We expect the first 23 chars of each element being a date in string format.
               * @param {array} inputArray       Array to process
               * @param {string}  order          'asc' or 'desc' for ascending or descending order
               */
              function sortLogArrayByDate(inputArray, order) {
                  var result = inputArray.sort(function(a,b){
                          // Turn your strings into dates, and then subtract them
                          // to get a value that is either negative, positive, or zero.
                          a = new Date(a.substr(0,23));
                          b = new Date(b.substr(0,23));
                          if (order === 'asc') {
                              return a - b;
                          } else {
                              return b - a;
                          }
              
                  });
              
                  return result;
              }
              
              
              /**
               * Splits a given log entry into an array with 4 elements.
               * @param {string}  inputValue  Log line like '2018-07-22 11:47:53.019  - info: javascript.0 script.js ...'
               * @return {object}   Array with 4 elements: 
               *                     0. datetime (e.g. 2018-07-22 11:47:53.019),
               *                     1. level (e.g. info)
               *                     2. source (e.g. javascript.0)
               *                     3. message (e.g. script.js....)
               *                     Returns FALSE if no match or input value not valid
               */
              function logLineSplit(inputValue) {
              
                  // Get RegEx ready
                  let mRegEx = new RegExp(LOG_PATT, 'g');
              
                  // Split
                  let returnObj = {}
                  let m;
                  do {
                      m = mRegEx.exec(inputValue);
                      if (m) {
                          returnObj.datetime = m[1];
                          returnObj.spaceAt2 = m[2];
                          returnObj.level = m[3];
                          returnObj.spaceAt4 = m[4];
                          returnObj.source = m[5];
                          returnObj.spaceAt6 = m[6];
                          returnObj.message = m[7];
                      } 
                  } while (m);
              
                  // Now we check if we have valid entries we want
                  if ((returnObj.datetime === undefined)
                      || (returnObj.level === undefined)
                      || (returnObj.source === undefined)
                      || (returnObj.message === undefined)
                  ) {
                     return false; // no valid hits
                  }
                  // We can return the array now, since it meets all requirements
                  return returnObj;
              
              }
              
              /**
               * Merges date/time, level, source and message to a logline
               * @param  {array}    inputValue   Array with 4 elements: date/time, level, source, message
               * @return {string}   Merged log line as string. Empty string '', if input value not valid.
              																			  
               */
              function logLineMerge(inputValue) {
              
                  if (inputValue.length === 4) {
                      let mergedLine = inputValue[0] + ' - ' + inputValue[1] + ': ' + inputValue[2] + ' ' + inputValue[3];
                      return mergedLine;
                  } else {
                      // We expect a size of 4, so go out
                      return '';
                  }
              
              }
              
              
              /**
               * Merge Loglines if multiple values and add leading '[123 entries]' to log message
               * @param {array}  logArray        array of log entries
               * @return {array} the new merged log array
               */
              function mergeLogLines(logArray) {
              
                  // We use array spreads '...' to copy array. If not, array is changed by reference and not value.
                  // That means, if we change the target array, it will also change the source array.
                  // See https://stackoverflow.com/questions/7486085/copy-array-by-value
                  let arrCopy = [...logArray];
                  let arrNew = [];
              
                  for (let i = 0; i < arrCopy.length; i++) {
              
                      if (! isLikeEmpty(arrCopy[i])) {
              
                          let lpEntry = arrCopy[i];
                          let lineWithoutDate = lpEntry.substring(23);
                          let lpLineSplit = logLineSplit(lpEntry);
              
                          // Get multiple values
                          let lpMulti = arrayGetElements(arrCopy, removeLeading123entries(lpLineSplit.message), false);
                          let result = lpEntry;
                          let lineCounter = 0;
                          if (lpMulti.length > 1) { // Treffer - die aktuelle Zeile zählt ja auch mit.
                              lineCounter = lpMulti.length;
                              let hitLeadingNumber = -1;
                              for (let hitLine of lpMulti) {
                                  let hitLineSplit = logLineSplit(hitLine);
                                  // Check if hit contains '[123 entries]'. If yes, get the number out of it into lineCounter.
                                  // If not, we just count with 1.
                                  hitLeadingNumber = checkForMultiEntry(hitLineSplit.message);
                                  if (hitLeadingNumber > 1) {
                                      lineCounter = hitLeadingNumber + lpMulti.length - 1;
                                  }
                              }
                          } else {
                              lineCounter = 1;
                          }
              
                          if (lineCounter > 1) {
              
                                  // remove from array by filling empty value
                                  arrCopy = arrayReplaceElementsByValue(arrCopy, removeLeading123entries(lpLineSplit.message), '', false);
                                  // new result
                                  result = logLineMerge([lpLineSplit.datetime, lpLineSplit.level, lpLineSplit.source, '[' + lineCounter + ' ' + MERGE_LOGLINES_TXT + '] ' + removeLeading123entries(lpLineSplit.message)]);
                          }
                          arrNew.push(result);
                      } 
                  }
              
                  return arrNew;
              
                  /**
                   * @param  {string}   strInput    A log message with potential leading '[123 entries]'
                   * @return {string}   string without leading '[123 entries]', if it is there
                   */
                  function removeLeading123entries(strInput) {
              
                      let mRegEx = new RegExp(MERGE_REGEX_PATT);
                      let matches = mRegEx.exec(strInput);
                      if (matches === null) {
                          return strInput;
                      } else {
                          return matches[2];
                      }
                  }
              
                  /**
                   * @param  {string}   strInput    A log message checking for leading '[123 entries]'
                   * @return {number}   returns the number 123 from '[123 entries]' if any match, or -1 if not found
                   */
                  function checkForMultiEntry(strInput) {
              
                      // Get RegEx ready
                      let mRegEx = new RegExp(MERGE_REGEX_PATT);
                      let matches = mRegEx.exec(strInput);
                      if (matches === null) {
                          return -1;
                      } else {
                          return parseInt(matches[1]);
                      }
                  }
              
              }
              
              
              
              /*************
               * Get the file system path and filename of the current log file.
               * 
               * ioBroker creates a log file every midnight at 0:00 under '/opt/iobroker/log/'
               * Syntax of the log file is: iobroker.YYYY-MM-DD.log
               * This function returns the full path to the log file, considering the current date/time when this function is called.
               * @return {string}      Path and file name to log file.
               */
              function getCurrentFullFsLogPath() {
                  let strLogPathFinal = LOG_FS_PATH;
                  if (strLogPathFinal.slice(-1) !== '/') strLogPathFinal = strLogPathFinal + '/';
                  let strFullLogPath = strLogPathFinal + DEBUG_CUSTOM_FILENAME;
                  if (DEBUG_CUSTOM_FILENAME === '') strFullLogPath = strLogPathFinal + 'iobroker.' + getCurrentISODate() + '.log';
                  return strFullLogPath;
              }
              
              /**
               * Clear array: if stateForTimeStamp is greater or equal than log date, we remove the entire log entry
               * @param {array} inputArray     Array of log entries
               * @param {string} stateForTimeStamp     state of which we need the time stamp
               * @return {array} cleaned log
               */
              function clearJsonByDate(inputArray, stateForTimeStamp) {
                  let dtState = new Date(getState(stateForTimeStamp).ts);
                  if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'Time of last change of state [' + stateForTimeStamp + ']: ' + dtState);
                  let newArray = [];
                  for (let lpLog of inputArray) {
                      let dtLog = new Date(lpLog.substr(0,23));
                      if (dtLog.getTime() >= dtState.getTime()) {
                          newArray.push(lpLog);            
                      }
                }
                return newArray;
              }
              
              
              /**
               * Build an array of states we need to create.
               * @return {array} Array of states to be created. Format: see function createUserStates()
               */
              function buildNeededStates() {
              
                  let logCleanIDs = '';
                  let statesArray = [];
                  if (! isLikeEmpty(LOG_FILTER)) {
                      for(let i = 0; i < LOG_FILTER.length; i++) {
                          if (LOG_FILTER[i].id !== '') {
                              let lpIDClean = cleanseStatePath(LOG_FILTER[i].id);
                              logCleanIDs += ((logCleanIDs === '') ? '' : '; ') + lpIDClean;
              
                              statesArray.push({ id:'log' + lpIDClean + '.log', name:'Filtered Log - ' + lpIDClean, type:"string", role: "state", def: ""});
                              statesArray.push({ id:'log' + lpIDClean + '.logJSON', name:'Filtered Log - ' + lpIDClean + ' - JSON', type:"string", role: "state", def: ""});
                              statesArray.push({ id:'log' + lpIDClean + '.logJSONcount', name:'Filtered Log - Count of JSON ' + lpIDClean, role: "state", type:"number", def: 0});
                              statesArray.push({ id:'log' + lpIDClean + '.clearJSON', name:'Clear JSON log ' + lpIDClean, role: "button", type:"boolean", def: false});
              
                              /**
                               *  Backward compatibility & cleanup: removing states not needed
                               */
                              // State .logMostRecent removed with script version 2.0a onwards as it does not make sense any longer due to scheduled update
                              let lpRetiredState = FINAL_STATE_PATH + '.log' + lpIDClean + '.logMostRecent';
                              if (isState(lpRetiredState, true))  {
                                  deleteState(lpRetiredState);
                                  if (LOG_INFO) log('Remove retired state: ' + lpRetiredState, 'info');
                              }
                              // State .clearJSONtime removed with script version 1.2 onwards as we use now time stamp of button '.clearJSON'.
                              lpRetiredState = FINAL_STATE_PATH + '.log' + lpIDClean + '.clearJSONtime';
                              if (isState(lpRetiredState, true))  {
                                  deleteState(lpRetiredState);
                                  if (LOG_INFO) log('Remove retired state: ' + lpRetiredState, 'info');
                              }
              																																														  
                          }
                      }
                      if (LOG_DEBUG) log('createLogStates(): Clean IDs: ' + logCleanIDs);
                  }
              
                  let finalStates = [];
                  for (let s=0; s < statesArray.length; s++) {
                      finalStates.push([FINAL_STATE_PATH + '.' + statesArray[s].id, {
                          'name': statesArray[s].name,
                          'desc': statesArray[s].name,
                          'type': statesArray[s].type,
                          'read': true,
                          'write': true,
                          'role': statesArray[s].role,
                          'def': statesArray[s].def,
                      }]);
                  }
                  return finalStates;
              }
              
              /**
               * Converts a timestamp to log date format, like 2019-10-15 16:38:00.260.
               * @param {object}  timeStamp   The date/time timestamp to convert.
               * @return {string} The resulting log date format as string.
               */
              function timestampToLogDate(timeStamp) {
              
                  let date = new Date(timeStamp);
                  // Need to convert to local time as this time provided from onLog() is UTC
                  // https://stackoverflow.com/questions/6525538/convert-utc-date-time-to-local-date-time/18330682
                  let localDate = new Date(date.getTime() - date.getTimezoneOffset()*60*1000);
              
                  // Convert to ISO string, so like 2019-10-15T16:38:00.260Z
                  let strResult = localDate.toISOString();
              
                  // date.toISOString() adds T and Z, so we remove these letters, as the log do not show these.
                  strResult = strResult.replace('T', ' ');  // remove T
                  strResult = strResult.replace('Z', '');  // remove Z at the end
                  return strResult;
              
              }
              
              /**
               * Remove PID in log message 
               * The js-controller version 2.0+ adds the PID number inside brackets to the beginning of the message. We remove it here.
               * @param {string} msg   The log message, like: 'javascript.0 (123) Logtext 123 Logtext 123 Logtext 123 Logtext 123'
               */
              function removePID(msg) {
              
                  // First: Split source and message text. 
                  // Input is like: 'javascript.0 (123) Logtext 123 Logtext 123 Logtext 123 Logtext 123'
                  let regexp = /^(\S+)\s(.*)/;
                  let matches_array = msg.match(regexp);
                  let strFirst = matches_array[1];    // like 'javascript.0'
                  let strRest = matches_array[2];     // like '(123) Logtext 123 Logtext 123 Logtext 123 Logtext 123'
                  
                  // Next, we remove the PID
                  strRest = strRest.replace(/^\([0-9]{1,9}\)\s/, '');
              
                  // Last, we put the two strings together again
                  return strFirst + ' ' + strRest;
              
              }
              
              
              
              
              /*************************************************************************************************************************
               * onStop - Being executed once this ioBroker Script stops. 
               *************************************************************************************************************************/
              // This is to end the Tale. Not sure, if we indeed need it, but just in case...
              onStop(function myScriptStop () {
              
                  // Unsubscribe log handler
                  onLogUnregister(G_LogHandler);
                  if (LOG_INFO) log('Unsubscribed to Log Handler.', 'info');
              
              }, 0);
              
              
              
              /*************************************************************************************************************************
               * General supporting functions
               *************************************************************************************************************************/
              
              /**
               * Remove Duplicates from Array
               * Source - https://stackoverflow.com/questions/23237704/nodejs-how-to-remove-duplicates-from-array
               * @param {array} inputArray       Array to process
               * @return {array}  Array without duplicates.
               */
              function arrayRemoveDublicates(inputArray) {
                  let uniqueArray;
                  uniqueArray = inputArray.filter(function(elem, pos) {
                      return inputArray.indexOf(elem) == pos;
                  });
                  return uniqueArray;
              }
              
              /**
               * Clean Array: Removes all falsy values: undefined, null, 0, false, NaN and "" (empty string)
               * Source: https://stackoverflow.com/questions/281264/remove-empty-elements-from-an-array-in-javascript
               * @param {array} inputArray       Array to process
               * @return {array}  Cleaned array
               */
              function cleanArray(inputArray) {
                var newArray = [];
                for (let i = 0; i < inputArray.length; i++) {
                  if (inputArray[i]) {
                    newArray.push(inputArray[i]);
                  }
                }
                return newArray;
              }
              
              
              /**
               * Checks if Array or String is not undefined, null or empty.
               * 08-Sep-2019: added check for [ and ] to also catch arrays with empty strings.
               * @param inputVar - Input Array or String, Number, etc.
               * @return true if it is undefined/null/empty, false if it contains value(s)
               * Array or String containing just whitespaces or >'< or >"< or >[< or >]< is considered empty
               */
              function isLikeEmpty(inputVar) {
                  if (typeof inputVar !== 'undefined' && inputVar !== null) {
                      let strTemp = JSON.stringify(inputVar);
                      strTemp = strTemp.replace(/\s+/g, ''); // remove all whitespaces
                      strTemp = strTemp.replace(/\"+/g, "");  // remove all >"<
                      strTemp = strTemp.replace(/\'+/g, "");  // remove all >'<
                      strTemp = strTemp.replace(/\[+/g, "");  // remove all >[<
                      strTemp = strTemp.replace(/\]+/g, "");  // remove all >]<
                      if (strTemp !== '') {
                          return false;
                      } else {
                          return true;
                      }
                  } else {
                      return true;
                  }
              }
              
              /**
               * Returns the current date in ISO format "YYYY-MM-DD".
               * @return  {string}    Date in ISO format
               */
              function getCurrentISODate() {
                  let currDate = new Date();
                  return currDate.getFullYear() + '-' + zeroPad((currDate.getMonth() + 1), 2) + '-' + zeroPad(currDate.getDate(), 2);
              }
              
              /**
               * Fügt Vornullen zu einer Zahl hinzu, macht also z.B. aus 7 eine "007". 
               * zeroPad(5, 4);    // wird "0005"
               * zeroPad('5', 6);  // wird "000005"
               * zeroPad(1234, 2); // wird "1234" :)
               * @param  {string|number}  num     Zahl, die Vornull(en) bekommen soll
               * @param  {number}         places  Anzahl Stellen.
               * @return {string}         Zahl mit Vornullen wie gewünscht.
               */
              function zeroPad(num, places) {
                  let zero = places - num.toString().length + 1;
                  return Array(+(zero > 0 && zero)).join("0") + num;        
              } 
              
              
              /**
               * Will just keep lower case letters, numbers, '-' and '_' and removes the rest
               * Also, capitalize first Letter.
               */
              function cleanseStatePath(stringInput) {
                  let strProcess = stringInput;
                  strProcess = strProcess.replace(/([^a-z0-9_\-]+)/gi, '');
                  strProcess = strProcess.toLowerCase();
                  strProcess = strProcess.charAt(0).toUpperCase() + strProcess.slice(1);
                  return strProcess;
              
              }
              
              
              /**
               * Checks if the string provided contains either every or some terms.
               * Source: https://stackoverflow.com/questions/36283767/javascript-select-the-string-if-it-matches-multiple-words-in-array
               * @param {string} strInput - The string on which we run this search
               * @param {array} arrayTerms - The terms we are searching, e.g. ["hue", "error", "raspberry"]
               * @param {string} type - 'every': all terms must match to be true,
               *                        'some': at least one term (or more) must match
               *                        'blacklist': different here: function will always
               *                         return FALSE, but if one of the arrayTerms contains
               *                         minimum 3 chars and is found in provided string,
               *                         we return TRUE (= blacklisted item found).
               * @return {boolean}       true, if it contains ALL words, false if not all words (or none)
               *                         Also, will return true if arrayTerms is not array or an empty array
               */
              function strMatchesTerms(strInput, arrayTerms, type) {
                  if(type === 'blacklist') {
                      if (Array.isArray(arrayTerms)) {
                          let arrayTermsNew = [];
                          for (let lpTerm of arrayTerms) {
                              if (lpTerm.length >= 3) {
                                  arrayTermsNew.push(lpTerm);
                              }
                          }
                          if(isLikeEmpty(arrayTermsNew) === false) {
                              let bResultBL = arrayTermsNew.some(function(word) {
                                  return strInput.indexOf(word) > -1;
                              });
                              return bResultBL;
                          } else {
                              return false; // return false if no items to be blacklisted
                          }
                      } else {
                          return false; // we return false if the arrayTerms given is not an array. Want to make sure if we really should blacklist...
                      }
              
                  } else {
                      if (Array.isArray(arrayTerms)) {
                          if(type === 'every') {
                              let bResultEvery = arrayTerms.every(function(word) {
                                  return strInput.indexOf(word) > -1;
                              });
                              return bResultEvery;
                          } else if(type === 'some') {
                              let bResultSome = arrayTerms.some(function(word) {
                                  return strInput.indexOf(word) > -1;
                              });
                              return bResultSome;
                          }
              
                      } else {
                          return true; // we return true if the arrayTerms given is not an array
                      }
                  }
              }
              
              /**
               * Checks if a a given state or part of state is existing.
               * This is a workaround, as getObject() or getState() throw warnings in the log.
               * Set strict to true if the state shall match exactly. If it is false, it will add a wildcard * to the end.
               * See: https://forum.iobroker.net/topic/11354/
               * @param {string}    strStatePath     Input string of state, like 'javas-cript.0.switches.Osram.Bedroom'
               * @param {boolean}   [strict=true]    Optional: Default is true. If true, it will work strict, if false, it will add a wildcard * to the end of the string
               * @return {boolean}                   true if state exists, false if not
               */
              function isState(strStatePath, strict) {
              
                  if(strict === undefined) strict = true;
              
                  let mSelector;
                  if (strict) {
                      mSelector = $('state[id=' + strStatePath + '$]');
                  } else {
                      mSelector = $('state[id=' + strStatePath + ']');
                  }
                  if (mSelector.length > 0) {
                      return true;
                  } else {
                      return false;
                  }
              }
              
              
              /**
               * Removing Array element(s) by input value. 
               * @param {array}   arr             the input array
               * @param {string}  valRemove       the value to be removed
               * @param {boolean} [exact=true]    OPTIONAL: default is true. if true, it must fully match. if false, it matches also if valRemove is part of element string
               * @return {array}  the array without the element(s)
               */
              function arrayRemoveElementsByValue(arr, valRemove, exact) {
              
                  for ( let i = 0; i < arr.length; i++){ 
                      if (exact) {
                          if ( arr[i] === valRemove) {
                              arr.splice(i, 1);
                              i--; // required, see https://love2dev.com/blog/javascript-remove-from-array/
                          }
                      } else {
                          if (arr[i].indexOf(valRemove) != -1) {
                              arr.splice(i, 1);
                              i--; // see above
                          }
                      }
                  }
                  return arr;
              }
              
              /**
               * Escapes a string for use in RegEx as (part of) pattern
               * Source: https://stackoverflow.com/questions/3446170/escape-string-for-use-in-javascript-regex
               * @param {string} inputStr  The input string to be escaped
               * @return {string}  The escaped string
               */
              function escapeRegExp(inputStr) {
                  return inputStr.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
              }
              
              
              /**
               * Get all elements of an array if found
               * @param {array}   arr             the input array
               * @param {string}  valFind         the value to find
               * @param {boolean} [exact=true]    OPTIONAL: default is true. if true, it must fully match. if false, it matches also if valRemove is part of element string
               * @return {array}  an array with all hits or empty array if no hits.
               */
              function arrayGetElements(arr, valFind, exact) {
                  let resultArr = [];
                  for ( let i = 0; i < arr.length; i++){ 
                      if (exact) {
                          if ( arr[i] === valFind) {
                              resultArr.push(arr[i]);
                          }
                      } else {
                          if (arr[i].indexOf(valFind) != -1) {
                              resultArr.push(arr[i]);
                          }
                      }
                  }
                  return resultArr;
              }
              
              /**
               * Replace Array element(s) by input value. 
               * @param {array}   arr             the input array
               * @param {string}  valReplace      the value to search for
               * @param {string}  newValue        the new value
               * @param {boolean} [exact=true]    OPTIONAL: default is true. if true, it must fully match. if false, it matches also if valRemove is part of element string
               * @return {array}  the array with replaced the element(s)
               */
              function arrayReplaceElementsByValue(arr, valReplace, newValue, exact) {
              
                  for ( let i = 0; i < arr.length; i++){ 
                      if (exact) {
                          if ( arr[i] === valReplace) {
                              arr[i] = newValue;
                          }
                      } else {
                          if (arr[i].indexOf(valReplace) != -1) {
                              arr[i] = newValue;
                          }
                      }
                  }
                  return arr;
              }
              
              /**
               * Retrieve values from a CONFIG variable, example:
               * const CONF = [{car: 'bmw', color: 'black', hp: '250'}, {car: 'audi', color: 'blue', hp: '190'}]
               * To get the color of the Audi, use: getConfigValuePerKey(CONF, 'car', 'audi', 'color')
               * To find out which car has 190 hp, use: getConfigValuePerKey(CONF, 'hp', '190', 'car')
               * @param {object}  config     The configuration variable/constant
               * @param {string}  key1       Key to look for.
               * @param {string}  key1Value  The value the key should have
               * @param {string}  key2       The key which value we return
               * @returns {any}    Returns the element's value, or number -1 of nothing found.
               */
              function getConfigValuePerKey(config, key1, key1Value, key2) {
                  for (let lpConfDevice of config) {
                      if ( lpConfDevice[key1] === key1Value ) {
                          if (lpConfDevice[key2] === undefined) {
                              return -1;
                          } else {
                              return lpConfDevice[key2];
                          }
                      }
                  }
                  return -1;
              }
              
              
              /**
               * For a given state path, we extract the location '0_userdata.0' or 'javascript.0' or add '0_userdata.0', if missing.
               * @param {string}  path            Like: 'Computer.Control-PC', 'javascript.0.Computer.Control-PC', '0_userdata.0.Computer.Control-PC'
               * @param {boolean} returnFullPath  If true: full path like '0_userdata.0.Computer.Control-PC', if false: just location like '0_userdata.0' or 'javascript.0'
               * @return {string}                 Path
               */
              function validateStatePath(path, returnFullPath) {
                  if (path.startsWith('.')) path = path.substr(1);    // Remove first dot
                  if (path.endsWith('.'))   path = path.slice(0, -1); // Remove trailing dot
                  if (path.length < 1) log('Provided state path is not valid / too short.', 'error')
                  let match = path.match(/^((javascript\.([1-9][0-9]|[0-9])\.)|0_userdata\.0\.)/);
                  let location = (match == null) ? '0_userdata.0' : match[0].slice(0, -1); // default is '0_userdata.0'.
                  if(returnFullPath) {
                      return (path.indexOf(location) == 0) ? path : (location + '.' + path);
                  } else {
                      return location;
                  }
              }
              
              
              /**
               * Create states under 0_userdata.0 or javascript.x
               * Current Version:     https://github.com/Mic-M/iobroker.createUserStates
               * Support:             https://forum.iobroker.net/topic/26839/
               * Autor:               Mic (ioBroker) | Mic-M (github)
               * Version:             1.1 (26 January 2020)
               * Example:             see https://github.com/Mic-M/iobroker.createUserStates#beispiel
               * -----------------------------------------------
               * PLEASE NOTE: Per https://github.com/ioBroker/ioBroker.javascript/issues/474, the used function setObject() 
               *              executes the callback PRIOR to completing the state creation. Therefore, we use a setTimeout and counter. 
               * -----------------------------------------------
               * @param {string} where          Where to create the state: '0_userdata.0' or 'javascript.x'.
               * @param {boolean} force         Force state creation (overwrite), if state is existing.
               * @param {array} statesToCreate  State(s) to create. single array or array of arrays
               * @param {object} [callback]     Optional: a callback function -- This provided function will be executed after all states are created.
               */
              function createUserStates(where, force, statesToCreate, callback = undefined) {
               
                  const WARN = false; // Only for 0_userdata.0: Throws warning in log, if state is already existing and force=false. Default is false, so no warning in log, if state exists.
                  const LOG_DEBUG = false; // To debug this function, set to true
                  // Per issue #474 (https://github.com/ioBroker/ioBroker.javascript/issues/474), the used function setObject() executes the callback 
                  // before the state is actual created. Therefore, we use a setTimeout and counter as a workaround.
                  const DELAY = 50; // Delay in milliseconds (ms). Increase this to 100, if it is not working.
              
                  // Validate "where"
                  if (where.endsWith('.')) where = where.slice(0, -1); // Remove trailing dot
                  if ( (where.match(/^((javascript\.([1-9][0-9]|[0-9]))$|0_userdata\.0$)/) == null) ) {
                      log('This script does not support to create states under [' + where + ']', 'error');
                      return;
                  }
              
                  // Prepare "statesToCreate" since we also allow a single state to create
                  if(!Array.isArray(statesToCreate[0])) statesToCreate = [statesToCreate]; // wrap into array, if just one array and not inside an array
              
                  // Add "where" to STATES_TO_CREATE
                  for (let i = 0; i < statesToCreate.length; i++) {
                      let lpPath = statesToCreate[i][0].replace(/\.*\./g, '.'); // replace all multiple dots like '..', '...' with a single '.'
                      lpPath = lpPath.replace(/^((javascript\.([1-9][0-9]|[0-9])\.)|0_userdata\.0\.)/,'') // remove any javascript.x. / 0_userdata.0. from beginning
                      lpPath = where + '.' + lpPath; // add where to beginning of string
                      statesToCreate[i][0] = lpPath;
                  }
              
                  if (where != '0_userdata.0') {
                      // Create States under javascript.x
                      let numStates = statesToCreate.length;
                      statesToCreate.forEach(function(loopParam) {
                          if (LOG_DEBUG) log('[Debug] Now we are creating new state [' + loopParam[0] + ']');
                          let loopInit = (loopParam[1]['def'] == undefined) ? null : loopParam[1]['def']; // mimic same behavior as createState if no init value is provided
                          createState(loopParam[0], loopInit, force, loopParam[1], function() {
                              numStates--;
                              if (numStates === 0) {
                                  if (LOG_DEBUG) log('[Debug] All states processed.');
                                  if (typeof callback === 'function') { // execute if a function was provided to parameter callback
                                      if (LOG_DEBUG) log('[Debug] Function to callback parameter was provided');
                                      return callback();
                                  } else {
                                      return;
                                  }
                              }
                          });
                      });
                  } else {
                      // Create States under 0_userdata.0
                      let numStates = statesToCreate.length;
                      let counter = -1;
                      statesToCreate.forEach(function(loopParam) {
                          counter += 1;
                          if (LOG_DEBUG) log ('[Debug] Currently processing following state: [' + loopParam[0] + ']');
                          if( ($(loopParam[0]).length > 0) && (existsState(loopParam[0])) ) { // Workaround due to https://github.com/ioBroker/ioBroker.javascript/issues/478
                              // State is existing.
                              if (WARN && !force) log('State [' + loopParam[0] + '] is already existing and will no longer be created.', 'warn');
                              if (!WARN && LOG_DEBUG) log('[Debug] State [' + loopParam[0] + '] is already existing. Option force (=overwrite) is set to [' + force + '].');
                              if(!force) {
                                  // State exists and shall not be overwritten since force=false
                                  // So, we do not proceed.
                                  numStates--;
                                  if (numStates === 0) {
                                      if (LOG_DEBUG) log('[Debug] All states successfully processed!');
                                      if (typeof callback === 'function') { // execute if a function was provided to parameter callback
                                          if (LOG_DEBUG) log('[Debug] An optional callback function was provided, which we are going to execute now.');
                                          return callback();
                                      }
                                  } else {
                                      // We need to go out and continue with next element in loop.
                                      return; // https://stackoverflow.com/questions/18452920/continue-in-cursor-foreach
                                  }
                              } // if(!force)
                          }
              
                          // State is not existing or force = true, so we are continuing to create the state through setObject().
                          let obj = {};
                          obj.type = 'state';
                          obj.native = {};
                          obj.common = loopParam[1];
                          setObject(loopParam[0], obj, function (err) {
                              if (err) {
                                  log('Cannot write object for state [' + loopParam[0] + ']: ' + err);
                              } else {
                                  if (LOG_DEBUG) log('[Debug] Now we are creating new state [' + loopParam[0] + ']')
                                  let init = null;
                                  if(loopParam[1].def === undefined) {
                                      if(loopParam[1].type === 'number') init = 0;
                                      if(loopParam[1].type === 'boolean') init = false;
                                      if(loopParam[1].type === 'string') init = '';
                                  } else {
                                      init = loopParam[1].def;
                                  }
                                  setTimeout(function() {
                                      setState(loopParam[0], init, true, function() {
                                          if (LOG_DEBUG) log('[Debug] setState durchgeführt: ' + loopParam[0]);
                                          numStates--;
                                          if (numStates === 0) {
                                              if (LOG_DEBUG) log('[Debug] All states processed.');
                                              if (typeof callback === 'function') { // execute if a function was provided to parameter callback
                                                  if (LOG_DEBUG) log('[Debug] Function to callback parameter was provided');
                                                  return callback();
                                              }
                                          }
                                      });
                                  }, DELAY + (20 * counter) );
                              }
                          });
                      });
                  }
              }
              
              MicM 1 Antwort Letzte Antwort
              0
              • P PatrickFro

                @Mic Ich habe keine Änderungen vorgenommen, 1:1 übernommen. Steht ja im Script, dass es auch so schon funktionieren sollte ;-)

                /*************************************************************************************************************************
                 * ---------------------------
                 * Log Script für ioBroker zum Aufbereiten des Logs für Visualisierungen (vis), oder um
                 * auf Log-Ereignisse zu reagieren.
                 * ---------------------------
                 *
                 * Das Script nimmt jeden neuen Logeintrag des ioBrokers und wendet entsprechend gesetzte
                 * Filter an, um den Eintrag dann in den entsprechenden Datenpunkten dieses Scripts abzulegen.
                 
                 * Es stehen auch JSON-Datenpunkte zur Verfügung, mit diesen kann im vis eine
                 * Tabelle ausgegeben werden (z.B. über das Widget 'basic - Table' oder 'materialdesign - Table').
                 *
                 * Aktuelle Version: https://github.com/Mic-M/iobroker.logfile-script
                 * Support:          https://forum.iobroker.net/topic/13971/vorlage-log-datei-aufbereiten-f%C3%BCr-vis-javascript
                 * Autor:            Mic (ioBroker) | Mic-M (github)
                 * -----------------------------------------------------------------------------------------------------------------------
                 * VORAUSSETZUNGEN
                 * 1.) Nur falls Datenpunkte unterhalb '0_userdata.0' abgelegt werden sollen:
                 *     In der Instanz des JavaScript-Adapters die Option [Erlaube das Kommando "setObject"] aktivieren.
                 *     Siehe auch: https://github.com/Mic-M/iobroker.createUserStates
                 * 2.) Dieses Script benötigt die JavaScript-Adapter-Version 4.3.0 (2019-10-09) oder höher.
                 *     Wer eine ältere Version einsetzt: Bitte Script-Version 2.0.2 verwenden.
                 * =====================================================================================
                 * -----------------------------------------------------------------------------------------------------------------------
                 * Change Log:
                 *  4.0.1 Mic   - Add "jsonDateFormat: 'dd.mm. hh:mm'," to FILTER_LOG, id 'all'.
                 *  4.0 Mic     + To allow individual settings per each defined LOG_FILTER, the following global 
                 *                settings were moved to LOG_FILTER:
                 *                 * JSON_DATE_FORMAT                   -> jsonDateFormat
                 *                 * JSON_LEN                           -> jsonLogLength
                 *                 * JSON_NO_ENTRIES                    -> jsonMaxLines
                 *                 * JSON_APPLY_CSS_LIMITED_TO_LEVEL    -> jsonCssToLevel
                 *                 * L_SORT_ORDER_DESC                  -> sortDescending
                 *              + Code improvements
                 *              + Renamed LOG_NO_OF_ENTRIES to MAX_LOG_LINES
                 *  ---------------------------------------------------------------------------------------------------- 
                 *  3.4 Mic     + Support both '0_userdata.0' and 'javascript.x' for state creation
                 *  3.3 Mic     - Fix state path
                 *  3.2 Mic     + Create all states under 0_userdata.0, and no longer under javascript.<instance> (like javascript.0)
                 *  3.1 Mic     + Change to stable as tests were successful
                 *              + Add new option REMOVE_PID: The js-controller version 2.0+ adds the PID number inside brackets 
                 *                to the beginning of the message. Setting REMOVE_PID = false will remove it.
                 *  3.0Alpha Mic + Major Change: JavaScript adapter 4.3+ now provides onLog() function: 
                 *                 https://github.com/ioBroker/ioBroker.javascript/blob/master/docs/en/javascript.md#onlog 
                 *                 We are using this new function to streamline this log script tremendously and to remove node-tail.
                 *  ---------------------------------------------------------------------------------------------------- 
                 *  2.0.2 Mic   + Changed certain functions to async to get rid of setTimout() and for the sake of better error handling.
                 *              + startTailingProcess(): ensure the tailing starts if the file is present (wait to be created)
                 *  2.0.1a Mic  Removed constant MERGE_LOGLINES_ACTIVE
                 *  2.0.0a Mic  Major improvements and fixes:
                 *              + Change from instant state update to schedule (STATE_UPDATE_SCHEDULE). The instant update, so once
                 *                new log entries coming in, caused several issues (setting and getting state values (getState() and 
                 *                setState()) within <1ms simply does not work.
                 *              - Fix issue with merging log lines
                 *              + Moved global option MERGE_LOGLINES_ACTIVE to LOG_FILTER, for allowing turning on/off for each filter id.
                 *              + Several other code improvements
                 *              Note: For upgrading from previous version: replace script entirely, re-enter all your options, 
                 *                    and delete all existing states prior to first activation of this script.
                 *  ---------------------------------------------------------------------------------------------------- 
                 *  1.5.1 Mic - Set option MERGE_LOGLINES_ACTIVE to 'false' as default, as users reported issues. See 
                 *              https://forum.iobroker.net/post/288772 . Also option MERGE_LOGLINES_ACTIVE being marked as "experimental"
                 *              in the comments. Requires further investigation.
                 *  1.5  Mic - Fix issue with option MERGE_LOGLINES_ACTIVE
                 *  1.4  Mic + New option MERGE_LOGLINES_TXT for an individual (e.g. localized) string other than 'entries'.
                             - Fix JSON span class closing
                 *  1.3  Mic + New option MERGE_LOGLINES_ACTIVE: Merge Loglines with same log message to only one line and adds leading
                 *             '[123 entries]' to log message.
                 *  1.2  Mic - Fixed issue #6 (Button javascript.0.Log-Script.logXxxx.clearJSON not working reliably)
                 *  1.1  Mic + 1. 1.0x script seems to work reliable per user feedback and my own test, so pushing into 1.1 stable.
                 *           + New state '.logMostRecent': provides just the most recent log entry to work with "on /
                 *             subscribe" on this state and trigger actions accordingly.
                 *  1.02 alpha  Mic  - fix restarting at 0:00 (note: restarting is needed due to log file name change)
                 *  1.01 alpha  Mic  - fix: creating new file system log file only if not yet existing
                 *  1.00 alpha  Mic  + Entirely recoded to implement node-tail (https://github.com/lucagrulla/node-tail).
                 *  ----------------------------------------------------------------------------------------------------
                 *  0.8.1 Mic - Fix: L_SORT_ORDER_DESC was not defined (renamed constant name was not changed in config)
                 *  0.8 Mic - Fix: Script caused a "file not found" error if executed right at or shortly after midnight.
                 *  0.7 Mic - Fix: States "...clearDateTime" will not get an initial date value on first script start,
                 *                 also fix for "on({id: ".
                 *  0.6 Mic + Put 0.5.1 BETA into stable
                 *          + New option L_APPLY_CSS. If true, it will add <span class='log-info'>xxx</span>
                 *            to each log string. 'log-info' for level info, 'log-error' for error, etc.
                 *            This makes it easy to format a JSON table with CSS.
                 *  0.5.1 BETA Mic + New States "Clear JSON log ..." and "Clear JSON log - Date/Time ...".
                 *                   When the button "Clear JSON log" is pushed, the current date/time
                 *                   will be set into the date/time state. Once refreshed
                 *                   (per schedule in the script, e.g. after 2 minutes), the JSON
                 *                   will be cleaned and display just newer logs.
                 *                   Use Case: In vis, you can now add a button "clear log" or
                 *                   "Mark as read". If you hit the button, the log will be
                 *                   cleared and just new log items will be displayed.
                 *                   *** THIS IS STILL BEING TESTED *** therefore a beta release...
                 *  0.5  Mic + New parameter 'clean' to remove certain strings
                 *             from the log line.
                 *           + New parameter 'columns' for JSON output to specify which columns
                 *             to be shown, and in which order.
                 *           + New state "JSONcount" to have the number of log lines in state
                 *           - Fixed a few issues
                 *  0.4  Mic - Bug fix: improved validation of log line consistency
                 *  0.3  Mic + Added filtering and blacklist
                 *           - Several fixes
                 *  0.2  Mic - Bug fix: corrected wrong function name
                 *  0.1  Mic * Initial release
                 ************************************************************************************************************************/
                
                /*******************************************************************************
                 * Konfiguration: Pfade
                 ******************************************************************************/
                // Pfad, unter dem die States (Datenpunkte) in den Objekten angelegt werden.
                // Es wird die Anlage sowohl unterhalb '0_userdata.0' als auch 'javascript.x' unterstützt.
                const LOG_STATE_PATH = '0_userdata.0.Log-Script';
                
                
                // Pfad zum Log-Verzeichnis auf dem Server.
                // Standard-Pfad unter Linux: '/opt/iobroker/log/'. Wenn das bei dir auch so ist, dann einfach belassen.
                const LOG_FS_PATH = '/opt/iobroker/log/';
                
                /*******************************************************************************
                 * Konfiguration: Alle Logeinträge - Global
                 ******************************************************************************/
                
                // Zahl: Maximale Anzahl der letzten Logeinträge in den Datenpunkten. Alle älteren werden entfernt.
                // Bitte nicht allzu viele behalten, denn das kostet Performance.
                const MAX_LOG_LINES = 100;
                
                // Der js-Controller Version 2.0 oder größer fügt Logs teils vorne die PID in Klammern hinzu, 
                // also z.B. "(12234) Terminated (15): Without reason". 
                // Mit dieser Option lassen sich die PIDs aus den Logzeilen entfernen.
                const REMOVE_PID = true;
                
                /**
                 * Schwarze Liste (Black list)
                 * Falls einer dieser Satzteile/Begriffe in einer Logzeile enthalten ist, dann wird der Log-Eintrag
                 * komplett ignoriert, egal was weiter unten eingestellt wird.
                 * Dies dient dazu, um penetrante Logeinträge gar nicht erst zu berücksichtigen.
                 * Bitte beachten: 
                 * 1. Mindestens 3 Zeichen erforderlich, sonst wird es nicht berücksichtigt (würde auch wenig Sinn ergeben).
                 * 2. Bestehende Datenpunkt-Inhalte dieses Scripts bei Anpassung dieser Option werden nicht nachträglich neu gefiltert,
                 *    sondern nur alle neu hinzugefügten Log-Einträge ab Speichern des Scripts werden berücksichtigt.
                 */
                const BLACKLIST_GLOBAL = [
                    '<==Disconnect system.user.admin from ::ffff:', // web.0 Adapter
                    'system.adapter.ical.0 terminated with code 0 (OK)', 
                    'bring.0 Cannot get translations: RequestError',
                    ' reconnected. Old secret ', // Sonoff
                    'Popup-News readed...', // info.0 Adapter
                    '[warn] Projects disabled : set editorTheme.projects.enabled=true to enable', // see https://forum.iobroker.net/topic/12260/
                	'',
                	'',
                ];
                
                /**
                 * Zusatz-Einstellung für Option "merge" für LOG_FILTER (unter "Konfiguration: Datenpunkte und Filter"):
                 * In MERGE_LOGLINES_TXT kann hier ein anderes Wort eingetragen werden, z.B. 'entries' oder 'Zeilen', damit [123 entries] 
                 * oder [123 Zeilen] vorangestellt wird anstatt [123 Einträge].
                 * HINWEIS: Falls MERGE_LOGLINES_TXT geändert wird: bitte alle Datenpunkte des Scripts löschen und dann Script neu starten.
                 */
                const MERGE_LOGLINES_TXT = 'Einträge';
                
                /**
                 *  Für JSON-Tabelle: Füge CSS-Klasse hinzu je nach Log-Level (debug, silly, info, warn und error), um Tabellen-Text zu formatieren.
                 *  Beispiel für Log-Level "debug": ersetzt "xxx" durch "<span class='log-debug'>xxx</span>""
                 *  Es wird jeweils "log-" vorangestellt, also: debug -> log-debug, silly -> log-silly, info -> log-info, etc.
                 *  Etwa für Widget "basic - Table" im vis können im Reiter "CSS" z.B. folgende Zeilen hinzugefügt werden,
                 *  um Warnungen in oranger und Fehler in roter Farbe anzuzeigen.
                 *         .log-warn { color: orange; }
                 *         .log-error { color: red; }
                 *  Tipp: In LOG_FILTER kann dann bei den einzelnen Filtern mittels "jsonCssToLevel" eingestellt werden, dass das CSS
                 *        nur  für die Spalte "level" (also debug, error, info) und nicht auf alle Spalten angewendet wird.
                 */
                const JSON_APPLY_CSS = true;
                
                
                /*******************************************************************************
                 * Konfiguration: Datenpunkte und Filter
                 ******************************************************************************
                 * Dies ist das Herzstück dieses Scripts: hier werden die Datenpunkte konfiguriert, die erstellt werden sollen. 
                 * Hierbei kannst du entsprechend Filter setzen, also z.B. Wörter/Begriffe, die in Logeinträgen enthalten sein
                 * müssen, damit sie in den jeweiligen Datenpunkten aufgenommen werden.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * id:              Ein Begriff ohne Leerzeichen, z.B. "error", "sonoff", homematic, etc. Die ID wird dann Teil der
                 *                  Datenpunkte, z.B. "javascript.0.Log-Script.logHomematic.log" mit automatisch vorangestelltem "log".
                 * --------------------------------------------------------------------------------------------------------------------------
                 * filter_all:      ALLE Begriffe müssen in der Logzeile enthalten sein. Ist einer der Begriffe nicht enthalten, dann wird der 
                 *                  komplette Logeintrag auch nicht übernommen. Leeres Array [] eingeben, falls hier filtern nicht gewünscht.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * filter_any:      Mindestens einer der gelisteten Begriffe muss enthalten sein. Leeres Array [] eingeben, falls hier filtern
                 *                  nicht gewünscht.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * blacklist:       Schwarze Liste: Wenn einer dieser Begriffe im Logeintrag enthalten ist, so wird der komplette Logeintrag 
                 *                  nicht übernommen, egal was vorher in filter_all oder filter_any definiert ist.
                 *                  Mindestens 3 Zeichen erforderlich, sonst wird es nicht berücksichtigt.
                 *                  HINWEIS: BLACKLIST_GLOBAL wird vorher schon angewendet, hier kannst du einfach nur noch eine individuelle 
                 *                  Blackliste pro id definieren.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * clean:           Der Log-Eintrag wird um diese Zeichenfolgen bereinigt, d.h. diese werden entfernt, aber die restliche Zeile 
                 *                  bleibt bestehen. Z.B. um unerwünschte Zeichenfolgen zu entfernen oder Log-Ausgaben zu kürzen.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * merge:           Log-Einträge mit gleichem Text zusammenfassen. Beispiel:
                 *                      -----------------------------------------------------------------------------------
                 *                      2019-08-17 20:00:00.335 - info: javascript.0 script.js.Wetter: Wetterdaten abrufen.
                 *                      2019-08-17 20:15:00.335 - info: javascript.0 script.js.Wetter: Wetterdaten abrufen.
                 *                      2019-08-17 20:30:00.335 - info: javascript.0 script.js.Wetter: Wetterdaten abrufen.
                 *                      -----------------------------------------------------------------------------------
                 *                  Daraus wird dann nur noch eine Logzeile mit letztem Datum/Uhrzeit und hinzufügen von "[3 Einträge]":
                 *                      -----------------------------------------------------------------------------------
                 *                      2019-08-17 20:30:00.335 - info: javascript.0 [3 Einträge] script.js.Wetter: Wetterdaten abrufen.
                 *                      -----------------------------------------------------------------------------------
                 *                  Zum aktivieren: true eintragen, zum deaktivieren: false eintragen.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * sortDescending:  Wenn true: Sortiert die Logeinträge absteigend, also neuester oben. 
                 *                  Wenn false: Sortiert die Logeinträge aufsteigend, also ältester oben. 
                 * --------------------------------------------------------------------------------------------------------------------------
                 * jsonColumns:     Nur für JSON (für vis). 
                 *                  Folgende Spalten gibt es: 'date','level','source','msg'. Hier können einzelne Spalten entfernt oder die 
                 *                  Reihenfolge verändert werden. Bitte keine anderen Spalten eintragen, sondern nur 'date','level','source','msg'.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * jsonDateFormat:  Datumsformat für JSON Log. Z.B. volles Datum mit 'YYYY-MM-DD HH:MM:SS' oder nur Uhrzeit mit "HH:MM:SS". Die 
                 *                  Platzhalter YYYY, MM, DD usw. werden jeweils ersetzt.
                 *                  YYYY = Jahr 4stellig (z.B. 2019), YY = Jahr 2stellig (z.B. 19), MM = Monat, DD = Tag, HH = Stunde, MM = Minute, 
                 *                  SS = Sekunde. Groß- oder Kleinschreibung ist egal, d.h. YYYY ist das gleiche wie yy.
                 *                  Die Verbinder (-, :, Leerzeichen, etc.) können im Prinzip frei gewählt werden.
                 *                  Beispiele: 'HH:MM:SS' für 19:37:25, 'HH:MM' für 19:37, 'DD.MM. HH:MM' für '25.07. 19:37'
                 * --------------------------------------------------------------------------------------------------------------------------
                 * jsonLogLength:   Maximale Anzahl Zeichen jeder einzelnen Log-Meldung im JSON-Log. Alles was länger ist, wird abgeschnitten.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * jsonMaxLines:    Maximale Anzahl der letzten Logeinträge im JSON-Log. Alle älteren werden entfernt.
                 *                  Falls in MAX_LOG_LINES z.B. "100" gesetzt wird, wird hier bei 100 der Cut gemacht, selbst wenn in 
                 *                  jsonMaxLines etwa 250 eingetragen wird. D.h. im Bedarf zuerst MAX_LOG_LINES anpassen/erhöhen.
                 * --------------------------------------------------------------------------------------------------------------------------
                 * jsonCssToLevel:  Wenn true, dann wird JSON_APPLY_CSS nur für die Spalte "level" (also debug, error, info) angewendet, 
                 *                  aber nicht für die restlichen Spalten wie Datum, Log-Eintrag, etc.
                                    Falls alle Spalten das CSS bekommen sollen: auf false setzen.
                 * --------------------------------------------------------------------------------------------------------------------------
                 *
                 * WEITERER HINWEIS: 
                 * Bestehende Datenpunkt-Inhalte dieses Scripts bei Anpassung dieser Option werden nicht nachträglich neu 
                 * gefiltert, sondern nur alle neu hinzugefügten Log-Einträge ab Speichern des Scripts werden berücksichtigt.
                 * --------------------------------------------------------------------------------------------------------------------------
                 */
                const LOG_FILTER = [
                
                  // Beispiel für individuellen Eintrag. Hier wird euer Hubschrauber-Landeplatz überwacht :-) Wir wollen nur Einträge 
                  // vom Adapter 'hubschr.0'. Dabei sollen entweder Wetterwarnungen, Alarme, oder UFOs gemeldet werden. Alles unter 
                  // Windstärke "5 Bft" interessiert uns dabei nicht, daher haben wir '0 Bft' bis '4 Bft' auf die Blackliste gesetzt.
                  // Außerdem entfernen wir von der Log-Zeile die Zeichenfolgen '****', '!!!!' und 'ufo gesichtet', der Rest bleibt 
                  // aber bestehen. Zudem haben wir unter jsonColumns die Spaltenreihenfolge geändert. 'level' herausgenommen, und Quelle 
                  // ganz vorne.
                /*
                  {
                    id:             'hubschrauberlandeplatz',
                    filter_all:     ['hubschr.0'],
                    filter_any:     ['wetterwarnung', 'alarm', 'ufo'],
                    blacklist:      ['0 Bft', '1 Bft', '2 Bft', '3 Bft', '4 Bft'],
                    clean:          ['****', '!!!!', 'ufo gesichtet'],
                    merge:          true,
                    sortDescending: true,
                    jsonDateFormat: 'dd.mm. hh:mm',       
                    jsonColumns:    ['source','date','msg'],
                    jsonLogLength:  100,
                    jsonMaxLines:   10,
                    jsonCssToLevel: true,
                  }, 
                */
                
                /*
                  {
                    id:             'all',    // Beispiel "all": hier kommen alle Logeinträge rein, keine Filterung
                    filter_all:     ['', ''], // wird ignoriert, wenn leer
                    filter_any:     ['', ''], // wird ignoriert, wenn leer
                    blacklist:      ['', ''], // wird ignoriert, wenn leer
                    clean:          ['', '', ''], // wird ignoriert, wenn leer
                    merge:          true,
                    sortDescending: true,
                    jsonDateFormat: 'dd.mm. hh:mm',       
                    jsonColumns:    ['date','level','source','msg'],  // Spaltenreihenfolge für JSON (Tabelle in vis)
                    jsonLogLength:  100,
                    jsonMaxLines:   10,
                    jsonCssToLevel: true,
                  },
                */
                  {
                    id:             'info',
                    filter_all:     [' - info: '], // nur Logeinträge mit Level 'info'
                    filter_any:     ['', ''],
                    blacklist:      ['', ''],
                    clean:          ['', '', ''],
                    merge:          true,
                    sortDescending: true,
                    jsonDateFormat: 'dd.mm. hh:mm',
                    jsonColumns:    ['date','level','source','msg'],
                    jsonLogLength:  100,
                    jsonMaxLines:   60,
                    jsonCssToLevel: true,
                  },
                  {
                    id:             'error',
                    filter_all:     [' - error: ', ''],  // nur Logeinträge mit Level 'error'
                    filter_any:     [''],
                    blacklist:      ['', '', ''],
                    clean:          ['', '', ''],
                    merge:          true,
                    sortDescending: true,
                    jsonColumns:    ['date','level','source','msg'],
                    jsonDateFormat: 'dd.mm. hh:mm',
                    jsonLogLength:  100,
                    jsonMaxLines:   60,
                    jsonCssToLevel: true,
                  },
                  {
                    id:             'warnanderror',
                    filter_all:     ['', ''],
                    filter_any:     [' - error: ', ' - warn: '],  // nur Logeinträge mit Levels 'warn' und 'error'
                    blacklist:      ['', 'no playback content', 'Ignore! Actual secret is '],
                    clean:          ['', '', ''],
                    merge:          true,
                    sortDescending: true,
                    jsonDateFormat: 'dd.mm. hh:mm',
                    jsonColumns:    ['date','level','source','msg'],
                    jsonLogLength:  100,
                    jsonMaxLines:   60,
                    jsonCssToLevel: true,
                  },
                  {
                    // Beispiel, um einen bestimmten Adapter zu überwachen.
                    // Hier werden alle Fehler und Warnungen des Homematic-Adapters hm-rpc.0 gelistet.
                    id:             'homematic',
                    filter_all:     ['hm-rpc.0', ''],  // hm-rpc.0 muss enthalten sein.
                    filter_any:     [' - error: ', ' - warn: '],  // entweder error oder warn
                    blacklist:      ['', '', ''],
                    clean:          ['', '', ''],
                    merge:          true,
                    sortDescending: true,
                    jsonDateFormat: 'dd.mm. hh:mm',
                    jsonColumns:    ['date','level','source','msg'],
                    jsonLogLength:  100,
                    jsonMaxLines:   60,
                    jsonCssToLevel: true,
                  },
                
                ];
                
                
                /*******************************************************************************
                 * Konfiguration: Konsolen-Ausgaben
                 ******************************************************************************/
                
                // Auf true setzen, wenn zur Fehlersuche einige Meldungen ausgegeben werden sollen.
                // Ansonsten bitte auf false stellen.
                const LOG_DEBUG = false;
                
                // Auf true setzen, wenn ein paar Infos dieses Scripts im Log ausgegeben werden dürfen, bei false bleiben die Infos komplett weg.
                const LOG_INFO = true;
                
                
                /*******************************************************************************
                 * Experten-Konfiguration
                 ******************************************************************************/
                
                // Wie oft Datenpunkte aktualisieren?
                // Neu reinkommende Logeinträge werden erst mal gesammelt (in Variable G_NewLogLinesArrayToProcess). Diese werden dann 
                // regelmäßig in den Datenpunkten geschrieben. Sinnvoll ist hier nicht kürzer als 2-3 Sekunden, und nicht länger als 
                // ein paar Minuten. Zu kurzes Intervall: Script kommt nicht mehr nach. Zu lange: falls viele Logeinträge reinkommen, 
                // kann sich vieles "aufstauen" zur Abarbeitung. Benutze den "Cron"-Button oben rechts für komfortable Einstellung.
                const STATE_UPDATE_SCHEDULE = '*/20 * * * * *'; // alle 20 Sekunden
                
                
                // Leer lassen! Nur setzen, falls ein eigener Filename für das Logfile verwendet wird für Debug.
                const DEBUG_CUSTOM_FILENAME = '';
                
                // Regex für die Aufteilung des Logs in 1-Datum/Zeit, 3-Level, 5-Quelle und 7-Logtext.
                // Ggf. anzupassen bei anderem Datumsformat im Log. Wir erwarten ein Format
                // wie z.B.: '2018-07-22 12:45:02.769  - info: javascript.0 Stop script script.js.ScriptAbc'
                // Da als String, wurden alle Backslashes "\" mit einem zweiten Backslash escaped.
                const LOG_PATT =  '([0-9_.\\-:\\s]*)(\\s+\\- )(silly|debug|info|warn|error|)(: )([a-z0-9.\\-]*)(\\s)(.*)';
                
                // Debug: Ignore. Wenn dieses String in der Logzeile enthalten ist, dann ignorieren wir es.
                // Dient dazu, dass wir während des Scripts ins Log schreiben können, ohne dass das dieses Script berücksichtigt.
                const DEBUG_IGNORE_STR = '[LOGSCRIPT_IGNORE]'; // Muss ein  individuelles String sein. Sonst gibt es ggf. eine Endlos-Schleife.
                
                
                // Debug: Prüfen, ob jede Logzeile erfasst wird, in dem wir diese direkt danach noch mal ins Log schreiben.
                // Bitte nur auf Anweisung vom Entwickler einschalten. Sonst wird jeder Logeintrag noch einmal wiederholt, 
                // mit führendem DEBUG_EXTENDED_STR am Anfang und max. DEBUG_EXTENDED_NO_OF_CHARS an Anzahl Zeichen.
                const DEBUG_EXTENDED = false;
                const DEBUG_EXTENDED_STR = '[LOGSCRIPT_DEBUG_EXTENDED]'; // Muss ein  individuelles String sein. Sonst gibt es ggf. eine Endlos-Schleife.
                const DEBUG_EXTENDED_NO_OF_CHARS = 120;
                
                
                
                /*************************************************************************************************************************
                 * Ab hier nichts mehr ändern / Stop editing here!
                 *************************************************************************************************************************/
                
                
                /*************************************************************************************************************************
                 * Global variables and constants
                 *************************************************************************************************************************/
                
                // Final state path
                const FINAL_STATE_LOCATION = validateStatePath(LOG_STATE_PATH, false);
                const FINAL_STATE_PATH = validateStatePath(LOG_STATE_PATH, true);
                
                
                // Merge loglines: define pattern (and escape the merge text)
                // We added an additional backslash '\' to each backslash as these need to be escaped.
                const MERGE_REGEX_PATT = '^\\[(\\d+)\\s' + escapeRegExp(MERGE_LOGLINES_TXT) + '\\]\\s(.*)';
                
                // Log Handler variable for ioBroker function onLog()
                let G_LogHandler;  // being set later
                
                // Schedule for logfile update
                let G_Schedule_StateUpdate; // being set later
                
                // We add here all the new log lines to be processed regularly (per STATE_UPDATE_SCHEDULE);
                let G_NewLogLinesArrayToProcess = [];
                
                /*************************************************************************************************************************
                 * init - This is executed on every script (re)start.
                 *************************************************************************************************************************/
                init();
                function init() {
                
                    // Unsubscribe log handler
                    onLogUnregister(G_LogHandler);
                    
                    // Create all script states
                    createUserStates(FINAL_STATE_LOCATION, false, buildNeededStates(), function() {
                        // -- All states created, so we continue by using callback
                
                        // Subscribe on changes: Pressed button "clearJSON"
                        subscribeClearJson();
                
                        // Subscribe to log handler
                        G_LogHandler = onLog('*', data => { // please disregard the red squiggly underline under '*', see Github issue: https://github.com/ioBroker/ioBroker.javascript/issues/457
                            processNewLogLine(data);
                        });
                
                        // Schedule writing changes into states
                        clearSchedule(G_Schedule_StateUpdate);
                        G_Schedule_StateUpdate = schedule(STATE_UPDATE_SCHEDULE, processNewLogsPerSchedule);
                
                        // Message
                        if (LOG_INFO) log('Start monitoring of the ioBroker log...', 'info');
                
                    });
                
                }
                
                function processNewLogLine(data) {
                    
                    // Convert to Log Line
                    // TODO: This is a quick implementation of new function onLog().
                    //       We need to entirely rewrite script later to fully use the data object.
                    //       However, at this time, we convert it to a standard log line being expected.
                
                    // First, remove PID if desired
                    let msg = data.message;
                    if (REMOVE_PID) msg = removePID(msg);
                
                    // Now convert to log line
                    let newLogEntry = timestampToLogDate(data.ts) + '  - ' + data.severity + ': ' + msg;
                
                    // Check if we have DEBUG_IGNORE_STR in the new log line
                    if(! newLogEntry.includes(DEBUG_IGNORE_STR)) {
                
                        if (newLogEntry.length > 45) {  // a log line with less than 45 chars is not a valid log line.
                
                            // Cleanse and apply blacklist
                            newLogEntry = cleanseLogLine(newLogEntry);
                
                            // Push result into logArrayFinal
                            G_NewLogLinesArrayToProcess.push(newLogEntry);
                
                            // some debugging
                            if (LOG_DEBUG) log (DEBUG_IGNORE_STR + '===============================================================');
                            if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'New Log Entry, Len (' + newLogEntry.length + '), content: [' + newLogEntry + ']');
                
                            // This is for debugging purposes, and it will log every new log entry once again. See DEBUG_EXTENDED option above.
                            if (DEBUG_EXTENDED) {
                                if (! newLogEntry.includes(DEBUG_EXTENDED_STR)) { // makes sure no endless loop here.
                                    log(DEBUG_EXTENDED_STR + newLogEntry.substring(0, DEBUG_EXTENDED_NO_OF_CHARS));
                                        
                                }
                            }
                        }
                    }
                
                }
                
                /**
                 * Called per schedule STATE_UPDATE_SCHEDULE.
                 * It processes G_NewLogLinesArrayToProcess
                 */
                function processNewLogsPerSchedule() {
                    if (! isLikeEmpty (G_NewLogLinesArrayToProcess) ) {
                
                        // We use array spreads '...' to copy array. If not, array is changed by reference and not value.
                        // That means, if we change the target array, it will also change the source array.
                        // See https://stackoverflow.com/questions/7486085/copy-array-by-value
                        let logArrayToProcess = [...G_NewLogLinesArrayToProcess];
                        G_NewLogLinesArrayToProcess.length = 0; // emptying array. https://stackoverflow.com/questions/4804235/difference-between-array-length-0-and-array
                
                        /**
                         * Apply the filters as set in LOG_FILTER and split up log levels into elements of an array
                         * logArrayToProcessFiltered will look as follows:
                         *   logArrayToProcessFiltered = [
                         *     ['info':'15.08.2019 09:27:55.476 info adapt.0 some log', 'error':''],
                         *     ['info':'15.08.2019 09:33:58.522 info adapt.0 some more log', 'error':''],
                         *     ['info':'', 'error':'15.08.2019 09:37:55.807 error adapt.0 some error log']
                         *   ]
                         */
                        let logArrayToProcessFiltered = [];
                        for (let lpEntry of logArrayToProcess) {
                            let logEntryFilteredArray = applyFilter(lpEntry);
                            logArrayToProcessFiltered.push(logEntryFilteredArray);
                        }
                
                        // Further process and finally set states with our results.
                        processLogArrayAndSetStates(logArrayToProcessFiltered);
                
                    }
                }
                
                
                
                /*************************************************************************************************************************
                 * Filtering
                 *************************************************************************************************************************/
                
                /**
                 * This function applies the filters as set in LOG_FILTER.
                 * Also, it splits up the log levels into elements of an array we return by this function.
                 * @param {string} strLogEntry
                 * @return {array}  split up log levels as elements within this array, like: ['info':'logtext', 'error':'logtext'] etc.
                 */
                function applyFilter(strLogEntry) {
                    // We add one element per each filter to the Array ('all', 'error', etc.)
                    let logArrayProcessed = [];
                    for (let j = 0; j < LOG_FILTER.length; j++) {
                        logArrayProcessed[LOG_FILTER[j].id] = '';
                    }
                
                    // We apply regex here. This will also eliminate all log lines without proper info
                    // like date/time, log level, and entry.
                    let arrSplitLogLine = logLineSplit(strLogEntry);
                    if (arrSplitLogLine !== false) {
                
                        if (isLikeEmpty(LOG_FILTER) === false) {
                                    
                            // Now let's iterate over the filter array elements
                            // We check if both the "all" and "any" filters  apply. If yes, - and blacklist false - we add the log line.
                            for (let k = 0; k < LOG_FILTER.length; k++) {
                                if ( (strMatchesTerms(strLogEntry, LOG_FILTER[k].filter_all, 'every') === true)
                                && (strMatchesTerms(strLogEntry, LOG_FILTER[k].filter_any, 'some') === true)
                                && (strMatchesTerms(strLogEntry, LOG_FILTER[k].blacklist, 'blacklist') === false) ) {
                                    logArrayProcessed[LOG_FILTER[k].id] = logArrayProcessed[LOG_FILTER[k].id] + strLogEntry + "\n";
                                }
                                
                                // Now we remove terms if desired
                                if (isLikeEmpty(LOG_FILTER[k].clean) === false) {
                                    for (let lpTerm of LOG_FILTER[k].clean) {
                                        if (lpTerm !== '') {
                                            logArrayProcessed[LOG_FILTER[k].id] = logArrayProcessed[LOG_FILTER[k].id].replace(lpTerm, '');
                                        }
                                    }
                                }
                            }
                        }
                    }
                    return logArrayProcessed;
                }
                
                /*************************************************************************************************************************
                 * Further processing
                 *************************************************************************************************************************/
                
                /**
                 * Further processes the log array and set states accordingly.
                 * 
                 * @param  arrayLogInput             The Array of the log input.
                 *                                   Array is like: 
                 *                                   [
                 *                                      ['info':'15.08.2019 09:27:55.476 info adapt.0 some log', 'error':''],
                 *                                      ['info':'15.08.2019 09:33:58.522 info adapt.0 some more log', 'error':''],
                 *                                      ['info':'', 'error':'15.08.2019 09:37:55.807 error adapt.0 some error log'],
                 *                                   ]
                 **/
                function processLogArrayAndSetStates(arrayLogInput) {
                
                    /*****************
                     * [1] Build array from LOG_FILTER. Looks like: arrayFilterIds = ['info', 'error', 'warn'].
                     * Also, build result array to keep our results. Lools like resultArr = [info: '', error: '', warn: '']
                     *****************/
                    let arrayFilterIds = [];
                    let resultArr = [];
                    for (let i = 0; i < LOG_FILTER.length; i++) {
                        arrayFilterIds.push(LOG_FILTER[i].id); // each LOG_FILTER id into array
                        resultArr[LOG_FILTER[i].id] = '';
                    }
                    /*****************
                     * [2] Process element by element, so ['info':'log test', 'error':'log test'] of given array.
                     * We fill the result array accordingly.
                     *****************/
                    for (let lpElement of arrayLogInput) {
                
                        // Loop thru our new array arrayFilterIds and fill result array
                        for (let k = 0; k < arrayFilterIds.length; k++) {
                
                            // some variables
                            let lpFilterId = arrayFilterIds[k]; // Filter ID from LOG_FILTER, like 'error', 'info', 'custom', etc.
                            let lpNewLogLine = lpElement[lpFilterId]; // Current log line of provided array element of 'error', 'info', 'custom' etc.
                
                            if (isLikeEmpty(lpNewLogLine)) {
                                // No log content for the given filter id.
                                if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'Filter  [' + lpFilterId + ']: No match.');
                            } else {
                
                                if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'Filter [' + lpFilterId + ']: Match! New Log Line length: (' + lpNewLogLine.length + ')');
                
                                // Append new log line to result array
                                if (isLikeEmpty(resultArr[lpFilterId])) {
                                    resultArr[lpFilterId] = lpNewLogLine; 
                                } else {
                                    resultArr[lpFilterId] = lpNewLogLine + resultArr[lpFilterId]; // "\n" not needed, always added above
                                }
                            }
                        }
                    }
                
                    /*****************
                     * [3] We merge with the current state.
                     *****************/
                    for (let k = 0; k < arrayFilterIds.length; k++) {
                        let lpFilterId = arrayFilterIds[k]; // Filter ID from LOG_FILTER, like 'error', 'info', 'custom', etc.
                        let lpStatePath1stPart = FINAL_STATE_PATH + '.log' + cleanseStatePath(lpFilterId); // Get Path to state
                        let lpNewFinalLog = resultArr[lpFilterId];
                
                        if (! isLikeEmpty(lpNewFinalLog) )  {
                
                            // Get state value
                			let strCurrentStateLog = getState(lpStatePath1stPart + '.log').val; // Get state contents of loop item
                            
                            // Add state log lines to our final log
                            if (! isLikeEmpty(strCurrentStateLog)) {
                                lpNewFinalLog = lpNewFinalLog + strCurrentStateLog; // "\n" not needed, always added above
                            }            
                
                            // Convert to array for easier handling
                            let lpNewFinalLogArray = lpNewFinalLog.split(/\r?\n/);
                
                            // Remove duplicates
                            lpNewFinalLogArray = arrayRemoveDublicates(lpNewFinalLogArray);
                
                            // Remove empty values
                            lpNewFinalLogArray = cleanArray(lpNewFinalLogArray);
                
                            // Sort array descending
                            lpNewFinalLogArray = sortLogArrayByDate(lpNewFinalLogArray, 'desc');
                
                            // Merge Loglines if multiple values and add leading '[123 entries]' to log message
                            let doMerge = getConfigValuePerKey(LOG_FILTER, 'id', lpFilterId, 'merge');
                            if (doMerge || doMerge === 'true') {    // also check for string 'true' in case user used string
                                lpNewFinalLogArray = mergeLogLines(lpNewFinalLogArray);
                            }
                
                            // We need a separate array for JSON
                            let lpNewFinalLogArrayJSON = lpNewFinalLogArray;
                
                            // Let's remove elements if time of when button '.clearJSON' was pressed is greater than log date.
                            lpNewFinalLogArrayJSON = clearJsonByDate(lpNewFinalLogArrayJSON, lpStatePath1stPart + '.clearJSON');              
                
                            // Just keep the first x elements of the log. JSON log length is being set individually.
                            lpNewFinalLogArray = lpNewFinalLogArray.slice(0, MAX_LOG_LINES);
                            lpNewFinalLogArrayJSON = lpNewFinalLogArrayJSON.slice(0, getConfigValuePerKey(LOG_FILTER, 'id', lpFilterId, 'jsonMaxLines'));
                
                            // Get just the most recent log entry into string
                            let lpMostRecent = lpNewFinalLogArray[0];
                
                            // Sort ascending if desired
                            if (!getConfigValuePerKey(LOG_FILTER, 'id', lpFilterId, 'sortDescending')) {
                                lpNewFinalLogArray = lpNewFinalLogArray.reverse();
                                lpNewFinalLogArrayJSON = lpNewFinalLogArrayJSON.reverse();
                            }
                
                            // ** Finally set the states
                
                            ///////////////////////////////
                            // -1- Full Log, String, separated by "\n"
                            ///////////////////////////////
                            let strResult = lpNewFinalLogArray.join("\n");
                            if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'New length to be set into state: (' + strResult.length + '), state: [' + lpStatePath1stPart + '.log' + ']');
                
                            setState(lpStatePath1stPart + '.log', strResult);
                
                            ///////////////////////////////
                            // -2- JSON, with elements date and msg
                            ///////////////////////////////
                            // Let's put together the JSON
                            let jsonArr = [];
                            for (let j = 0; j < lpNewFinalLogArrayJSON.length; j++) {
                                // Get 4 elements in array: datetime, level, source, message
                                let arrSplitLogLine = logLineSplit(lpNewFinalLogArrayJSON[j]);
                                if (arrSplitLogLine !== false) {
                                    let strLogMsg = arrSplitLogLine.message;
                                    // Reduce the length for each log message per "jsonLogLength"
                                    strLogMsg = strLogMsg.substr(0, LOG_FILTER[k].jsonLogLength);
                                    // ++++++
                                    // Build the final Array
                                    // ++++++
                                    // We need this section to generate the JSON with the columns (which ones, and order) as specified in LOG_FILTER
                                    let objectJSONentry = {}; // object (https://stackoverflow.com/a/13488998)
                                    if (isLikeEmpty(LOG_FILTER[k].jsonColumns)) log('Columns not specified in "jsonColumns".', 'warn');
                                    // Prepare CSS
                                    let strCSS1, strCSS2;
                                    let strCSS1_level, strCSS2_level;
                                    if (JSON_APPLY_CSS) {
                                        strCSS1 = "<span class='log-" + arrSplitLogLine.level + "'>";
                                        strCSS2 = '</span>';
                                        strCSS1_level = strCSS1;
                                        strCSS2_level = strCSS2;
                                        if (LOG_FILTER[k].jsonCssToLevel) {
                                            strCSS1 = '';
                                            strCSS2 = '';
                                        }
                                    }
                
                                    for (let lpCol of LOG_FILTER[k].jsonColumns) {
                                        switch (lpCol) {
                                            case 'date' :
                                                objectJSONentry.date = strCSS1 + formatLogDateStr(arrSplitLogLine.datetime, LOG_FILTER[k].jsonDateFormat) + strCSS2;
                                                break;
                                            case 'level' :
                                                objectJSONentry.level = strCSS1_level + arrSplitLogLine.level + strCSS2_level;
                                                break;
                                            case 'source' :
                                                objectJSONentry.source = strCSS1 + arrSplitLogLine.source + strCSS2;
                                                break;
                                            case 'msg' :
                                                objectJSONentry.msg = strCSS1 + strLogMsg + strCSS2;
                                                break;
                                            default:
                                                //nothing;
                                        }
                                    }
                                    // Ok, so now we have the JSON entry.
                                    jsonArr.push(objectJSONentry);
                                }
                
                            }
                            if (! isLikeEmpty(lpNewFinalLogArrayJSON)) {
                                setState(lpStatePath1stPart + '.logJSON', JSON.stringify(jsonArr));
                                setState(lpStatePath1stPart + '.logJSONcount', lpNewFinalLogArrayJSON.length);
                            } 
                        }
                    }
                }
                
                /**
                 * This will allow to set Json log to zero if button is pressed.
                 */
                function subscribeClearJson() {
                    // Set current date to state if button is pressed
                    let logSubscribe = '';
                    for (let i = 0; i < LOG_FILTER.length; i++) {
                        let lpFilterId = cleanseStatePath(LOG_FILTER[i].id);
                        let lpStateFirstPart = FINAL_STATE_PATH + '.log' + lpFilterId;
                        logSubscribe += ( (logSubscribe === '') ? '' : ', ') + lpFilterId;
                        on({id: lpStateFirstPart + '.clearJSON', change: 'any', val: true}, function(obj) {
                            let stateBtnPth = obj.id // e.g. [javascript.0.Log-Script.logInfo.clearJSON]
                            let firstPart = stateBtnPth.substring(0, stateBtnPth.length-10); // get first part of obj.id, like "javascript.0.Log-Script.logInfo"
                            let filterID = firstPart.slice(firstPart.lastIndexOf('.') + 1); // gets the filter id, like "logInfo"
                            if (LOG_DEBUG) log(DEBUG_IGNORE_STR + 'Clear JSON states for [' + filterID + '].');
                            // We clear the according JSON states
                            setState(firstPart + '.logJSON', '[]');
                            setState(firstPart + '.logJSONcount', 0);
                
                        });
                    }
                    if (LOG_DEBUG) log('Subscribing to Clear JSON Buttons: ' + logSubscribe)
                }
                
                
                /*************************************************************************************************************************
                 * Script specific supporting functions
                 *************************************************************************************************************************/
                
                /**
                 * Reformats a log date string accordingly
                 * @param {string}    strDate   The date to convert
                 * @param {string}    format    e.g. 'yyyy-mm-dd HH:MM:SS'. Both upper case and lower case letters are allowed.
                 * @return {string}             Returns the resulting date string
                 */
                function formatLogDateStr(strDate, format) {
                
                    let strResult = format.toLowerCase();
                    strResult = strResult.replace('yyyy', strDate.substr(0,4));
                    strResult = strResult.replace('yy', strDate.substr(2,2));
                    strResult = strResult.replace('mm', strDate.substr(5,2));
                    strResult = strResult.replace('dd', strDate.substr(8,2));
                    strResult = strResult.replace('hh', strDate.substr(11,2));
                    strResult = strResult.replace('mm', strDate.substr(14,2));
                    strResult = strResult.replace('ss', strDate.substr(17,2));
                
                    return strResult;
                
                }
                
                /**
                 * Cleanse the log line
                 * @param {string}   logLine    The log line to be cleansed.
                 * @return {string}             The cleaned log line
                 */
                function cleanseLogLine(logLine) {
                    // Remove color escapes - https://stackoverflow.com/questions/25245716/remove-all-ansi-colors-styles-from-strings
                    let logLineResult = logLine.replace(/\u001b\[.*?m/g, ''); 
                    // Sometimes, a log line starts with the term "undefined", so we remove it.
                    if (logLineResult.substr(0,9) === 'undefined') logLineResult = logLineResult.substr(9,99999);
                    // Remove white space, tab stops, new line
                    logLineResult = logLineResult.replace(/\s\s+/g, ' ');
                    // Check against global blacklist
                    if(strMatchesTerms(logLineResult, BLACKLIST_GLOBAL, 'blacklist')) logLineResult = '';
                
                
                    return logLineResult;
                }
                
                
                
                /**
                 * Sorts the log array by date. We expect the first 23 chars of each element being a date in string format.
                 * @param {array} inputArray       Array to process
                 * @param {string}  order          'asc' or 'desc' for ascending or descending order
                 */
                function sortLogArrayByDate(inputArray, order) {
                    var result = inputArray.sort(function(a,b){
                            // Turn your strings into dates, and then subtract them
                            // to get a value that is either negative, positive, or zero.
                            a = new Date(a.substr(0,23));
                            b = new Date(b.substr(0,23));
                            if (order === 'asc') {
                                return a - b;
                            } else {
                                return b - a;
                            }
                
                    });
                
                    return result;
                }
                
                
                /**
                 * Splits a given log entry into an array with 4 elements.
                 * @param {string}  inputValue  Log line like '2018-07-22 11:47:53.019  - info: javascript.0 script.js ...'
                 * @return {object}   Array with 4 elements: 
                 *                     0. datetime (e.g. 2018-07-22 11:47:53.019),
                 *                     1. level (e.g. info)
                 *                     2. source (e.g. javascript.0)
                 *                     3. message (e.g. script.js....)
                 *                     Returns FALSE if no match or input value not valid
                 */
                function logLineSplit(inputValue) {
                
                    // Get RegEx ready
                    let mRegEx = new RegExp(LOG_PATT, 'g');
                
                    // Split
                    let returnObj = {}
                    let m;
                    do {
                        m = mRegEx.exec(inputValue);
                        if (m) {
                            returnObj.datetime = m[1];
                            returnObj.spaceAt2 = m[2];
                            returnObj.level = m[3];
                            returnObj.spaceAt4 = m[4];
                            returnObj.source = m[5];
                            returnObj.spaceAt6 = m[6];
                            returnObj.message = m[7];
                        } 
                    } while (m);
                
                    // Now we check if we have valid entries we want
                    if ((returnObj.datetime === undefined)
                        || (returnObj.level === undefined)
                        || (returnObj.source === undefined)
                        || (returnObj.message === undefined)
                    ) {
                       return false; // no valid hits
                    }
                    // We can return the array now, since it meets all requirements
                    return returnObj;
                
                }
                
                /**
                 * Merges date/time, level, source and message to a logline
                 * @param  {array}    inputValue   Array with 4 elements: date/time, level, source, message
                 * @return {string}   Merged log line as string. Empty string '', if input value not valid.
                																			  
                 */
                function logLineMerge(inputValue) {
                
                    if (inputValue.length === 4) {
                        let mergedLine = inputValue[0] + ' - ' + inputValue[1] + ': ' + inputValue[2] + ' ' + inputValue[3];
                        return mergedLine;
                    } else {
                        // We expect a size of 4, so go out
                        return '';
                    }
                
                }
                
                
                /**
                 * Merge Loglines if multiple values and add leading '[123 entries]' to log message
                 * @param {array}  logArray        array of log entries
                 * @return {array} the new merged log array
                 */
                function mergeLogLines(logArray) {
                
                    // We use array spreads '...' to copy array. If not, array is changed by reference and not value.
                    // That means, if we change the target array, it will also change the source array.
                    // See https://stackoverflow.com/questions/7486085/copy-array-by-value
                    let arrCopy = [...logArray];
                    let arrNew = [];
                
                    for (let i = 0; i < arrCopy.length; i++) {
                
                        if (! isLikeEmpty(arrCopy[i])) {
                
                            let lpEntry = arrCopy[i];
                            let lineWithoutDate = lpEntry.substring(23);
                            let lpLineSplit = logLineSplit(lpEntry);
                
                            // Get multiple values
                            let lpMulti = arrayGetElements(arrCopy, removeLeading123entries(lpLineSplit.message), false);
                            let result = lpEntry;
                            let lineCounter = 0;
                            if (lpMulti.length > 1) { // Treffer - die aktuelle Zeile zählt ja auch mit.
                                lineCounter = lpMulti.length;
                                let hitLeadingNumber = -1;
                                for (let hitLine of lpMulti) {
                                    let hitLineSplit = logLineSplit(hitLine);
                                    // Check if hit contains '[123 entries]'. If yes, get the number out of it into lineCounter.
                                    // If not, we just count with 1.
                                    hitLeadingNumber = checkForMultiEntry(hitLineSplit.message);
                                    if (hitLeadingNumber > 1) {
                                        lineCounter = hitLeadingNumber + lpMulti.length - 1;
                                    }
                                }
                            } else {
                                lineCounter = 1;
                            }
                
                            if (lineCounter > 1) {
                
                                    // remove from array by filling empty value
                                    arrCopy = arrayReplaceElementsByValue(arrCopy, removeLeading123entries(lpLineSplit.message), '', false);
                                    // new result
                                    result = logLineMerge([lpLineSplit.datetime, lpLineSplit.level, lpLineSplit.source, '[' + lineCounter + ' ' + MERGE_LOGLINES_TXT + '] ' + removeLeading123entries(lpLineSplit.message)]);
                            }
                            arrNew.push(result);
                        } 
                    }
                
                    return arrNew;
                
                    /**
                     * @param  {string}   strInput    A log message with potential leading '[123 entries]'
                     * @return {string}   string without leading '[123 entries]', if it is there
                     */
                    function removeLeading123entries(strInput) {
                
                        let mRegEx = new RegExp(MERGE_REGEX_PATT);
                        let matches = mRegEx.exec(strInput);
                        if (matches === null) {
                            return strInput;
                        } else {
                            return matches[2];
                        }
                    }
                
                    /**
                     * @param  {string}   strInput    A log message checking for leading '[123 entries]'
                     * @return {number}   returns the number 123 from '[123 entries]' if any match, or -1 if not found
                     */
                    function checkForMultiEntry(strInput) {
                
                        // Get RegEx ready
                        let mRegEx = new RegExp(MERGE_REGEX_PATT);
                        let matches = mRegEx.exec(strInput);
                        if (matches === null) {
                            return -1;
                        } else {
                            return parseInt(matches[1]);
                        }
                    }
                
                }
                
                
                
                /*************
                 * Get the file system path and filename of the current log file.
                 * 
                 * ioBroker creates a log file every midnight at 0:00 under '/opt/iobroker/log/'
                 * Syntax of the log file is: iobroker.YYYY-MM-DD.log
                 * This function returns the full path to the log file, considering the current date/time when this function is called.
                 * @return {string}      Path and file name to log file.
                 */
                function getCurrentFullFsLogPath() {
                    let strLogPathFinal = LOG_FS_PATH;
                    if (strLogPathFinal.slice(-1) !== '/') strLogPathFinal = strLogPathFinal + '/';
                    let strFullLogPath = strLogPathFinal + DEBUG_CUSTOM_FILENAME;
                    if (DEBUG_CUSTOM_FILENAME === '') strFullLogPath = strLogPathFinal + 'iobroker.' + getCurrentISODate() + '.log';
                    return strFullLogPath;
                }
                
                /**
                 * Clear array: if stateForTimeStamp is greater or equal than log date, we remove the entire log entry
                 * @param {array} inputArray     Array of log entries
                 * @param {string} stateForTimeStamp     state of which we need the time stamp
                 * @return {array} cleaned log
                 */
                function clearJsonByDate(inputArray, stateForTimeStamp) {
                    let dtState = new Date(getState(stateForTimeStamp).ts);
                    if (LOG_DEBUG) log (DEBUG_IGNORE_STR + 'Time of last change of state [' + stateForTimeStamp + ']: ' + dtState);
                    let newArray = [];
                    for (let lpLog of inputArray) {
                        let dtLog = new Date(lpLog.substr(0,23));
                        if (dtLog.getTime() >= dtState.getTime()) {
                            newArray.push(lpLog);            
                        }
                  }
                  return newArray;
                }
                
                
                /**
                 * Build an array of states we need to create.
                 * @return {array} Array of states to be created. Format: see function createUserStates()
                 */
                function buildNeededStates() {
                
                    let logCleanIDs = '';
                    let statesArray = [];
                    if (! isLikeEmpty(LOG_FILTER)) {
                        for(let i = 0; i < LOG_FILTER.length; i++) {
                            if (LOG_FILTER[i].id !== '') {
                                let lpIDClean = cleanseStatePath(LOG_FILTER[i].id);
                                logCleanIDs += ((logCleanIDs === '') ? '' : '; ') + lpIDClean;
                
                                statesArray.push({ id:'log' + lpIDClean + '.log', name:'Filtered Log - ' + lpIDClean, type:"string", role: "state", def: ""});
                                statesArray.push({ id:'log' + lpIDClean + '.logJSON', name:'Filtered Log - ' + lpIDClean + ' - JSON', type:"string", role: "state", def: ""});
                                statesArray.push({ id:'log' + lpIDClean + '.logJSONcount', name:'Filtered Log - Count of JSON ' + lpIDClean, role: "state", type:"number", def: 0});
                                statesArray.push({ id:'log' + lpIDClean + '.clearJSON', name:'Clear JSON log ' + lpIDClean, role: "button", type:"boolean", def: false});
                
                                /**
                                 *  Backward compatibility & cleanup: removing states not needed
                                 */
                                // State .logMostRecent removed with script version 2.0a onwards as it does not make sense any longer due to scheduled update
                                let lpRetiredState = FINAL_STATE_PATH + '.log' + lpIDClean + '.logMostRecent';
                                if (isState(lpRetiredState, true))  {
                                    deleteState(lpRetiredState);
                                    if (LOG_INFO) log('Remove retired state: ' + lpRetiredState, 'info');
                                }
                                // State .clearJSONtime removed with script version 1.2 onwards as we use now time stamp of button '.clearJSON'.
                                lpRetiredState = FINAL_STATE_PATH + '.log' + lpIDClean + '.clearJSONtime';
                                if (isState(lpRetiredState, true))  {
                                    deleteState(lpRetiredState);
                                    if (LOG_INFO) log('Remove retired state: ' + lpRetiredState, 'info');
                                }
                																																														  
                            }
                        }
                        if (LOG_DEBUG) log('createLogStates(): Clean IDs: ' + logCleanIDs);
                    }
                
                    let finalStates = [];
                    for (let s=0; s < statesArray.length; s++) {
                        finalStates.push([FINAL_STATE_PATH + '.' + statesArray[s].id, {
                            'name': statesArray[s].name,
                            'desc': statesArray[s].name,
                            'type': statesArray[s].type,
                            'read': true,
                            'write': true,
                            'role': statesArray[s].role,
                            'def': statesArray[s].def,
                        }]);
                    }
                    return finalStates;
                }
                
                /**
                 * Converts a timestamp to log date format, like 2019-10-15 16:38:00.260.
                 * @param {object}  timeStamp   The date/time timestamp to convert.
                 * @return {string} The resulting log date format as string.
                 */
                function timestampToLogDate(timeStamp) {
                
                    let date = new Date(timeStamp);
                    // Need to convert to local time as this time provided from onLog() is UTC
                    // https://stackoverflow.com/questions/6525538/convert-utc-date-time-to-local-date-time/18330682
                    let localDate = new Date(date.getTime() - date.getTimezoneOffset()*60*1000);
                
                    // Convert to ISO string, so like 2019-10-15T16:38:00.260Z
                    let strResult = localDate.toISOString();
                
                    // date.toISOString() adds T and Z, so we remove these letters, as the log do not show these.
                    strResult = strResult.replace('T', ' ');  // remove T
                    strResult = strResult.replace('Z', '');  // remove Z at the end
                    return strResult;
                
                }
                
                /**
                 * Remove PID in log message 
                 * The js-controller version 2.0+ adds the PID number inside brackets to the beginning of the message. We remove it here.
                 * @param {string} msg   The log message, like: 'javascript.0 (123) Logtext 123 Logtext 123 Logtext 123 Logtext 123'
                 */
                function removePID(msg) {
                
                    // First: Split source and message text. 
                    // Input is like: 'javascript.0 (123) Logtext 123 Logtext 123 Logtext 123 Logtext 123'
                    let regexp = /^(\S+)\s(.*)/;
                    let matches_array = msg.match(regexp);
                    let strFirst = matches_array[1];    // like 'javascript.0'
                    let strRest = matches_array[2];     // like '(123) Logtext 123 Logtext 123 Logtext 123 Logtext 123'
                    
                    // Next, we remove the PID
                    strRest = strRest.replace(/^\([0-9]{1,9}\)\s/, '');
                
                    // Last, we put the two strings together again
                    return strFirst + ' ' + strRest;
                
                }
                
                
                
                
                /*************************************************************************************************************************
                 * onStop - Being executed once this ioBroker Script stops. 
                 *************************************************************************************************************************/
                // This is to end the Tale. Not sure, if we indeed need it, but just in case...
                onStop(function myScriptStop () {
                
                    // Unsubscribe log handler
                    onLogUnregister(G_LogHandler);
                    if (LOG_INFO) log('Unsubscribed to Log Handler.', 'info');
                
                }, 0);
                
                
                
                /*************************************************************************************************************************
                 * General supporting functions
                 *************************************************************************************************************************/
                
                /**
                 * Remove Duplicates from Array
                 * Source - https://stackoverflow.com/questions/23237704/nodejs-how-to-remove-duplicates-from-array
                 * @param {array} inputArray       Array to process
                 * @return {array}  Array without duplicates.
                 */
                function arrayRemoveDublicates(inputArray) {
                    let uniqueArray;
                    uniqueArray = inputArray.filter(function(elem, pos) {
                        return inputArray.indexOf(elem) == pos;
                    });
                    return uniqueArray;
                }
                
                /**
                 * Clean Array: Removes all falsy values: undefined, null, 0, false, NaN and "" (empty string)
                 * Source: https://stackoverflow.com/questions/281264/remove-empty-elements-from-an-array-in-javascript
                 * @param {array} inputArray       Array to process
                 * @return {array}  Cleaned array
                 */
                function cleanArray(inputArray) {
                  var newArray = [];
                  for (let i = 0; i < inputArray.length; i++) {
                    if (inputArray[i]) {
                      newArray.push(inputArray[i]);
                    }
                  }
                  return newArray;
                }
                
                
                /**
                 * Checks if Array or String is not undefined, null or empty.
                 * 08-Sep-2019: added check for [ and ] to also catch arrays with empty strings.
                 * @param inputVar - Input Array or String, Number, etc.
                 * @return true if it is undefined/null/empty, false if it contains value(s)
                 * Array or String containing just whitespaces or >'< or >"< or >[< or >]< is considered empty
                 */
                function isLikeEmpty(inputVar) {
                    if (typeof inputVar !== 'undefined' && inputVar !== null) {
                        let strTemp = JSON.stringify(inputVar);
                        strTemp = strTemp.replace(/\s+/g, ''); // remove all whitespaces
                        strTemp = strTemp.replace(/\"+/g, "");  // remove all >"<
                        strTemp = strTemp.replace(/\'+/g, "");  // remove all >'<
                        strTemp = strTemp.replace(/\[+/g, "");  // remove all >[<
                        strTemp = strTemp.replace(/\]+/g, "");  // remove all >]<
                        if (strTemp !== '') {
                            return false;
                        } else {
                            return true;
                        }
                    } else {
                        return true;
                    }
                }
                
                /**
                 * Returns the current date in ISO format "YYYY-MM-DD".
                 * @return  {string}    Date in ISO format
                 */
                function getCurrentISODate() {
                    let currDate = new Date();
                    return currDate.getFullYear() + '-' + zeroPad((currDate.getMonth() + 1), 2) + '-' + zeroPad(currDate.getDate(), 2);
                }
                
                /**
                 * Fügt Vornullen zu einer Zahl hinzu, macht also z.B. aus 7 eine "007". 
                 * zeroPad(5, 4);    // wird "0005"
                 * zeroPad('5', 6);  // wird "000005"
                 * zeroPad(1234, 2); // wird "1234" :)
                 * @param  {string|number}  num     Zahl, die Vornull(en) bekommen soll
                 * @param  {number}         places  Anzahl Stellen.
                 * @return {string}         Zahl mit Vornullen wie gewünscht.
                 */
                function zeroPad(num, places) {
                    let zero = places - num.toString().length + 1;
                    return Array(+(zero > 0 && zero)).join("0") + num;        
                } 
                
                
                /**
                 * Will just keep lower case letters, numbers, '-' and '_' and removes the rest
                 * Also, capitalize first Letter.
                 */
                function cleanseStatePath(stringInput) {
                    let strProcess = stringInput;
                    strProcess = strProcess.replace(/([^a-z0-9_\-]+)/gi, '');
                    strProcess = strProcess.toLowerCase();
                    strProcess = strProcess.charAt(0).toUpperCase() + strProcess.slice(1);
                    return strProcess;
                
                }
                
                
                /**
                 * Checks if the string provided contains either every or some terms.
                 * Source: https://stackoverflow.com/questions/36283767/javascript-select-the-string-if-it-matches-multiple-words-in-array
                 * @param {string} strInput - The string on which we run this search
                 * @param {array} arrayTerms - The terms we are searching, e.g. ["hue", "error", "raspberry"]
                 * @param {string} type - 'every': all terms must match to be true,
                 *                        'some': at least one term (or more) must match
                 *                        'blacklist': different here: function will always
                 *                         return FALSE, but if one of the arrayTerms contains
                 *                         minimum 3 chars and is found in provided string,
                 *                         we return TRUE (= blacklisted item found).
                 * @return {boolean}       true, if it contains ALL words, false if not all words (or none)
                 *                         Also, will return true if arrayTerms is not array or an empty array
                 */
                function strMatchesTerms(strInput, arrayTerms, type) {
                    if(type === 'blacklist') {
                        if (Array.isArray(arrayTerms)) {
                            let arrayTermsNew = [];
                            for (let lpTerm of arrayTerms) {
                                if (lpTerm.length >= 3) {
                                    arrayTermsNew.push(lpTerm);
                                }
                            }
                            if(isLikeEmpty(arrayTermsNew) === false) {
                                let bResultBL = arrayTermsNew.some(function(word) {
                                    return strInput.indexOf(word) > -1;
                                });
                                return bResultBL;
                            } else {
                                return false; // return false if no items to be blacklisted
                            }
                        } else {
                            return false; // we return false if the arrayTerms given is not an array. Want to make sure if we really should blacklist...
                        }
                
                    } else {
                        if (Array.isArray(arrayTerms)) {
                            if(type === 'every') {
                                let bResultEvery = arrayTerms.every(function(word) {
                                    return strInput.indexOf(word) > -1;
                                });
                                return bResultEvery;
                            } else if(type === 'some') {
                                let bResultSome = arrayTerms.some(function(word) {
                                    return strInput.indexOf(word) > -1;
                                });
                                return bResultSome;
                            }
                
                        } else {
                            return true; // we return true if the arrayTerms given is not an array
                        }
                    }
                }
                
                /**
                 * Checks if a a given state or part of state is existing.
                 * This is a workaround, as getObject() or getState() throw warnings in the log.
                 * Set strict to true if the state shall match exactly. If it is false, it will add a wildcard * to the end.
                 * See: https://forum.iobroker.net/topic/11354/
                 * @param {string}    strStatePath     Input string of state, like 'javas-cript.0.switches.Osram.Bedroom'
                 * @param {boolean}   [strict=true]    Optional: Default is true. If true, it will work strict, if false, it will add a wildcard * to the end of the string
                 * @return {boolean}                   true if state exists, false if not
                 */
                function isState(strStatePath, strict) {
                
                    if(strict === undefined) strict = true;
                
                    let mSelector;
                    if (strict) {
                        mSelector = $('state[id=' + strStatePath + '$]');
                    } else {
                        mSelector = $('state[id=' + strStatePath + ']');
                    }
                    if (mSelector.length > 0) {
                        return true;
                    } else {
                        return false;
                    }
                }
                
                
                /**
                 * Removing Array element(s) by input value. 
                 * @param {array}   arr             the input array
                 * @param {string}  valRemove       the value to be removed
                 * @param {boolean} [exact=true]    OPTIONAL: default is true. if true, it must fully match. if false, it matches also if valRemove is part of element string
                 * @return {array}  the array without the element(s)
                 */
                function arrayRemoveElementsByValue(arr, valRemove, exact) {
                
                    for ( let i = 0; i < arr.length; i++){ 
                        if (exact) {
                            if ( arr[i] === valRemove) {
                                arr.splice(i, 1);
                                i--; // required, see https://love2dev.com/blog/javascript-remove-from-array/
                            }
                        } else {
                            if (arr[i].indexOf(valRemove) != -1) {
                                arr.splice(i, 1);
                                i--; // see above
                            }
                        }
                    }
                    return arr;
                }
                
                /**
                 * Escapes a string for use in RegEx as (part of) pattern
                 * Source: https://stackoverflow.com/questions/3446170/escape-string-for-use-in-javascript-regex
                 * @param {string} inputStr  The input string to be escaped
                 * @return {string}  The escaped string
                 */
                function escapeRegExp(inputStr) {
                    return inputStr.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
                }
                
                
                /**
                 * Get all elements of an array if found
                 * @param {array}   arr             the input array
                 * @param {string}  valFind         the value to find
                 * @param {boolean} [exact=true]    OPTIONAL: default is true. if true, it must fully match. if false, it matches also if valRemove is part of element string
                 * @return {array}  an array with all hits or empty array if no hits.
                 */
                function arrayGetElements(arr, valFind, exact) {
                    let resultArr = [];
                    for ( let i = 0; i < arr.length; i++){ 
                        if (exact) {
                            if ( arr[i] === valFind) {
                                resultArr.push(arr[i]);
                            }
                        } else {
                            if (arr[i].indexOf(valFind) != -1) {
                                resultArr.push(arr[i]);
                            }
                        }
                    }
                    return resultArr;
                }
                
                /**
                 * Replace Array element(s) by input value. 
                 * @param {array}   arr             the input array
                 * @param {string}  valReplace      the value to search for
                 * @param {string}  newValue        the new value
                 * @param {boolean} [exact=true]    OPTIONAL: default is true. if true, it must fully match. if false, it matches also if valRemove is part of element string
                 * @return {array}  the array with replaced the element(s)
                 */
                function arrayReplaceElementsByValue(arr, valReplace, newValue, exact) {
                
                    for ( let i = 0; i < arr.length; i++){ 
                        if (exact) {
                            if ( arr[i] === valReplace) {
                                arr[i] = newValue;
                            }
                        } else {
                            if (arr[i].indexOf(valReplace) != -1) {
                                arr[i] = newValue;
                            }
                        }
                    }
                    return arr;
                }
                
                /**
                 * Retrieve values from a CONFIG variable, example:
                 * const CONF = [{car: 'bmw', color: 'black', hp: '250'}, {car: 'audi', color: 'blue', hp: '190'}]
                 * To get the color of the Audi, use: getConfigValuePerKey(CONF, 'car', 'audi', 'color')
                 * To find out which car has 190 hp, use: getConfigValuePerKey(CONF, 'hp', '190', 'car')
                 * @param {object}  config     The configuration variable/constant
                 * @param {string}  key1       Key to look for.
                 * @param {string}  key1Value  The value the key should have
                 * @param {string}  key2       The key which value we return
                 * @returns {any}    Returns the element's value, or number -1 of nothing found.
                 */
                function getConfigValuePerKey(config, key1, key1Value, key2) {
                    for (let lpConfDevice of config) {
                        if ( lpConfDevice[key1] === key1Value ) {
                            if (lpConfDevice[key2] === undefined) {
                                return -1;
                            } else {
                                return lpConfDevice[key2];
                            }
                        }
                    }
                    return -1;
                }
                
                
                /**
                 * For a given state path, we extract the location '0_userdata.0' or 'javascript.0' or add '0_userdata.0', if missing.
                 * @param {string}  path            Like: 'Computer.Control-PC', 'javascript.0.Computer.Control-PC', '0_userdata.0.Computer.Control-PC'
                 * @param {boolean} returnFullPath  If true: full path like '0_userdata.0.Computer.Control-PC', if false: just location like '0_userdata.0' or 'javascript.0'
                 * @return {string}                 Path
                 */
                function validateStatePath(path, returnFullPath) {
                    if (path.startsWith('.')) path = path.substr(1);    // Remove first dot
                    if (path.endsWith('.'))   path = path.slice(0, -1); // Remove trailing dot
                    if (path.length < 1) log('Provided state path is not valid / too short.', 'error')
                    let match = path.match(/^((javascript\.([1-9][0-9]|[0-9])\.)|0_userdata\.0\.)/);
                    let location = (match == null) ? '0_userdata.0' : match[0].slice(0, -1); // default is '0_userdata.0'.
                    if(returnFullPath) {
                        return (path.indexOf(location) == 0) ? path : (location + '.' + path);
                    } else {
                        return location;
                    }
                }
                
                
                /**
                 * Create states under 0_userdata.0 or javascript.x
                 * Current Version:     https://github.com/Mic-M/iobroker.createUserStates
                 * Support:             https://forum.iobroker.net/topic/26839/
                 * Autor:               Mic (ioBroker) | Mic-M (github)
                 * Version:             1.1 (26 January 2020)
                 * Example:             see https://github.com/Mic-M/iobroker.createUserStates#beispiel
                 * -----------------------------------------------
                 * PLEASE NOTE: Per https://github.com/ioBroker/ioBroker.javascript/issues/474, the used function setObject() 
                 *              executes the callback PRIOR to completing the state creation. Therefore, we use a setTimeout and counter. 
                 * -----------------------------------------------
                 * @param {string} where          Where to create the state: '0_userdata.0' or 'javascript.x'.
                 * @param {boolean} force         Force state creation (overwrite), if state is existing.
                 * @param {array} statesToCreate  State(s) to create. single array or array of arrays
                 * @param {object} [callback]     Optional: a callback function -- This provided function will be executed after all states are created.
                 */
                function createUserStates(where, force, statesToCreate, callback = undefined) {
                 
                    const WARN = false; // Only for 0_userdata.0: Throws warning in log, if state is already existing and force=false. Default is false, so no warning in log, if state exists.
                    const LOG_DEBUG = false; // To debug this function, set to true
                    // Per issue #474 (https://github.com/ioBroker/ioBroker.javascript/issues/474), the used function setObject() executes the callback 
                    // before the state is actual created. Therefore, we use a setTimeout and counter as a workaround.
                    const DELAY = 50; // Delay in milliseconds (ms). Increase this to 100, if it is not working.
                
                    // Validate "where"
                    if (where.endsWith('.')) where = where.slice(0, -1); // Remove trailing dot
                    if ( (where.match(/^((javascript\.([1-9][0-9]|[0-9]))$|0_userdata\.0$)/) == null) ) {
                        log('This script does not support to create states under [' + where + ']', 'error');
                        return;
                    }
                
                    // Prepare "statesToCreate" since we also allow a single state to create
                    if(!Array.isArray(statesToCreate[0])) statesToCreate = [statesToCreate]; // wrap into array, if just one array and not inside an array
                
                    // Add "where" to STATES_TO_CREATE
                    for (let i = 0; i < statesToCreate.length; i++) {
                        let lpPath = statesToCreate[i][0].replace(/\.*\./g, '.'); // replace all multiple dots like '..', '...' with a single '.'
                        lpPath = lpPath.replace(/^((javascript\.([1-9][0-9]|[0-9])\.)|0_userdata\.0\.)/,'') // remove any javascript.x. / 0_userdata.0. from beginning
                        lpPath = where + '.' + lpPath; // add where to beginning of string
                        statesToCreate[i][0] = lpPath;
                    }
                
                    if (where != '0_userdata.0') {
                        // Create States under javascript.x
                        let numStates = statesToCreate.length;
                        statesToCreate.forEach(function(loopParam) {
                            if (LOG_DEBUG) log('[Debug] Now we are creating new state [' + loopParam[0] + ']');
                            let loopInit = (loopParam[1]['def'] == undefined) ? null : loopParam[1]['def']; // mimic same behavior as createState if no init value is provided
                            createState(loopParam[0], loopInit, force, loopParam[1], function() {
                                numStates--;
                                if (numStates === 0) {
                                    if (LOG_DEBUG) log('[Debug] All states processed.');
                                    if (typeof callback === 'function') { // execute if a function was provided to parameter callback
                                        if (LOG_DEBUG) log('[Debug] Function to callback parameter was provided');
                                        return callback();
                                    } else {
                                        return;
                                    }
                                }
                            });
                        });
                    } else {
                        // Create States under 0_userdata.0
                        let numStates = statesToCreate.length;
                        let counter = -1;
                        statesToCreate.forEach(function(loopParam) {
                            counter += 1;
                            if (LOG_DEBUG) log ('[Debug] Currently processing following state: [' + loopParam[0] + ']');
                            if( ($(loopParam[0]).length > 0) && (existsState(loopParam[0])) ) { // Workaround due to https://github.com/ioBroker/ioBroker.javascript/issues/478
                                // State is existing.
                                if (WARN && !force) log('State [' + loopParam[0] + '] is already existing and will no longer be created.', 'warn');
                                if (!WARN && LOG_DEBUG) log('[Debug] State [' + loopParam[0] + '] is already existing. Option force (=overwrite) is set to [' + force + '].');
                                if(!force) {
                                    // State exists and shall not be overwritten since force=false
                                    // So, we do not proceed.
                                    numStates--;
                                    if (numStates === 0) {
                                        if (LOG_DEBUG) log('[Debug] All states successfully processed!');
                                        if (typeof callback === 'function') { // execute if a function was provided to parameter callback
                                            if (LOG_DEBUG) log('[Debug] An optional callback function was provided, which we are going to execute now.');
                                            return callback();
                                        }
                                    } else {
                                        // We need to go out and continue with next element in loop.
                                        return; // https://stackoverflow.com/questions/18452920/continue-in-cursor-foreach
                                    }
                                } // if(!force)
                            }
                
                            // State is not existing or force = true, so we are continuing to create the state through setObject().
                            let obj = {};
                            obj.type = 'state';
                            obj.native = {};
                            obj.common = loopParam[1];
                            setObject(loopParam[0], obj, function (err) {
                                if (err) {
                                    log('Cannot write object for state [' + loopParam[0] + ']: ' + err);
                                } else {
                                    if (LOG_DEBUG) log('[Debug] Now we are creating new state [' + loopParam[0] + ']')
                                    let init = null;
                                    if(loopParam[1].def === undefined) {
                                        if(loopParam[1].type === 'number') init = 0;
                                        if(loopParam[1].type === 'boolean') init = false;
                                        if(loopParam[1].type === 'string') init = '';
                                    } else {
                                        init = loopParam[1].def;
                                    }
                                    setTimeout(function() {
                                        setState(loopParam[0], init, true, function() {
                                            if (LOG_DEBUG) log('[Debug] setState durchgeführt: ' + loopParam[0]);
                                            numStates--;
                                            if (numStates === 0) {
                                                if (LOG_DEBUG) log('[Debug] All states processed.');
                                                if (typeof callback === 'function') { // execute if a function was provided to parameter callback
                                                    if (LOG_DEBUG) log('[Debug] Function to callback parameter was provided');
                                                    return callback();
                                                }
                                            }
                                        });
                                    }, DELAY + (20 * counter) );
                                }
                            });
                        });
                    }
                }
                
                MicM Offline
                MicM Offline
                Mic
                Developer
                schrieb am zuletzt editiert von
                #409

                @PatrickFro
                Sollte es auch :-)
                Poste mal bitte das komplette Log, also vom ioBroker Admin, im linken Menü auf "Log" klicken.

                P GlasfaserG 2 Antworten Letzte Antwort
                0
                • MicM Mic

                  @PatrickFro
                  Sollte es auch :-)
                  Poste mal bitte das komplette Log, also vom ioBroker Admin, im linken Menü auf "Log" klicken.

                  P Offline
                  P Offline
                  PatrickFro
                  schrieb am zuletzt editiert von
                  #410

                  @Mic sehr gerne, aber ich finde kein Download mehr (☉_☉)
                  32641aca-408a-491c-90df-58ffca101281-image.png

                  GlasfaserG 1 Antwort Letzte Antwort
                  0
                  • P PatrickFro

                    @Mic sehr gerne, aber ich finde kein Download mehr (☉_☉)
                    32641aca-408a-491c-90df-58ffca101281-image.png

                    GlasfaserG Offline
                    GlasfaserG Offline
                    Glasfaser
                    schrieb am zuletzt editiert von Glasfaser
                    #411

                    @PatrickFro

                    Du hast kein " Log " Button …. aktualisiere mal den Admin auf die neuste Version !

                    @Mic
                    er hat das Script mit Fehlern kopiert !

                    zb.
                    im Skript : let logLineResult = logLine.replace(/\u001b[.*?m/g, '');

                    bei Ihm : let logLineResult = logLine.replace(/\u001b[.*?m/g, '');

                    der \ fehlt nach dem b

                    Synology 918+ 16GB - ioBroker in Docker v9 , VISO auf Trekstor Primebook C13 13,3" , Hikvision Domkameras mit Surveillance Station .. CCU RaspberryMatic in Synology VM .. Zigbee CC2538+CC2592 .. Sonoff .. KNX .. Modbus ..

                    P 1 Antwort Letzte Antwort
                    1
                    • P Offline
                      P Offline
                      PatrickFro
                      schrieb am zuletzt editiert von
                      #412

                      @Mic @Glasfaser be7acf0d-5fb2-41bc-85c8-0ebee44cf0b6-image.png

                      Ich habe kein Update für Admin.

                      Auch mit
                      sudo iobroker stop
                      sudo iobroker update
                      sudo iobroker upgrade self
                      sudo iobroker upgrade
                      sudo iobroker start

                      keine Änderung

                      1 Antwort Letzte Antwort
                      0
                      • GlasfaserG Glasfaser

                        @PatrickFro

                        Du hast kein " Log " Button …. aktualisiere mal den Admin auf die neuste Version !

                        @Mic
                        er hat das Script mit Fehlern kopiert !

                        zb.
                        im Skript : let logLineResult = logLine.replace(/\u001b[.*?m/g, '');

                        bei Ihm : let logLineResult = logLine.replace(/\u001b[.*?m/g, '');

                        der \ fehlt nach dem b

                        P Offline
                        P Offline
                        PatrickFro
                        schrieb am zuletzt editiert von
                        #413

                        @Glasfaser Ich habe das Script hier her: https://raw.githubusercontent.com/Mic-M/iobroker.logfile-script/master/iobroker_logfile-script.js

                        1 Antwort Letzte Antwort
                        0
                        • P Offline
                          P Offline
                          PatrickFro
                          schrieb am zuletzt editiert von
                          #414

                          Sehr skuril. Als es nicht wollte habe ich es erneut gelöscht und wieder angelegt. Ging weiterhin nicht. Nun nochmal gemacht, jetzt klappt es.

                          Bin nun wieder glücklich ;-)

                          Danke!

                          1 Antwort Letzte Antwort
                          0
                          • MicM Offline
                            MicM Offline
                            Mic
                            Developer
                            schrieb am zuletzt editiert von
                            #415

                            @PatrickFro sagte in [Vorlage] JS: Log-Datei aufbereiten für VIS:

                            502c9915-a135-4772-b0e2-513e79a2ba64-image.png

                            Was mich hier irritiert:
                            Du setzt wohl JS-Adapter-Version 4.3.3 ein, auch sonst scheint alles korrekt soweit.

                            Aber der Javascript-Adapter bringt eine Fehlermeldung, dass es onLogUnregister() nicht geben würde, obwohl diese in 4.3.3 enthalten ist.

                            Berichte mal bitte weiter, wie es läuft.

                            P 1 Antwort Letzte Antwort
                            0
                            • MicM Mic

                              @PatrickFro
                              Sollte es auch :-)
                              Poste mal bitte das komplette Log, also vom ioBroker Admin, im linken Menü auf "Log" klicken.

                              GlasfaserG Offline
                              GlasfaserG Offline
                              Glasfaser
                              schrieb am zuletzt editiert von Negalein
                              #416

                              @Mic

                              Kann das sein das die Zeile hier im Forum nicht richtig angezeigt wird .

                              Da der \ nach dem b immer verschwindet !

                               let logLineResult = logLine.replace(/\u001b\[.*?m/g, '');
                              
                              

                              1.JPG

                              @liv-in-sky hat auch das Problem .

                              Synology 918+ 16GB - ioBroker in Docker v9 , VISO auf Trekstor Primebook C13 13,3" , Hikvision Domkameras mit Surveillance Station .. CCU RaspberryMatic in Synology VM .. Zigbee CC2538+CC2592 .. Sonoff .. KNX .. Modbus ..

                              GlasfaserG MicM 2 Antworten Letzte Antwort
                              0
                              • MicM Mic

                                @PatrickFro sagte in [Vorlage] JS: Log-Datei aufbereiten für VIS:

                                502c9915-a135-4772-b0e2-513e79a2ba64-image.png

                                Was mich hier irritiert:
                                Du setzt wohl JS-Adapter-Version 4.3.3 ein, auch sonst scheint alles korrekt soweit.

                                Aber der Javascript-Adapter bringt eine Fehlermeldung, dass es onLogUnregister() nicht geben würde, obwohl diese in 4.3.3 enthalten ist.

                                Berichte mal bitte weiter, wie es läuft.

                                P Offline
                                P Offline
                                PatrickFro
                                schrieb am zuletzt editiert von
                                #417

                                @Mic Mache ich Chef ;-)

                                1 Antwort Letzte Antwort
                                1
                                • GlasfaserG Glasfaser

                                  @Mic

                                  Kann das sein das die Zeile hier im Forum nicht richtig angezeigt wird .

                                  Da der \ nach dem b immer verschwindet !

                                   let logLineResult = logLine.replace(/\u001b\[.*?m/g, '');
                                  
                                  

                                  1.JPG

                                  @liv-in-sky hat auch das Problem .

                                  GlasfaserG Offline
                                  GlasfaserG Offline
                                  Glasfaser
                                  schrieb am zuletzt editiert von
                                  #418

                                  @Negalein

                                  Bist du gerade am Testen :)

                                  Synology 918+ 16GB - ioBroker in Docker v9 , VISO auf Trekstor Primebook C13 13,3" , Hikvision Domkameras mit Surveillance Station .. CCU RaspberryMatic in Synology VM .. Zigbee CC2538+CC2592 .. Sonoff .. KNX .. Modbus ..

                                  NegaleinN 1 Antwort Letzte Antwort
                                  0
                                  • GlasfaserG Glasfaser

                                    @Mic

                                    Kann das sein das die Zeile hier im Forum nicht richtig angezeigt wird .

                                    Da der \ nach dem b immer verschwindet !

                                     let logLineResult = logLine.replace(/\u001b\[.*?m/g, '');
                                    
                                    

                                    1.JPG

                                    @liv-in-sky hat auch das Problem .

                                    MicM Offline
                                    MicM Offline
                                    Mic
                                    Developer
                                    schrieb am zuletzt editiert von
                                    #419

                                    @Glasfaser sagte in [Vorlage] JS: Log-Datei aufbereiten für VIS:

                                    @Mic
                                    Kann das sein das die Zeile hier im Forum nicht richtig angezeigt wird .
                                    Da der \ nach dem b immer verschwindet !

                                    Ja, die Forum-Software hier wirft das raus.
                                    Ich hatte das hier: https://forum.iobroker.net/topic/24179/vorlage-hilfreiche-javascript-funktionen
                                    Kann man escapen

                                    ACHTUNG: Bitte /[ und /] durch /\\[ und /\\[ ersetzen, wird durch das Forum nicht korrekt dargestellt.

                                    1 Antwort Letzte Antwort
                                    0
                                    • GlasfaserG Glasfaser

                                      @Negalein

                                      Bist du gerade am Testen :)

                                      NegaleinN Offline
                                      NegaleinN Offline
                                      Negalein
                                      Global Moderator
                                      schrieb am zuletzt editiert von
                                      #420

                                      @Glasfaser sagte in [Vorlage] JS: Log-Datei aufbereiten für VIS:

                                      Bist du gerade am Testen

                                      kommt drauf an was? ;)

                                      ° Node.js: 20.17.0 NPM: 10.8.2
                                      ° Proxmox, Ubuntu 22.04.3 LTS
                                      ° Fixer ---> iob fix

                                      GlasfaserG 1 Antwort Letzte Antwort
                                      0
                                      • NegaleinN Negalein

                                        @Glasfaser sagte in [Vorlage] JS: Log-Datei aufbereiten für VIS:

                                        Bist du gerade am Testen

                                        kommt drauf an was? ;)

                                        GlasfaserG Offline
                                        GlasfaserG Offline
                                        Glasfaser
                                        schrieb am zuletzt editiert von
                                        #421

                                        @Negalein

                                        Du warst ja gerade in meinem Beitrag :ghost:

                                        Synology 918+ 16GB - ioBroker in Docker v9 , VISO auf Trekstor Primebook C13 13,3" , Hikvision Domkameras mit Surveillance Station .. CCU RaspberryMatic in Synology VM .. Zigbee CC2538+CC2592 .. Sonoff .. KNX .. Modbus ..

                                        NegaleinN 1 Antwort Letzte Antwort
                                        0
                                        • GlasfaserG Glasfaser

                                          @Negalein

                                          Du warst ja gerade in meinem Beitrag :ghost:

                                          NegaleinN Offline
                                          NegaleinN Offline
                                          Negalein
                                          Global Moderator
                                          schrieb am zuletzt editiert von
                                          #422

                                          @Glasfaser sagte in [Vorlage] JS: Log-Datei aufbereiten für VIS:

                                          Du warst ja gerade in meinem Beitrag

                                          Ah, das meintest du. :grin:
                                          Ja, wollte mir das kurz anschauen, da eben schon öfter wo geschrieben wurde, dass das Forum Scripte nicht richtig darstellt.
                                          Aber da kann denke ich nur @Jey-Cee was ändern oder so.

                                          ° Node.js: 20.17.0 NPM: 10.8.2
                                          ° Proxmox, Ubuntu 22.04.3 LTS
                                          ° Fixer ---> iob fix

                                          1 Antwort Letzte Antwort
                                          0
                                          Antworten
                                          • In einem neuen Thema antworten
                                          Anmelden zum Antworten
                                          • Älteste zuerst
                                          • Neuste zuerst
                                          • Meiste Stimmen


                                          Support us

                                          ioBroker
                                          Community Adapters
                                          Donate

                                          595

                                          Online

                                          32.4k

                                          Benutzer

                                          81.4k

                                          Themen

                                          1.3m

                                          Beiträge
                                          Community
                                          Impressum | Datenschutz-Bestimmungen | Nutzungsbedingungen | Einwilligungseinstellungen
                                          ioBroker Community 2014-2025
                                          logo
                                          • Anmelden

                                          • Du hast noch kein Konto? Registrieren

                                          • Anmelden oder registrieren, um zu suchen
                                          • Erster Beitrag
                                            Letzter Beitrag
                                          0
                                          • Home
                                          • Aktuell
                                          • Tags
                                          • Ungelesen 0
                                          • Kategorien
                                          • Unreplied
                                          • Beliebt
                                          • GitHub
                                          • Docu
                                          • Hilfe