Monitor Previous Server Activity
Ivanti Voice generates log messages containing information about server events when they occur, and stores these messages in log files. Use the Log Viewer interface to view log messages and log files.
Use the Events Log on the Management Console to view only critical log messages. For more information, refer to Viewing Log Messages in the Management Console.
Log Messages
Log messages are notifications Ivanti Voice generates containing information about a server activity after it happens.
Ivanti Voice generates five levels of log messages:
•Trace
•Debug
•Information
•Warnings
•Errors
•Panic
Log Message Properties
Log messages have the following properties:
•Date - The date the error occurred.
•Code - An integer code of the log message assigned by the component that generated the log message. (Most components do not assign codes.)
•Text - A text description of the log message.
•Application name - The name of the component that generated the log message.
•HRESULT - The numeric result code if the log message contains results of internal function calls. 0 generally indicates OK, other values indicate some type of failure.
•Operation ID - The last operation the application executed before generating the log message.
•Method name - The name of the method in the C++ code that generated the log message.
•“This” - The hexadecimal value of the runtime pointer to the object that generated the log message.
•TID (Thread ID) - The numeric ID of the execution thread that generated the log message.
•CLSID - The COM Class ID of the component.
•Instance ID - The unique ID of the instance of the component that generated the log message, if the components can exist in multiple instances. For example, a separate instance of the Interpreter exists for each inbound call.
•PID (Process ID) - The numeric ID of the system process that generated the log message.
•Module name - The full name of the executable or DLL file that generated the log message.
•Version - The version number of the module that generated the log message.
•Host - The host computer name.
•Level - The log message level.
Log Files and Log Viewer
Ivanti Voice stores log messages in the database. When troubleshooting, you may need to export log data and send it to an Ivanti Solutions representative.
To access the Log Viewer, click Start > Programs > Solutions > Communications Management > Management Portal > Log Viewer.
Use the Log View to:
•View Previously Exported Log Data
View Log Messages
You can view but cannot edit log message properties.
To View Log Message Properties:
1.In the Log Viewer, click the link in the Date column to view the log message properties. The Full Record Info dialog box opens.
2.To print a log message, right-click the Full Record Info dialog box and select Print.
3.Click Filter to apply a filter to the Log Viewer (refer to Apply Filters).
Export Log Data
The Log Viewer allows you to export log data to a file that can be opened in Microsoft Access. The Log Viewer compresses the Access file (.mdb) into a zipped file before downloading it.
To Export Log Data:
1.In the Log Viewer, click the Import/Export button. The Log Import/Export dialog box opens.
2.In the Export log data field, type a name for the exported archive. The Log Viewer will create an Access file with this name and then compress it to a .zip file with the same name (do not enter a file extension).
3.Click Export.
4.Click the Save button in the File Download dialog box.
5.In the Save As dialog box, specify the location for the zipped archive.
View Previously Exported Log Data
The administrator can view previously exported data by uploading the .mdb file into the Log Viewer.
To View Previously Exported Log Data:
1.In the Log Viewer, click the Import/Export button. The Log Import/Export dialog box opens.
2.In the View exported data field, type the file name or click Browse to locate the file to be imported.
3.Click View log data.
4.The Log Viewer displays only the previously exported data. Click the Return to native log link in the upper left to return to normal view.
Apply Filters
The Log Viewer is highly configurable, enabling you to specify the types of log messages you want the interface to display using filters. Filters let you specify the criteria a log message must meet for the Log Viewer to display it. For example, you can choose to view only log messages with a certain error code, or log messages from a particular application.
You can create and apply filters to the Log Viewer, causing the Log Viewer to display only the log messages matching your criteria.
To Apply a Filter:
•In the Log Viewer, click the Log Filter button.
The Log Filter dialog box has a row for each type of log message property. Each row has one or more drop-down lists containing operators (such as < and >), with adjacent fields that activate when you select an operator:
•< Less than
•> Greater than
•>= Greater than or equal to
•<= Less than or equal to
•= Equal to
•!= Not equal to
•LIKE Search for strings that match a predetermined pattern.
•NOT LIKE Search for strings that do not match a predetermined pattern.
•Use the drop-down lists and adjacent fields to specify the criteria the filter uses when determining whether or not to display a log message. For example, to create a filter that only displays log messages with the code 20405, select = in the Code drop-down list, and enter 20405 in the adjacent field.
•In addition to the other log message properties, you can filter log messages based on the following:
•Host - Use the Host drop-down list and adjacent field to specify the computer from which you want to receive log messages (if your log system is configured to collect messages from multiple computers.
Ivanti Voice does not currently use a multi-host environment, so all messages in the log are from the same computer.
•Date - Use the Date drop-down list and adjacent fields to specify a time frame or specific date for the filter to use.
•Level - Use the Level drop-down lists to specify the level of log messages you want to view.
For example, to create a filter to display Warning log messages that host machine SuperServer1 generated before April 1, 2015, do the following:
1.In the Date drop-down list, select < and enter 4/1/2015 in the adjacent field.
2.In the Host drop-down list, select = and enter SuperServer1 in the adjacent field.
3.In the Level drop-down lists, select = and Warning.
4.Click the Submit button after specifying your criteria to apply the filter.
Click the Reset button to clear your criteria from the fields in the Log Filter dialog box. Click the Clear button to remove filters from the Log Viewer.
•Once you apply the filter, the Log Viewer displays only the log messages that match the criteria. A filter indicator appears in the top left of the Log Viewer, indicating that the log message list is being filtered.
•Click the Remove link to remove the filter and view the complete list of messages.
Modify Log Columns
You can modify message properties the Log Viewer displays as columns in the Log Viewer.
To Modify Log Viewer Columns:
1.In the Log Viewer, click the Log Columns button. The Log Columns dialog box opens.
2.In the Show column, select the check box next to each property you want the Log Viewer to display. Click the Reset button to reset the columns shown to the default settings (showing the Date, Text, Application name, and HRESULT columns).
3.To change the order in which the columns appear, select the radio button in the Edit column, then click the Move Up or Move Down button to reposition that column.
4.Click Submit.
Change Log Levels
In addition to applying filters, you can use the Log Levels screen to determine which levels of log messages the Log Viewer records.
Detailed log levels can have an adverse effect on system performance.
To Change Log Levels:
1.In the Log Viewer, click the Log Levels button. The Log Levels dialog box opens.
2.Select the level for the desired application.
Advanced Functions
Since Ivanti Voice stores log messages in the SQL database, you can use arbitrary SQL SELECT statements to perform advanced filtering of the log messages. You can write your own SELECT statement (query) in the Submit Custom Query field of the Advanced dialog box and apply it. The query uses log database table descriptions contained in Ivanti Voice Database Details.
Autoupdate
You can specify the frequency for updates of Log Viewer information.
To specify the Autoupdate frequency:
•At the top right of the Log Viewer page, select the Autoupdate check box and enter the frequency (in seconds). The frequency default is 5 seconds.
Autoscroll
You can also indicate whether or not you want the Log Viewer to automatically scroll back to the top of the list with each update.
To Specify Autoscrolling:
•In the Log Viewer, select the Autoscroll to top after page update check box.
Paging
To Page through the Log Viewer:
•Click the page number link at the top right of the Log Viewer.
To Go to a Specific Page:
•Type the page number in the Page field and click Go.
To Specify the Number of Lines per Page:
•Enter the number of lines in the Lines per page field. The default is 50.