What are the various types of logging available in the MSP New Driver?

Document ID : KB000013976
Last Modified Date : 14/02/2018
Show Technical Document Details
Question:

What are the various types of logging available in the Microsoft Project (MSP) New Driver?

Environment:
This applies to the MSP New Driver 14.x and higher
Answer:

There is enhanced logging available in the MSP New Driver, some additional configuration may need to be setup to use the various logs fully in troubleshooting. Some of the information in the logs may be more complex and may need to be sent to CA Support to review to analyze root cause of issues. 

Location: The logs and logger.properties file are found in the Documents\logs folder on the workstation. 

How to enable Debugging:

For troubleshooting, make the below changes to the logger.properties file found in the logs folder. To edit the logger.properties file, open the file in a text editor such as Notepad or Microsoft Word. By default, each of the options should be set to 'error'.

http=warning 
general=debug 
xml=debug
timing=error 
archive=error (Note, this option is not yet available, this can be left to the default)

Log types:

The different types of logs currently available are:

  1. mspxml_http.log

    - http field in the logger.properties generates this log

    - Shows messages regarding mapped fields, and data mismatches

  2. mspxml_general.log

     

     

    - general field in the logger.properties file generates this log

    - Shows server communication messages and errors

    - Will also log any data discrepancies (set to debug in logger.properties to get this)

    - This will also show assertion failures and errors encountered with the client driver

    - This can also help point to any mapping issues. mspxml_general.log will include: Assertion fails in ..\caMsputil\MSPAttributeEnum.cpp.

  3. mspxml_timing.log

    - Timing field in the logger generates this log

        - This will generate timings on the export and import including number of objects and the timing of the write and open of the xml. (Some items included for the project are # of Baselines, # of Assignments, # of Tasks. If there are none of the object type available for the project, the object won't show up in the timing log  (Example, if there are no Baselines, than Baselines won't show up as a line item in the timing log for that project)

Below is an example of the type of information you may see in the file (dependent on the type of data in the project)

timinglog.JPG

        - If you need CA Support's assistance in troubleshooting performance issues, please be sure to include this file as well as the mpp and xml for the project if available

   4. xml for the file being exported from PPM (found in the default MSP Save directory, typically the \Documents folder on the workstation)

    - Set general (not xml) to debug in the logger.properties file to keep the .xml file in the MSP save directory from being removed. This is good to use for troubleshooting, but can also take up a lot of space, so make sure to set general back to error when not in use for troubleshooting

   - XML is used to review the data being exported from PPM for use in troubleshooting. Example, if you are facing a data issue, and the data is correct in the XML, but when you open the XML in MSP, the data is incorrect, this can indicate the issue most likely is a MSP issue versus PPM (though not always)

Additional Information:

Reference TEC1075677 for more information on performance issues when working with MSP.