Querying Profile Data File Information

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

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 scenario of the Atlas 200I/500 A2 inference product

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 the Profile Data