Configuring Gateway Logging Settings on Zenconsole
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:
- Log in to your Zenconsole account.
- Navigate to Settings → Gateway Settings from the left-hand navigation menu.
- Select the gateway you want to configure.
- 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:
- Locate the Level field on the Logging page.
Figure 2. Configuring Log Level
- Select the appropriate log level from the dropdown menu.
- Click Save to apply your changes.
The default log level is INFO.
The following log levels are available:
| Log Level | Description |
|---|---|
| CRITICAL | Records critical events that indicate essential application functionality is no longer working. |
| ERROR | Records errors that prevent one or more application functions from operating properly. |
| WARNING | Records unexpected events or potential issues that may affect application processes without necessarily causing a failure. |
| INFO | Records general operational information, such as application events and state changes. |
| DEBUG | Records detailed diagnostic information for troubleshooting and investigating issues. |
Additional debugging levels include DEBUG2, DEBUG3, and DEBUG4, which provide more detailed diagnostic logging.
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:
- Locate the Rotation field on the Logging page.
Figure 3. Configuring Log Rotation
- Select the desired rotation interval from the dropdown menu.
- Click Save to apply your changes.
The following rotation intervals are available:
| Rotation Interval | Description |
|---|---|
| 1 Hour | Rotates log files every hour. |
| 1 Day | Rotates log files daily. This is the default setting. |
| 1 Week | Rotates log files weekly. |
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:
- Locate the Retire field on the Logging page.
Figure 4. Configuring Log Retention
- Select the desired retention period from the dropdown menu.
- Click Save to apply your changes.
Zenarmor automatically deletes old log files according to the configured retention period.
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:
- Navigate to Settings → Gateway Settings and select the gateway you want to configure.
- Click Logging in the gateway settings menu.
- Locate the Retire field and review the configured retention period.
- Click Delete Now next to the Retire field.
Figure 5. Deleting Old Log Files Manually
- A warning dialog appears, indicating that logs older than the configured retention period will be deleted.
- Click Delete to confirm the operation or Cancel to keep the existing logs.
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.