How To Increase Logging for One-X Agent

Description:

When troubleshooting Avaya One-X Agent there may be instances where you will need increase the logging level to further the investigation.

Steps:

First step is to exit the one-X Agent application and modify the Config.xml file that is located under the %appdata%\Avaya\one-X Agent\2.5 folder; if you copy the underlined string into the Windows Explorer Address box it will navigate to the proper location regardless the Windows OS in use.

This deeper level of Spark Emulator logging will impact CPU occupancy, so usage of other applications should be considered while testing.

The following 8 lines need to be properly placed within the Config.xml file or logging could become erratic and unreliable, essentially breaking logging.

<parameter>

<name>LocalLogLevel</name>

<value>7</value>

</parameter>

<parameter>

<name>LogCategoryList</name>

<value>EXTAPP,SESSION,CORE,SIGNAL,AUDIO</value>

</parameter>

The values in RED are the various categories that can be scrutinized.

Those ‘values’ for the Log Category List are:

EXTAPP - Shows the XML messages that are exchanged between Spark Emulator clients such as one-X Agent UI and AVC

SESSION - Session Manager. It logs communications with the switch and also CCMS messages.

DIAL – Shows how dialing rules are processed

CORE – Core Processes

SIGNAL – Signal Manager Interface. Provides additional CCMS processing;

AUDIO – Shows logging of Spark interfacing with the ISpeak library

The positioning of these 8 lines needs to be placed after the closing parameter (</parameter>) for TransmitGain (if there), and if not there after the closing parameter for the AlternateServerListTimeOut setting.

Example placement:

With ReceiveGain and Transmit Gain present:

<name>TransmitGain</name>

<value>0.37</value>

</parameter>

<parameter>

<name>LocalLogLevel</name>

<value>7</value>

</parameter>

<parameter>

<name>LogCategoryList</name>

<value>EXTAPP,SESSION,CORE,SIGNAL,AUDIO</value>

</parameter>

<parameter>

<name>AECMode</name>

Without ReceiveGain and Transmit Gain settings:

<parameter>

<name>AlternateServerListTimeOut</name>

<value>30</value>

</parameter>

<parameter>

<name>LocalLogLevel</name>

<value>7</value>

</parameter>

<parameter>

<name>LogCategoryList</name>

<value>EXTAPP,SESSION,CORE,SIGNAL,AUDIO</value>

</parameter>

<parameter>

<name>AECMode</name>

The application needs to be restarted after this change is made, and then validate that the Level 7 logging is being captured by opening the EndpointLog.txt file and confirm DebugHigh (DBH) entries are observed, i.e.:

[02/05/2013 12:59:23:011] DBH:    SESSION: [3068] CallController::OnMessageReceived: 338

It may be easier to make 2 copies of the config.xml file, naming one config.orig and the other config.logging, and make the changes to the config.logging file. Then, rename the config.logging to config.xml and restart the application. Once captured, rename config.xml to config.logging and rename the config.orig to config.xml and restart the application with the default logging level.

Disclaimer: intlx Solutions Knowledge Base

The information contained in this knowledge base ("Content") is provided for informational purposes only and is intended to be a general resource. intlx Solutions does not guarantee the accuracy, completeness, or timeliness of the Content.

Use at Your Own Risk: By accessing and using the Content, you agree that you do so at your own risk. intlx Solutions assumes no responsibility for any errors or omissions in the Content, nor for any damages or losses you may suffer arising out of or related to the use of the Content.

Current Customers: If you are a current intlx Solutions customer and have questions or require further clarification on any information presented here, please do not hesitate to contact our support team directly. They are available to assist you and ensure you have the most up-to-date information specific to your needs.

Not a Customer? If you are not currently an intlx Solutions customer but are interested in learning more about our solutions and how we can help your business, please click here. We look forward to the opportunity to discuss your needs and explore how a partnership with intlx Solutions can benefit you.

Thank you for your understanding.