Data Management Capabilities > Using Packages to Import and Export Data for Offline Collaboration > Import Received Delivery > Instrumentation Logging Mechanism for the Import Process
  
Instrumentation Logging Mechanism for the Import Process
The generation of log files in the import functionality is improved to provide you with the detailed information about the import process. For more information, see Enabling the Logger.
The following loggers have been introduced:
• com.ptc.windchill.rd.instrumentation
• wt.ixb.instrumentation
The log files work as follows:
• Before starting the import operation, enable or disable the generation of log files.
• When the logger is enabled, the system generates separate log files for different types of logs, such as Heap dump, Histogram, and so on. For example: set the logger to INFO, TRACE, or DEBUG.
* 
PTC recommends setting the property wt.heapDumps.dir with an accessible and preferred location as value in the wt.properites file. For example: wt.heapDumps.dir=F:\\PTC\\Fox96UpB73\\InstrumentationLogs. By default, the additional log files are stored at WT_Home\heapDumps folder.
Pre-requisites for Generating Additional Log Files
To generate additional log files, you must create the following files:
• Thread dump file
• Heap dump file
Thread dump file
The following table describes the properties that you must enable to create the Thread dump file.
Property Name
Value
Purpose
wt.ixb.instrumentation.enableThreadDumps
true
To create the Thread dump file, enable the property value as true in the wt.properties file.
com.ptc.windchill.rd.instrumentation.enableThreadDumps
true
Heap Dump File
The following table describes the properties that you must add to create the additional Heap dump file for different stages.
Property Name
Value
Purpose/Comment
wt.ixb.instrumentation
Import-ObjectBatch, Import-TransactionBatch-PreCommit
To create the additional Heap dump file for different stages, add the property in the wt.properties file.
com.ptc.windchill.rd.instrumentation
PreImport-Tagging, FBReadiness-VersionMismatch-Calculation
Types of Log Files
The following types of log files are generated:
• Heap dump
• Histogram
• Thread dump
Stages of Import
The following are the stages of import:
Property Name
Stages of import
wt.ixb.instrumentation
• Import-ObjectBatch
• Import-TransactionBatch-PreCommit
• Import-TransactionBatch-PostCommit
com.ptc.windchill.rd.instrumentation
• Import-MissingObjects-Handling
• PreImport-Tagging
• FBReadiness-VersionMismatch-Calculation
Values for Setting the Logs
You can set the following log levels to generate INFO, DEBUG, and TRACE as per the requirement.
Log Level Name
Value
Info
No files are generated on this log level
DEBUG
ThreadDump-Import-Batch.txt
ThreadDump-IX-TransactionBatch-PreCommit.txt
ThreadDump-IX-TransactionBatch-PostCommit.txt
GCHistogram-IX-TransactionBatch-PreCommit.txt
TRACE
ThreadDump-Import-Batch.txt
ThreadDump-IX-TransactionBatch-PreCommit.txt
ThreadDump-IX-TransactionBatch-PostCommit.txt
GCHistogram-IX-TransactionBatch-PreCommit.txt
HeapDump-IX-TransactionBatch-PreCommit.hprof
Enabling the Logger
To enable the logger for the required level, do the following:
1. Log in to Windchill as a System administrator and browse to the Utility section.
2. Click Server Status under System Administration. The Server Status page opens.
3. Click Monitoring Tools on the Server Status page. The System Health Monitoring Tools page opens.
4. Click Log Levels.
5. On the Log Levels page, in the Server Processes section, select Method Servers, and Servlet Engines.
6. In the Logger field, specify the log type required. For example: com.ptc.windchill.rd.instrumentation or wt.ixb.instrumentation.
7. In the Level field, click Get. The Level field is now populated with the options related to the specified logger.
For example: If the logger type is specified as com.ptc.windchill.rd.instrumentation, the following levels are available.
◦ OFF – Disables logging
◦ FATAL – Sets logging of fatal values
◦ ERROR – Sets logging of errors
◦ WARN – Sets logging of warning
◦ INFO – Sets logging of information
◦ DEBUG – Sets logging of debug
◦ TRACE – Sets logging of trace
◦ ALL – Sets logging of all values
8. Select INFO and click Set. The logging process starts, and loggers are set at the INFO level.