InfluxDB Administration

Achtung Datenverlust

Wenn Ihr die Influx-DB direkt administriert, solltet ihr auch wissen, was ihr da tut! Mit dem falschen Befehl kann man das Plugin zerschiessen oder gar alle eure bisherigen Daten löschen! Macht jegliche Änderungen nur mit einem aktuellen Backup! Wir haben Euch gewarnt…

 
InfluxDB kann auf der Konsole ähnlich einer SQL-Syntax mit dem Kommandozeilentool influx administriert werden. Die notwendigen Zugangsdaten stehen in der Datei /opt/loxberry/config/plugins/stats4lox/cred.json. Da InfluxDB im Stats4Lox Plugin SSL aktiviert hat, muss man influx noch die Optionen -ssl und -unsafeSsl mit übergeben.

Damit man sich die Tipparbeiten spart, liefern wir ein entsprechendes Wrapper-Skript mit, welches direkt auf der Kommandozeile aufgerufen werden kann: /opt/loxberry/bin/plugins/stats4lox/s4linlfux. Das Wrapper-Skript kümmert sich selbst um alle notwendigen Optionen zur Authentifizierung und zu SSL und kann direkt ohne Optionen aufgerufen werden. Es funktioniert ansonsten wie das Original influx.

Die gesamte Dokumentation der QUERY-Language von InfluxDB findet sich hier: https://docs.influxdata.com/influxdb/v1.8/query_language/spec/

Aufruf eines Kommandos und direkt beenden mit -execute

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux -execute 'SHOW DATABASES'
name: databases
name
----
stats4lox
_internal

Zeige alle Datenbanken

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux
 
> SHOW DATABASES
name: databases
name
----
stats4lox
_internal
>

Zur Datenbank 'stats4lox' wechseln

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux
 
> use stats4lox
Using database stats4lox

Measurements zeigen

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux
 
> show measurements
name: measurements
name
----
stats_loxberry_masterofdesaster
stats_loxone

Field Keys zeigen

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux
 
> show field keys
name: stats_loxone
fieldKey                                            fieldType
--------                                            ---------
value_0_0ad01f30-0049-2cb5-ffffe3220fbb8056_default float
value_0_0ad02593-03aa-d17e-ffffe3220fbb8056_default float
[...]

Tag Keys zeigen

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux
 
> show tag keys
name: stats_loxone
fieldKey                                            fieldType
--------                                            ---------
value_0_0ad01f30-0049-2cb5-ffffe3220fbb8056_default float
value_0_0ad02593-03aa-d17e-ffffe3220fbb8056_default float
[...]

Measurement löschen

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux
 
> drop measurement stats_loxone

Zeige alle eingegangenen Daten der letzten 5 Minuten

loxberry:~ $ /opt/loxberry/bin/plugins/stats4lox/s4linflux
 
> SELECT * FROM stats_loxone WHERE time > now()-5m