Task Management

Prerequisites

No nodes are in the Offline state.

Procedure

1. Click next to System Diagnosis. The task creation page is displayed.
2. Set task parameters.
   

   • Click Import Template next to the Task Name text box to select and import a saved task template.
   • This section describes only common task parameters. For details about how to set other task parameters, see the corresponding analysis task sections.

   Table 1 Parameters for adding a task

   Parameter	Description
   Task Name	Name of the analysis task. A created task is automatically named in the Analysis type_Date_Time format. You can change the name as required. The name must meet the following requirements: Contain only letters, digits, and special characters (including @#$ %^&*()[]<>._-!-+ and spaces). The name cannot start or end with a space. Contain 1 to 32 characters.
   Select Nodes	Select the nodes to be analyzed. If there is only one node, this node is selected by default. A maximum of 10 nodes can be selected at a time.
   Diagnosis Object	Object to be diagnosed. The options are: Memory Network I/O Storage I/O
   Mode	Mode for the diagnosis object. This parameter is available only when Diagnosis Object is set to Memory. The options are: Launch application: starts the application when the sampling begins. The sampling duration is determined by the execution time of the application. This option is recommended for applications with short execution time. The analysis covers the application and its subprocesses. Attach to process: associates the existing PIDs on the server during data collection. You need to configure the sampling duration parameter (applicable to scenarios where the application runs for a long time). The analysis covers only the PIDs in the parameter, not the sub-processes of the PIDs.
   Diagnosis Scenario	Scenario of the diagnosis task. For memory diagnosis, the options are: Memory usage Memory overwriting For network I/O diagnosis, the options are: Network dialing test Packet loss diagnosis (this option is unavailable for the RDMA diagnosis type) Packet capture Network load For storage I/O diagnosis, the options are: Performance pressure test System load monitoring (this option is available only for DPC diagnosis and NFS diagnosis)
   Task Execution	The options are Execute now (default) and On a schedule. You need to set this parameter in Advanced Settings. If On a schedule is selected, you need to set Sampling Mode, Sampling Time, and Sampling Date. For Periodical sampling mode, the task runs once a day in the sampling period. You need to set Sampling Time and Sampling Date. For One-time sampling mode, the task takes effect only once. You need to set Sampling Date and Time. NOTE: A user can create a maximum of 20 scheduled tasks. You can click in the upper right corner of the page, choose Tool Settings > System Diagnosis, and click the Scheduled Tasks tab to view, edit, or delete (batch deletion supported) the created scheduled tasks. The Restart button is unavailable for scheduled tasks.

3. Click OK. For details about task parameters, see Table 1 and the related analysis task sections.

   You can click the icons next to the task name to perform the following operations:

   • : stops an analysis task. After an analysis task is stopped, the collected information will be deleted.
   • : restarts an analysis task. You can modify the task parameters and restart the analysis task.
   • : modifies an analysis task. Only the analysis tasks that are not started can be modified.
   • : deletes an analysis task. After a task is deleted, all data of this task will be deleted. Exercise caution when performing this operation.
   

   • The administrator devadmin can view, restart, and delete analysis tasks created by all users.

     Common users can view, restart, and delete their own analysis tasks and view the analysis tasks created by other users.

   • You can click Save as Template and enter a template name to save the configuration information of the current task as a template.

     The created template will be displayed in the task template list. You can click in the upper right corner and choose Task Templates to view and delete (batch deletion supported) task templates.

     A maximum of 10 templates can be saved for each analysis task type.

     All users can only view, import, and delete their own templates.

4. Importing/Exporting tasks
   After an analysis task is created, you can move the mouse pointer onto the task name to view the detailed task information. Analysis tasks can be imported and exported. See Figure 1.

   

   • You can also click in the upper right corner of the page and choose Import/Export Task to view task records. You can view and delete imported tasks, and download and delete exported tasks. If an import or export task fails, you can click Retry to execute the task again.
   • The administrator can export the tasks created by all users. Common users can export only tasks created by themselves.

   • : imports a project or analysis task, as shown in Figure 1. Two import modes are available. You can select a mode based on your requirements.
     Figure 1 Importing a task
     
     

     • If Import Mode is set to Upload file, select the exported compressed file and upload it.
     • If Import Mode is set to Specify file path, enter the absolute path of the file on the server. The devkitwork1 user must have the read permission on the specified file as well as the access and write permissions on the directory where the file is located.
   • : exports an analysis task. See Figure 1.
     

     You can collect data offline and then import the data for analysis.

     If the size of data to be exported exceeds 1 GB, the data is compressed into multiple compressed fragment sequence files whose size does not exceed 1 GB.

5. (Optional) Cancel data collection or cancel the whole task.

   When the task is running, you can click Start Analysis to stop data collection and start analysis immediately or click Cancel to stop the task.

   Figure 2 Canceling a task