Emailing log files
Logs, sensor data, measurement data, system settings, etc., can be transmitted via email from Didactum's LAN measurement and monitoring systems. Before sending, the files are first compressed (Gzip format, with the extension *.gz) and then stored on the monitoring device in an archive file (TAR format).
At the specified time, the archive file is sent to the email addresses stored in the monitoring device (maximum 10 different email recipients). To configure the sending of log files via email, please go to "System Settings" in the web interface, then to the "Logging" tab and select "Mail Log".
In this tab, you can control the following parameters:
- Status - shows the status of the last transaction;
- Enable logging - enables / disables the function to send the log archive via email;
- Enable detailed logging - enables and disables the recording of second values from selected intelligent sensors;
- Edit sensors list for detailed logging - opens a dialog box where you can individually select the sensors;
- Send period - sets the sending frequency of the log archive (from 2 to 24 hours);
- SMTP server - the path to the email outbound server;
- Port - the port of the outbound server;
- Enable TLS - if TLS SMTP is enabled, the session is opened within the encrypted connection (usually port 465);
- Enable STARTTLS - if STARTTLS is enabled, the encrypted connection is opened within the SMTP session (usually port 587, but can be 25, 2525 or another port);
- Login – username;
- Password - user password;
- Mail from - sender address;
- Mail to - recipient addresses, a comma-separated list of up to 10 email addresses, separated by commas, semicolons or spaces.
- Refresh - updates the data;
- Send - sends the current archive data to the email, if available;
- Save - saves the made settings
Important notes from the technical editorial team:
Sending log files via email can take several minutes. To avoid data loss, do not restart the monitoring system!
The archive file is sent as an attachment in the email. The TAR format is used by the monitoring device to create the archive, and the log files are stored in compressed Gzip format.
The archive file name contains the type and name of the monitoring device (if the name is set by default, the device's IP address is used) as well as the time the file was sent to the email, e.g.: Didactum100-srvroom_Wed-May_15_10-40-47_2018.log.tar.
The files are written to a directory whose name consists of the device type name (e.g. Didactum 100) and the value of the Network ? Hostname field. These then have the format Didactum 100-DeviceName.
If the name is not specified by the user (default hostname), the device's IP address is used to form the directory name. The name has the format Didactum 100-192.168.0.193.
Within this directory, directories are created for log files (Log), dump difference files (Diff), and full dump files. The files are named based on their creation time and look like 2018.05.17_16-37-43.log.
The file name extension indicates the content: log for log files, diff.csv for dump difference files, full.dump for full files.
At the beginning of the log file, service information about the device type, software version, IP address, and other log files (.log) is stored upon creation, and a complete memory dump in text form is written.
The log file looks like this: