ipMonitor® records a number of separate log files to provide Administrators with the necessary information required for diagnostic and troubleshooting purposes. Use the log files generated by ipMonitor to:

• Obtain information about internal ipMonitor events, such as denied access requests, Alert usage, Monitor state change, etc.
• Retrieve diagnostic information that would be displayed if ipMonitor was run at the command line (Desktop Mode).
• Access information relating to SNMP Traps received by ipMonitor.
• Track all generated Reports.

Top of page

Depending on your ipMonitor configuration, some or all of the following log files may be viewable from the Logs screen:

• ipm8.log
• runtime.log
• runtime_bkg_reports.log
• snmptrap.log

ipm8.log
The ipm8.log file provides a record of events that have occurred internally within ipMonitor. The following optional events may be recorded into the ipm8.log file:

• Record ipMonitor Startup and Shut Down.
• Record Access Attempts by Locked Out IP Addresses.
• Record Invalid HTTP Requests.
• Record Denied Access Requests (User Rights, Failed Login, Improper Credential).
• Record Attempts to Use Expired User Sessions.
• Record User Session Creation.
• Record User Session Termination.
• Record User Session Expiration (Due to Inactivity).
• Record Tests Failures.
• Record Test Recovery from Failure State.
• Record Monitor State Change.
• Record Profile Use.
• Record Profile Being Skipped.
• Record Missing Alert Availability.
• Record Alert Usage.
• Record Alert Being Skipped.

runtime.log
As a diagnostic procedure, earlier versions of ipMonitor prior to 7.x could be run at the command-line in what was referred to as Desktop Mode. When running ipMonitor in this mode, certain diagnostic information was written to the console. Recent versions of ipMonitor now include the runtime.log file to provide the same diagnostic information.

runtime_bkg_reports.log
The runtime_bkg_reports.log file is created by the Background Report Generator to track all the Reports generated. The log file is overwritten each night with updated information.

snmptrap.log
The snmptrap.log file is used to record information relating to SNMP Traps that have been received by ipMonitor 8. It will only be displayed if there are entries in the log file. The following optional events may be recorded in the snmptrap.log file:

• Record Received SNMP Traps Not Expected by Any Configured Monitors.
• Record Received SNMP Traps Expected by Configured Monitors.
• Record the Contents of Any Received SNMP Trap in snmptrap.log.

Top of page

The Logs menu is used to roll or delete log files. Select individual log files to perform maintenance actions.

Delete
When a log file is deleted, it is permanently removed from ipMonitor. A confirmation prompt will be displayed before the file is deleted.

Roll File
When a log file is rolled, ipMonitor renames the file to include the current date and creates a new, empty log file in its place. A confirmation prompt will be displayed before the file is rolled.

View File
Log file entries are recorded chronologically from oldest to most recent. To view one of the log files, click the File Name and select viewing options. The log file will be displayed in a new web browser window.

View 'x' % of the file
The specified percentage of the log file will be displayed. The default is 100% of the file. Valid settings are from 1% to 100%.

View the last 'x' lines of the file
The specified number of lines will be displayed. The default setting is 250 lines.

View the last 'x' lines of the file (in reverse)
The specified number of lines will be displayed in reverse order. The default setting is 250 lines.

Note: To control the size of your log files, simply trim back some of your enabled logging options. For more information, refer to the section titled Log Settings.

Top of page