Nall-chan / MySQLArchive

MySQL Archiv für IP-Symcon

Home Page:https://community.symcon.de/t/modul-archive-control-mysql/45307

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SDK Version License
Version Check Style Run Tests
Spenden

Symcon-Modul: MySQL Archiv

Zusätzliches Archiv für MySQL Datenbanken.

Dokumentation

Inhaltsverzeichnis

1. Funktionsumfang

Variablenveränderungen in einer MySQL-Datenbank speichern.
Auslesen mit ACMYSQL_* PHP-Funktionen (kompatibel mit den AC_* Befehlen).

Achtung:
Dieses 'Archive Control' ersetzt nicht das Original in IPS.
Es wird nicht zur Visualisierung der IPS eigenen Graphen genutzt.
Ebenso kann das Logging-Verhalten nicht über die Einstellungen der Variable angepasst werden, sondern nur in der Instanz 'Archiv MySQL'.
Der Typ Zähler ist aktuell nicht verfügbar.

Um die gespeicherten Daten darzustellen, müssen Umsetzungen von dritten (wie z.B. Highcharts) genutzt werden.
Eine angepasste Highcharts.ips.php ist unter 'docs' beigefügt und kann über die Konfiguration der Instanz in den Objektbaum kopiert werden.

2. Voraussetzungen

  • IPS ab Version 5.1
  • MySQL Server

3. Installation

IPS 5.1:
Bei privater Nutzung: Über den 'Module-Store' in IPS das Modul MySQL Archiv hinzufügen.

Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.

4. Vorbereitungen

  • Der MySQL-Server muss von IPS aus erreichbar sein.
  • Es muss ein Benutzer mit allen erforderlichen Rechten vorhanden sein. (Daten & Struktur)

5. Einrichten der Instanz in IPS

  • Auf der Willkommen-Seite von IPS dem Link 'Instanz hinzufügen' öffnen.
  • In den Schnellfilter MySQL eingeben.
  • Den Eintrag 'Archiv MySQL' wählen und mit OK bestätigen.
  • Die Instanz über einen weiten Klick auf OK erzeugen.
  • Im folgenden Dialog des Konfigurator müssen jetzt erst die Zugangsdaten zum MySQL-Server eingegeben werden.
  • Die zu loggenden Variablen müssen über den Button 'hinzufügen' und dann durch einen Klick auf den Stift ausgewählt werden.

6. PHP-Funktionsreferenz

Es sind alle IPS Befehle des Original Archive-Control vorhanden.
Der Prefix muss nur von AC_ gegen ACMYSQL_ ersetzt werden.
Da aktuell keine Zähler unterstützt werden, werden diese Rückgabewerte immer mit 0 übergeben.

7. Parameter

Name Eigenschaft Typ Standardwert Funktion
Host Host string Hostname / IP-Adresse
Datenbank Database string ips Name der Datenbank
Benutzername Username integer Benutzername MySQL
Passwort Password string Passwort MySQL
Variablen Variables string {} JSON-String mit allen VariablenID

8. Anhang

1. GUID der Module

Modul Typ Prefix GUID
Archive Control MySQL Device ACMYSQL {FDCB334A-AFFF-4785-9596-D380252CEE4E}

2. Changelog

Version 3.35:

  • Das Anzeigen der Konfiguration konnte fehlschlagen, wenn in einer Tabelle keine Werte vorhanden waren.
  • ACMYSQL_GetAggregationVariables konnte fehlschlagen, wenn in einer Tabelle keine Werte vorhanden waren.
  • ACMYSQL_ChangeVariableID konnte fehlschlagen,wenn in einer Tabelle keine Werte vorhanden waren.
  • ACMYSQL_GetLoggedValues konnte fehlschlagen,wenn in einer Tabelle keine Werte vorhanden waren.
  • ACMYSQL_GetAggregatedValues konnte fehlschlagen,wenn in einer Tabelle keine Werte vorhanden waren.

Version 3.31:

  • Fix für defekte 3.20 Version.

Version 3.20:

  • Release für IPS 5.1 und den Module-Store

Version 3.10:

  • Buffer Tread-Safe mit Semaphore abgesichert.

Version 3.00:

  • Loggen der Daten von Nachrichtenschlange entkoppelt.

Version 2.50:

  • Anpassungen für IPS 5.1

Version 2.00:

  • Anpassungen für IPS 5.0
  • Modul intern umgebaut
  • Konfiguration für WebConsole verbessert

Version 1.02:

  • Fixes für IPS 5.0

Version 1.01:

  • Erstes offizielles Release

9. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

Wunschliste

10. Lizenz

IPS-Modul:
CC BY-NC-SA 4.0

About

MySQL Archiv für IP-Symcon

https://community.symcon.de/t/modul-archive-control-mysql/45307

License:Other


Languages

Language:PHP 100.0%