Chapter 12. Logs

Table of Contents

Log Lists
Log Settings

Log Lists

Log Lists are available on the 'Bottom Bar' aswell as from the menu bar under the 'Aquirer' section. There are four log levels and three log sources. Every item logged is in one of these levels and comes from one of the sources. The log levels are:

  • Info
  • Warning
  • Error
  • Debug

Do not confuse these with alarms states, they are not related. 'Info' messages are informative messages about what Net-Probe is doing, the message is there to help the user understand how the program operates, an example would be the Aquirer start and stop messages. 'Warning' messages informs the user that Net-Probe has detected something not normally expected to occur, but which is not a problem internal to the program. 'Error' messages indicate the system has detected something unexpected, and may compromise the programs ability to operate as expected. Debug messages offer a lot of information about what the program is doing, for most users these messages would be of no value.

The source of the log message can be one of three types:

  • Alarm
  • Aquirer
  • Client

Alarm log messages come from changes in the state of an alarm target. You will also find messages related to 'Failure Actions' logged under this source. Messages coming from the Aquirer indicate the message originates from the system that performs the test for alarms or measurements for the graphs. Finally, messages from the Client refer to messages that have come from a viewer (the service, band and Net-Probe itself will be recorded as having come from this source).

The Bottom Bar Log Viewer always has "Follow Log' enabled. This means new entries are added automatically, as soon as they are reported. All log entries will have a date attached. All log viewers add the new log entry at the top of the list. If you have scrolled down from the top of the list, the viewer will not scroll as new messages are added. Move the scrollbar back to the top and the new messages will cause the older to scroll down (the 'Log Viewer' window offers additional controls relating to this feature, see below). The 'Bottom Bar' view toolbar offers controls as to which messages will be displayed, using a set of switches. The option to clear the displayed list is also offered with the 'clear' toolbar item.

The 'Log Viewer' window, accessible from the 'Aquirer' menu option on the menu bar, offers additional features not found on the 'bottom bar' viewer. The bottom bar log viewer will only display 1000 messages and then start to delete the older ones. There is no option to move back past this 1000 mark. The 'Log Viewer' windows also limits the list to 1000 items but allows for the ability of moving through the items, with 'Move First', 'Move Last', 'Move Next', 'Move Previous' and 'Follow Log' options. The moving options loads the first, last, previous and next 1000 log entries. The 'Follow Log' feature will move the log to the last 1000 entries and automatically add new entries as they are reported and remove the oldest off the list.

Figure 12.1. Log Viewer

Log Viewer

Logs entries are stored in a log file. The log can be found in the sub directory called 'Logs', under the installation directory. Each day a new log file is created based on the date. The Log Viewer window offers the ability to select older logs and examine them. Additional filtering is offered through the 'Type', 'Workspace' and 'Host' options, found on the toolbar.

Copyright (c) Warren Flemmer