11.5 The Log Viewer

Whenever the Console or one of the endpoint programs encounters a problem, error informationis logged into the Vivinet Assessor database. When errors have occurred, the View Error Log button is enabled and an error symbol appears in the Results table.

Use the Log Viewer to read and organize the error information. To open the Log Viewer, click the View Error Log button.

The Log Viewer shows the record number of the entry, the date and time, the source of the error and a brief description of the error.

An error log for an assessment or verification is not saved to disk as a separate file. Instead, it is immediately committed to the database. Errors in the log are usually detected or caused by the endpoints. Errors caused by problems with the Scheduler service are handled slightly differently. For more information, see Section 11.3, Scheduler Errors.

The Log Viewer is available only if errors occurred during the present verification or run. Any errors that occurred during a previous verification or run are erased when an assessment is verified or run for a second time.

You can select the criteria for the entries that you want to view. For more information, see Section 11.5.3, Filtering Log Entries. You can also choose to see the entire error log for a VoIP Quality assessment, or the errors that occurred for a particular call group. To see the entire error log, click the View Error Log button. To see the error log for a single call group, highlight the group name in the Call Groups table. Right-click, and select View Error Log for this Call Group.

11.5.1 Reviewing an Error Log

Click Error Log on the View menu or click View Error Log to review the entries shown in the Log Viewer to determine why errors occurred during assessment verification or while an assessment was running. Click any column heading to sort the entries by that column. By default, entries are sorted by record number.

Error Log Component	Description
Record	Shows the order in which errors were detected. Record numbers do not change when sorting or filtering is applied.
Date/Time	The date and time the error was detected.
Detected by	The component that detected the error: either the Console or the endpoints
Call group	The endpoints in the call group. Endpoint 1 is listed first.
Description	Briefly describes the error.
Details button	Accesses detailed information about each error. The Log Details dialog box lets you scroll between error messages in the Log Viewer and also gives you access to Help for each message to help you avoid it in the future.
Filter button	Lets you determine which error messages are shown in the Log Viewer. For more information, see Section 11.5.3, Filtering Log Entries.
Find button	Helps you find a specific string in the Log Details dialog box. Highlights the record containing the string. You can double-click the highlighted record to view the details.
Refresh button	Refreshes the Log Viewer dialog box with any errors that have been detected since you opened the dialog box.

11.5.2 Viewing Error Details

To get more information about an entry in the Log Viewer, highlight the entry and click Details. The Log Details dialog box shows detailed information about the selected entry.

Log Details Component	Description
Help for Message	Provides more information about the error, including the steps you can take to avoid it.
Close	Closes the Log Details dialog box and returns to the Log Viewer.
Next	Shows details about the next entry in the log.
Previous	Shows details about the previous entry in the log.

11.5.3 Filtering Log Entries

Click Filter in the Log Viewer dialog box to determine which entries in the log are shown in the Log Viewer. Select Filter Log to enable filtering, and then choose from the following filtering options:

Option	Description
Filter by Date/Time	Filter out records based on certain date/time combinations. To build your filter, select either First Record or Records on in the From and To lists. If you want the Log Viewer to show the first entry generated during the assessment, select First Record. Clicking Records on lets you enter a date and/or time in the fields provided. Filter selection is based on a 12-hour clock with AM and PM designations.
Only Show Records With	If you want the Log Viewer to show only entries containing a specific error message, check the Message=CHR checkbox. Then enter or select the message number from the list. You can also filter the error log entries by call group. Check the Group checkbox and select the call group from the list. Record numbers remain unchanged after filters are applied to the Log Viewer. Their order indicates how the filter is being applied and which records have been filtered out.

Option

Description

Filter by Date/Time

Filter out records based on certain date/time combinations. To build your filter, select either First Record or Records on in the From and To lists. If you want the Log Viewer to show the first entry generated during the assessment, select First Record. Clicking Records on lets you enter a date and/or time in the fields provided. Filter selection is based on a 12-hour clock with AM and PM designations.

Only Show Records With

If you want the Log Viewer to show only entries containing a specific error message, check the Message=CHR checkbox. Then enter or select the message number from the list. You can also filter the error log entries by call group. Check the Group checkbox and select the call group from the list.

Record numbers remain unchanged after filters are applied to the Log Viewer. Their order indicates how the filter is being applied and which records have been filtered out.