Health log

Kaspersky IoT Secure Gateway 100 lets you configure the settings of the system health log. System health logs are saved in the directory /logs located on the TGW-HW-LOG partition of the microSD card.

To configure the health log settings:

1. Use a text editor to open the /logs/.log file located on the TGW-HW-LOG partition of the microSD card.

   The .log file is hidden because the file name begins with a dot. If the file is not displayed in the file manager, enable the display of hidden files.

2. In the LogFileSizeLimit parameter value, enter the maximum size (in bytes) of one system health log file. For example, LogFileSizeLimit=100000000.
3. In the DirectorySizeLimit parameter value, enter the maximum size (in bytes) of the directory containing all system health log files. For example, DirectorySizeLimit=1500000000.

   Kaspersky IoT Secure Gateway 100 does not process disk space overflow events. For this reason, make sure that the size of the log storage directory does not exceed the available disk space of the partition.

4. Save the changes in the .log file.

Sample configuration file:

.log

LogFileSizeLimit=100000000

DirectorySizeLimit=1500000000

If the .log file is absent, the log will not be written.

Log files writing and rotating rules

Log files are written and rotated according to the following rules:

• If the size limit of one log file is exceeded during data write operations, a new file is created and the data is written to the new file.
• If a data string could not be completely written due to the size limit of one log file, a new file is created, the data string is written to this new file, and subsequent data will be written to the new file.
• If the size limits of one log file and all log files are exceeded when writing a data string, the old log file is deleted, a new file is created, and subsequent data will be written to this new file.
• If the limit for all log files is exceeded when writing a data string, the old file is deleted and the data string is written to the current file.
• Old log files are deleted in such a way to ensure that there is sufficient memory for writing a data string.
• A new file for log writing is created each time the gateway is loaded or restarted.

Information written to log files

The following information is recorded to log files:

• Initialization status of hardware components
• KasperskyOS loading status

  A microkernel operating system for building secure solutions.

• Initialization status of system components
• Initialization and operating status of:
  • network services
  • data repository
  • system logging service
  • components of applications:
    • OPC UA client and manager

      Specification defining the protocols and mechanism for data transfer in industrial networks as well as interaction between devices in these networks.

    • MQTT client and manager

      A network protocol that works on top of the TCP/IP protocol stack to exchange messages between devices on the internet of things.

    • data transfer component
• Transmitted data elements
• Initialization and loading errors