collector 命令

collector 命令用于收集性能数据，以供性能分析器进行分析。仅在本地模式中有效。

语法

collector command_list

指定一个或多个收集器命令

collector archive options

指定在实验终止时对其进行归档的模式（请参见collector archive 命令）。

collector dbxsample options

控制在 dbx 停止目标进程时是否收集抽样数据（请参见collector dbxsample 命令）。

collector disable

停止数据收集并关闭当前实验（请参见collector disable 命令）。

collector enable

启用收集器并打开新实验（请参见collector enable 命令）。

collector heaptrace options

启用或禁用收集堆跟踪数据（请参见collector heaptrace 命令）

collector hwprofile options

指定硬件计数器文件配置设置（请参见collector hw_profile 命令）。

collector limit options

限制记录的文件配置数据量（请参见collector limit 命令）。

collector mpitrace options

启用或禁用收集 MPI 跟踪数据（请参见collector mpitrace 命令）。

collector pause

停止收集性能数据，但让实验保持打开状态（请参见collector pause 命令）。

collector profile options

指定用于收集调用栈文件配置数据的设置（请参见collector profile 命令）。

collector resume

在暂停后开始收集性能数据（请参见collector resume 命令）。

collector sample options

指定抽样设置（请参见collector sample 命令）。

collector show options

显示当前收集器设置（请参见collector show 命令）。

collector status

查询有关当前实验的状态（请参见collector status 命令）。

collector store options

实验文件控制和设置（请参见collector store 命令）。

collector synctrace options

指定用于收集线程同步等待跟踪数据的设置（请参见collector synctrace 命令）。

collector tha options

指定用于收集线程分析程序数据的设置（请参见collector tha 命令）。

collector version

报告将用于收集数据的 libcollector.so 的版本（请参见collector version 命令）。

其中：

options 是可在各命令中指定的设置。

要开始收集数据，请键入 collector enable。

要关闭数据收集，请键入 collector disable。

collector archive 命令

collector archive 命令用于指定实验终止时要使用的归档模式。

语法

collector archive on|off|copy

缺省情况下，使用正常归档。如果不归档，请指定 off。要将装入对象复制到实验中以方便移植，请指定 copy。

collector dbxsample 命令

collector dbxsample 命令指定当 dbx 停止进程时是否记录抽样数据。

语法

collector dbxsample on|off

缺省情况下，当 dbx 停止进程时，收集抽样数据。如果此时不收集抽样数据，请指定 off。

collector disable 命令

collector disable 命令用于停止收集数据，并关闭当前实验。

语法

collector disable

collector enable 命令

collector enable 命令用于启用收集器，并打开新实验。

语法

collector enable

collector heaptrace 命令

collector heaptrace 命令指定用于收集堆跟踪（内存分配）数据的选项。

语法

collector heaptrace on|off

缺省情况下，不收集堆跟踪数据。要收集此数据，请指定 on。

collector hw_profile 命令

collector hw_profile 命令指定用于收集硬件计数器溢出文件配置数据的选项。

语法

collector hwprofile on|off

缺省情况下，不收集硬件计数器溢出配置文件数据。要收集此数据，请指定 on。

collector hwprofile list

打印可用计数器列表。

collector hwprofile counter name interval [name2 interval2]

指定硬件计数器名称和时间间隔。

其中：

name 是硬件计数器的名称。

interval 是收集时间间隔（毫秒）。

name2 是另一个硬件计数器的名称。

interval2 是收集时间间隔（毫秒）。

硬件计数器与系统特定相关，因此可供选择的计数器取决于使用的系统。许多系统都不支持硬件计数器溢出文件配置。在这些计算机中，这一功能被禁用。

collector limit 命令

collector limit 命令用于指定实验文件大小限制。

语法

collector limit value

其中：

value (MB) 是记录的文件配置数据量的限制值。达到该限制时，不再记录文件配置数据，但实验仍保持打开状态，且继续记录抽样点。记录的数据量的缺省限制为 2000 MB。

collector mpitrace 命令

collector mpitrace 命令指定用于收集 MPI 跟踪数据的选项。

语法

collector mpitrace on|off

缺省情况下，不收集 MPI 跟踪数据。要收集此数据，请指定 on。

collector pause 命令

collector pause 命令用于停止收集数据，但让当前实验保持打开状态。收集器暂停时不记录抽样点。在暂停前会生成一份抽样数据，且在恢复后立即生成另一份抽样数据。可以使用 collector resume 命令恢复数据收集（请参见collector resume 命令）。

语法

collector pause

collector profile 命令

collector profile 命令指定用于收集配置文件数据的选项。

语法

collector profile on|off

指定配置文件数据收集模式。

collector profile timer interval

指定配置文件计时器周期（定点或浮点），可在后面添加 m 表示毫秒或添加 u 表示微秒。

collector resume 命令

collector resume 命令用于在使用 collector pause 命令（请参见collector pause 命令）暂停数据收集后恢复数据收集。

语法

collector resume

collector sample 命令

collector sample 命令指定抽样模式和抽样时间间隔。

语法

collector sample periodic|manual

指定抽样模式。

collector sample period seconds

指定抽样时间间隔（以 seconds 为单位）。

collector sample record [name]

使用可选的 name 记录抽样数据。

其中：

seconds 是抽样时间间隔长度。

name 是抽样的名称。

collector show 命令

collector show 命令用于显示一种或多种选项设置。

语法

collector show

显示所有设置。

collector show all

显示所有设置。

collector show archive

显示归档设置。

collector show profile

显示调用栈文件配置设置。

collector show synctrace

显示线程同步等待跟踪设置。

collector show hwprofile

显示硬件计数器数据设置。

collector show heaptrace

显示堆跟踪数据设置。

collector show limit

显示实验大小限制。

collector show mpitrace

显示 MPI 跟踪数据设置。

collector show sample

显示抽样设置。

collector show store

显示存储设置。

collector show tha

显示线程分析程序数据设置。

collector status 命令

collector status 命令用于查询当前实验的状态。

语法

collector status

collector store 命令

collector store 命令用于指定存储实验的目录和文件名。

语法

collector store directory pathname

指定存储实验的目录。

collector store filename filename

指定实验文件名。

collector store group string

指定实验组名。

其中：

pathname 是要存储实验的目录的路径名。

filename 是实验文件名。

string 是实验组名。

collector synctrace 命令

collector synctrace 命令指定用于收集同步等待跟踪数据的选项。

语法

collector synctrace on|off

缺省情况下，不收集线程同步等待跟踪数据。要收集此数据，请指定 on。

collector synctrace threshold microseconds

以微秒为单位指定阈值。缺省值是 1000。

collector synctrace threshold calibrate

将自动计算阈值。

其中：

microseconds 是阈值，低于此阈值的同步等待事件都将被放弃。

collector tha 命令

语法

collector tha on|off

缺省情况下，不收集线程分析程序数据。要收集此数据，请指定 on。

collector version 命令

collector version 命令用于报告将用于收集数据的 libcollector.so 的版本。

语法

collector version