Intel® Trace Analyzer and Collector User and Reference Guide
ID
767272
Date
10/31/2024
Public
Tracing Conventional MPI Applications
Tracing Failing MPI Applications
Tracing OpenSHMEM* Applications
Tracing MPI File IO
Handling of Communicator Names
Tracing MPI Load Imbalance
Tracing User Defined Events
Configuring the Collector
Filtering Trace Data
Recording OpenMP* Regions Information
Tracing System Calls (Linux* OS)
Collecting Lightweight Statistics
Recording Source Location Information
Recording Hardware Performance Information (Linux* OS)
Recording Operating System Counters
Tracing Library Calls
Correctness Checking
Tracing Distributed Non-MPI Applications
ACTIVITY
ALTSTACK
AUTOFLUSH
CHECK
CHECK-LEAK-REPORT-SIZE
CHECK-MAX-DATATYPES
CHECK-MAX-ERRORS
CHECK-MAX-PENDING
CHECK-MAX-REPORTS
CHECK-MAX-REQUESTS
CHECK-SUPPRESSION-LIMIT
CHECK-TIMEOUT
CHECK-TRACING
CLUSTER
COMPRESS-RAW-DATA
COUNTER
CURRENT-DIR
DEADLOCK-TIMEOUT
DEADLOCK-WARNING
DEMANGLE
DETAILED-STATES
ENTER-USERCODE
ENVIRONMENT
EXTENDED-VTF
FLUSH-PID
FLUSH-PREFIX
GROUP
HANDLE-SIGNALS
INTERNAL-MPI
KEEP-RAW-EVENTS
LOGFILE-FORMAT
LOGFILE-NAME
LOGFILE-PREFIX
LOGFILE-RANK
MEM-BLOCKSIZE
MEM-FLUSHBLOCKS
MEM-INFO
MEM-MAXBLOCKS
MEM-MINBLOCKS
MEM-OVERWRITE
NMCMD
OS-COUNTER-DELAY
PCTRACE
PCTRACE-CACHE
PCTRACE-FAST
PLUGIN
PROCESS
PROGNAME
PROTOFILE-NAME
STATISTICS
STATE
STF-PROCS-PER-FILE
STF-USE-HW-STRUCTURE
STOPFILE-NAME
SYMBOL
SYNC-MAX-DURATION
SYNC-MAX-MESSAGES
SYNC-PERIOD
SYNCED-CLUSTER
SYNCED-HOST
TIME-WINDOWS (Experimental)
Syntax
Variable
Description
Example
TIMER
TIMER-SKIP
UNIFY-COUNTERS
UNIFY-GROUPS
UNIFY-SCLS
UNIFY-SYMBOLS
VERBOSE
VT_START_PAUSED
VT_COMPRESS_TRACE
Parameter Checking
Premature Exit
Overlapping Memory
Detecting Illegal Buffer Modifications
Buffer Given to MPI Cannot Be Read or Written
Distributed Memory Checking
Illegal Memory Access
Request Handling
Datatype Handling
Buffered Sends
Deadlocks
Checking Message Transmission
Datatype Mismatches
Data Modified during Transmission
Checking Collective Operations
Freeing Communicators
Process Aggregation
Function Aggregation
Function Group Color Editor
Filtering Dialog Box
Tagging Dialog Box
Idealization Dialog Box
Imbalance Diagram Dialog Box
Trace Merge Dialog Box
Details Dialog Box
Source View Dialog
Time Interval Selection
Configuration Dialogs
Find Dialog Box
Command line for Intel® VTune™ Profiler and Intel® Advisor Dialog Box
OTF2 to STF Conversion Dialog Box
Configuration Assistant
TIME-WINDOWS (Experimental)
Syntax
TIME-WINDOWS <time_value1>:<time_value2>[,<time_value1:time_value2>]
See the description of the time format in Time Value.
Variable
VT_TIME_WINDOWS
Description
Use the TIME-WINDOWS option to set up a time frame within which the Intel® Trace Analyzer and Collector will save the events into the trace file. When TIME-WINDOWS is not set, Intel Trace Analyzer and Collector collects the whole trace.
To set several time windows, use the necessary number of time frames separated by commas.
NOTE:
In some cases correct order of messages can be lost and you can get a message about reversed timestamps:
[0] Intel® Trace Collector WARNING: message logging: 168 different messages, 0 (0.0%) sends without receive, 5 (3.0%) receives without send, 163 (97.0%) messages with reversed time stamps.
To avoid this issue, include the first communication into the first time window. The time of the first communication depends on the application.
Example
TIME-WINDOWS 0:1,10:20
In this case, Intel Trace Analyzer and Collector will trace the first communication, the events from the beginning to the first second and the events from the 10th to the 20th second.
Parent topic: Configuration Options