Skip to main content

Configuring Gateway Logging Settings on Zenconsole

Published on:
.
1 min read

Zenconsole allows you to configure logging settings for your Zenarmor gateway, including log levels, log rotation intervals, and log retention periods. These settings help you manage system logs, troubleshoot issues, and prevent excessive disk space consumption.

You can also manually delete old log files when necessary.

Accessing Gateway Logging Settings​

To access the logging settings for a gateway, follow these steps:

  1. Log in to your Zenconsole account.
  2. Navigate to Settings → Gateway Settings from the left-hand navigation menu.
  3. Select the gateway you want to configure.
  4. Click Logging in the gateway settings menu.

Figure 1. Gateway Logging Settings on Zenconsole

The Logging page displays the available settings for managing gateway logs.

Configuring Log Level​

The Level setting determines the severity and detail of messages recorded in the Zenarmor log files.

To configure the log level:

  1. Locate the Level field on the Logging page.

Figure 2. Configuring Log Level

  1. Select the appropriate log level from the dropdown menu.
  2. Click Save to apply your changes.

The default log level is INFO.

The following log levels are available:

Log LevelDescription
CRITICALRecords critical events that indicate essential application functionality is no longer working.
ERRORRecords errors that prevent one or more application functions from operating properly.
WARNINGRecords unexpected events or potential issues that may affect application processes without necessarily causing a failure.
INFORecords general operational information, such as application events and state changes.
DEBUGRecords detailed diagnostic information for troubleshooting and investigating issues.

Additional debugging levels include DEBUG2, DEBUG3, and DEBUG4, which provide more detailed diagnostic logging.

note

Debug logging should be used when detailed troubleshooting is required, as it may generate additional log data.

Configuring Log Rotation​

The Rotation setting determines how frequently Zenarmor rotates its log files. Regular log rotation helps manage log file sizes and prevents individual log files from growing excessively.

To configure log rotation:

  1. Locate the Rotation field on the Logging page.

Figure 3. Configuring Log Rotation

  1. Select the desired rotation interval from the dropdown menu.
  2. Click Save to apply your changes.

The following rotation intervals are available:

Rotation IntervalDescription
1 HourRotates log files every hour.
1 DayRotates log files daily. This is the default setting.
1 WeekRotates log files weekly.
note

Log rotation determines how frequently log files are rotated, not how long they are retained. To configure automatic log deletion, use the Retire setting.

Configuring Log Retention​

The Retire setting determines how long Zenarmor retains log files before automatically deleting them.

By default, log files older than 3 Days are automatically deleted.

To configure the log retention period:

  1. Locate the Retire field on the Logging page.

Figure 4. Configuring Log Retention

  1. Select the desired retention period from the dropdown menu.
  2. Click Save to apply your changes.

Zenarmor automatically deletes old log files according to the configured retention period.

warning

Log files may consume significant disk space if they are not rotated and deleted regularly. Select appropriate rotation and retention settings based on your available disk space and logging requirements.

Deleting Old Log Files Manually​

Zenconsole allows you to manually delete log files older than the configured retention period without waiting for automatic log retirement.

To delete old log files manually, follow these steps:

  1. Navigate to Settings → Gateway Settings and select the gateway you want to configure.
  2. Click Logging in the gateway settings menu.
  3. Locate the Retire field and review the configured retention period.
  4. Click Delete Now next to the Retire field.

Figure 5. Deleting Old Log Files Manually

  1. A warning dialog appears, indicating that logs older than the configured retention period will be deleted.
  2. Click Delete to confirm the operation or Cancel to keep the existing logs.
caution

This action deletes log files older than the configured retention period. For example, if Retire is set to 3 Days, logs older than three days will be deleted. Make sure these logs are no longer required for troubleshooting or diagnostics before confirming the deletion.