Configure options for the event and system logs

The default configuration for event and system logging is:

To change or disable the heartbeat interval, or to disable event categories, and to perform other log configuration:

 

  1. Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
  2. Access the device configuration:

    1. Locate your device as described in Use Digi Remote Manager to view and manage your device.
    2. Click the Device ID.
    3. Click Settings.
    4. Click to expand Config.

    1. On the menu, click System. Under Configuration, click Device Configuration.

      The Configuration window is displayed.

  3. Click System > Log.

  4. (Optional) To change the Heartbeat interval from the default of 30 minutes, type a new value. The heartbeat interval determines the amount of time to wait before sending a heartbeat event if no other events have been sent.

    Allowed values are any number of weeks, days, hours, minutes, or seconds, and take the format number{w|d|h|m|s}.

    For example, to set Heartbeat interval to ten minutes, enter 10m or 600s.

    To disable the Heartbeat interval, enter 0s.

  5. (Optional) To disable event categories, or to enable them if they have been disabled:
    1. Click to expand Event Categories.
    2. Click an event category to expand.
    3. Depending on the event category, you can enable or disable informational events, status events, and error events. Some categories also allow you to set the Status interval, which is the time interval between periodic status events.

      You can enable or disable Enable email notifications if you want to email a system log event notification to a specified email address. The email address must also be specified before a notification can be sent. To configure, see Configure an email notification for a system event.

      You can enable or disable Enable SNMP traps if you want system log event information saved to an SNMP trap. At least one SNMP destination must be defined before event information can be saved. To configure, seeConfigure an SNMP trap for a system event .

  6. (Optional) See Configure syslog servers for information about configuring remote syslog servers to which log messages will be sent.
  7. (Optional) To change the system log settings from the defaults, type in a new value.
    • System log rotation size: Specify the maximum size (measured in kilobytes) the system log file can reach before log rotation. When the specified size is reached, the system log rotates.

      Default is 200 kb. Minimum is 10 kb.

    • System log rotation count: Specify the number of system log files to keep.

      Default is 8. Minimum is 1; maximum is 20.

  8. Enable Preserve system logs to save the current session's system log after a reboot.

    By default, the AnywhereUSB Plus device erases system logs each time the device is powered off or rebooted.

    Note You should only enable Preserve system logs temporarily to debug issues. Once you are finished debugging, immediately disable Preserve system logs to avoid unnecessary wear to the flash memory.

  9. Click Apply to save the configuration and apply the change.
  1. Select the device in Remote Manager and click Actions > Open Console, or log into the AnywhereUSB Plus local command line as a user with full Admin access rights.

    Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.

  2. At the command line, type config to enter configuration mode:
    > config
(config)>
  3. (Optional) To change the heartbeat interval from the default of 30 minutes, set a new value. The heartbeat interval determines the amount of time to wait before sending a heartbeat event if no other events have been sent.
    (config)> system log heartbeat_interval value
(config)>

    where value is any number of weeks, days, hours, minutes, or seconds, and takes the format number{w|d|h|m|s}.

    For example, to set the heartbeat interval to ten minutes, enter either 10m or 600s:

    (config)> system log heartbeat_interval 600s
(config)>

    To disable the heartbeat interval, set the value to 0s

  4. Enable preserve system logs functionality to save the current session's system log after a reboot. By default, the AnywhereUSB Plus device erases system logs each time the device is powered off or rebooted.

    Note You should only enable Preserve system logs temporarily to debug issues. Once you are finished debugging, immediately disable Preserve system logs to avoid unnecessary wear to the flash memory.

    (config)> system log persistent true
(config)>
  5. (Optional) To disable event categories, or to enable them if they have been disabled:
    1. Use the question mark (?) to determine available event categories:
      (config)> system log event ?

Event categories: Settings to enable individual event categories.

 Additional Configuration
 -------------------------------------------------------------------------------
 arping                    ARP ping
 config                    Configuration
 dhcpserver                DHCP server
 firmware                  Firmware
 location                  Location
 modem                     Modem
 netmon                    Active recovery
 network                   Network interfaces
 openvpn                   OpenVPN
 portal                    Captive portal
 remote                    Remote control
 restart                   Restart
 serial                    Serial
 sms                       SMS commands
 speed                     Speed
 stat                      Network statistics
 user                      User
 wireless                  WiFi
 wol                       Wake-On-LAN

(config)> system log event
    2. Depending on the event category, you can enable or disable informational events, status events, and error events. Some categories also allow you to set the status interval, which is the time interval between periodic status events. For example, to configure DHCP server logging:
      1. Use the question mark (?) to determine what events are available for DHCP server logging configuration:
        (config)> system log event dhcpserver ?
...
DHCP server: Settings for DHCP server events. Informational events are generated
when a lease is obtained or released. Status events report the current list of
leases.

 Parameters                Current Value
 -------------------------------------------------------------------------------
 info                      true          Enable informational events
 status                    true          Enable status events
 status_interval           30m           Status interval

(config)> system log event dhcpserver
      2. To disable informational messages for the DHCP server:
        (config)> system log event dhcpserver info false
(config)>
      3. To change the status interval:
        (config)> system log event dhcpserver status_interval value
(config)>

        where value is any number of weeks, days, hours, minutes, or seconds, and takes the format number{w|d|h|m|s}.

        For example, to set the status interval to ten minutes, enter either 10m or 600s:

        (config)> system log event dhcpserver status_interval 600s
(config)>
  6. (Optional) See Configure syslog servers for information about configuring remote syslog servers to which log messages will be sent.
  7. Save the configuration and apply the change
    (config)> save
Configuration saved.
>
  8. Type exit to exit the Admin CLI.

    Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.