====== Syslog Server (English)  ======



\\


|Author         |[[https://loxwiki.atlassian.net/wiki/people/6166fb5d289a54006a96796a?ref=confluence|Tomas Zmatlik]]|
|Logo           |{{loxberry_english:plugins_english:1211859128.png?h=64}}                                           |
|Status         |PRE-RELEASE                                                                                        |
|Version        |0.0.5                                                                                              |
|Min. LB Version|LB 1.0                                                                                             |
|Download       |https://github.com/zmata/LoxBerry-Plugin-SyslogServer/archive/v0.0.5.zip                           |
|Description    |Syslog Server (not only) for Miniserver logging                                                    |



Version History...

**Version 0.0.5**

  * Service restart after cfg change

**Version 0.0.4**

  * Correction of the 'ü' in German

**Version 0.0.3**

  * German Language added - many thanks to Riesenschnabel

**Version 0.0.2**

  * Add Czech language
  * Language corrections
  * Link to wiki

**Version 0.0.1**

  * First pre-release



====== Content ======

  * [[#SyslogServer(English)-Functionalityoftheplugin|Functionality of the plugin]]
  * [[#SyslogServer(English)-Download|Download]]
  * [[#SyslogServer(English)-Installation|Installation]]
  * [[#SyslogServer(English)-Configurationoptions|Configuration options]]
  * [[#SyslogServer(English)-SetupintheLoxoneConfigSoftware|Setup in the Loxone Config Software]]
  * [[#SyslogServer(English)-LogAnalyzer|Log Analyzer]]
  * [[#SyslogServer(English)-Roadmap|Roadmap]]
  * [[#SyslogServer(English)-Askingquestionsandreportingproblems|Asking questions and reporting problems]]


\\



----

===== Functionality of the plugin =====

The Syslog Server use the standard rsyslog package. It's possible to receive log entries from another system and stored them in separate log file.

For analyzing of log files is used [[http://loganalyzer.adiscon.com/|Adiscon LogAnalyzer]]

===== Download =====

The current release can be found here:[[https://github.com/Gagi2k/LoxBerry-Plugin-WifiScanner/archive/v1.0-rc1.zip|]]https://github.com/zmata/LoxBerry-Plugin-SyslogServer/archive/v0.0.5.zip

All releases are listed here: https://github.com/zmata/LoxBerry-Plugin-SyslogServer/releases

===== Installation =====

The plugin can be installed as zip file into Loxberry. Similar to all other plugins.

===== Configuration options =====

First click at the "New" button. Fill in a unique name and IP address of the Miniserver. It's all. Configuration of the rsyslog and LogAnalyzer is done by scrypt.

===== Setup in the Loxone Config Software =====

Click at Messages in the Miniserver tree. Then click at Logger icon (or you can change settings of your current logger).

{{loxberry_english:plugins_english:1211859147.jpg?h=250}}

Logger is inserted. Fill name. In the "Address of Logger" fill something like "/dev/syslog/192.168.1.10". Use IP address of your LoxBerry!

{{loxberry_english:plugins_english:1211859148.jpg?h=250}}

Alternatively, you can use the entry "/dev/udp/192.168.1.10/514", where "514" is the standard listening port of rsyslog. If you want to use another, you can change it in the /etc/rsyslog.conf as root.

Finally assign a new logger to where you need it.

Alternatively, you can use the entry "/dev/udp/192.168.1.10/514", where "514" is the standard listening port of rsyslog. If you want to use another, you can change it in the /etc/rsyslog.conf as root.

Finally assign a new logger to where you need it.

===== Log Analyzer =====

{{loxberry_english:plugins_english:1211859155.png?h=250}}

In the upper right corner you can select Language, Style, Source (each configuration = one source), and View (actualy Syslog is best for Miniserver Log).

My parser fill date (date and time), ProcessID (Subject), Messagetype (my internal type - log line type) and Message.

In case of the Miniserver log you should have Loxone(n) in the Messagetype field. Number n depend on settings of the rsyslog. If you don't change settings, there "Loxone2".

If there is trouble with some messages line from another system, plase, send me part of the log file, and I'll update parser for it.

===== Roadmap =====

Solve rotated logs

===== Asking questions and reporting problems =====

Questions about the plugin will be answered in this wiki page. Please report your errors [[https://github.com/zmata/LoxBerry-Plugin-SyslogServer/issues|here]]. English or Czech language, please.