Querying Profile Data File Information

Applicable Products

Product	Supported
Ascend 950PR/Ascend 950DT	√
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	√
Atlas inference products	√
Atlas training products	√

Function

This function is used to query profile data file information. Confirm that the model ID and iteration ID are specified during export.

During profile data parsing, the profile data file information is automatically displayed on the screen. Therefore, this function is optional in data parsing and is mainly used to query information about profile data files in the historically parsed PROF_XXX directories.

Precautions

Complete the operations in Before You Start first.
The profiling has completed.
Direct parsing on the device is not supported for the products below. You must copy the generated PROF_XXX directory to an environment where the Toolkit package is installed.
- Ascend RC scenarios of Atlas 200I/500 A2 inference products

Command Format

msprof --query=on --output=<dir>

Parameters

**Table 1** Parameters
Option	Description	Optional/Required
--query	Query of profile data file information. The value can be on or off (default). on: This option is enabled. off: This option is disabled. After data parsing, you can use this option to query the basic information about profile data files.	Required
--output	Directory for storing parsed profile data files. The value must be the PROF_XXX directory or the parent directory of the PROF_XXX directory, for example, /home/profiler_data/PROF_XXX. The path cannot contain the following characters: "\n", "\\n", "\f", "\\f", "\r", "\\r", "\b", "\\b", "\t", "\\t", "\v", "\\v", "\u007F", "\\u007F", "\"", "\\\"", "'", "\'", "\\", "\\\\", "%", "\\%", ">", "\\>", "<", "\\<", "\|", "\\\|", "&", "\\&", "$", "\\$", ";", "\\;", "`", "\\`".	Required

Example

Set the directory for storing parsed profile data files to /home/profiler_data/PROF_XXX and enable the function of querying profile data files.

msprof --query=on --output=/home/profiler_data/PROF_XXX

Output Description

Table 2 describes the information obtained by the query function of the msprof tool.

**Table 2** Profile data file information
Field	Description
Job Info	Job name.
Device ID	Device ID.
Dir Name	Folder name.
Collection Time	Data collection time.
Model ID	Model ID.
Iteration Number	Total number of iterations.
Top Time Iteration	Top five iterations with the longest time consumptions.
Rank ID	Node ID in the cluster scenario.

Parent topic: Using the msprof Command to Parse, Query, and Export Profile Data