ITEEDU

Typeperf

把性能计数器数据写到命令窗口或支持该功能的日志文件格式中。要停止 Typeperf,请按 CTRL+C。

语法

Typeperf [Path [path ...]] [-cf FileName]  [-f {csv|tsv|bin}] [-si interval] [-o  FileName] 
[-q [object]] [-qx [object]] [-sc  samples] [-config FileName] [-s  computer_name]

参数

-c {Path [path ...] | -cf FileName}

指定用来登录的性能计数器路径。要列出多个计数器路径,请用空格将每个命令路径隔开。

-cf FileName

指定包含要监视的计数器路径的文件的名称,每行一个文件名。

-f {csv|tsv|bin}

指定输出文件格式。文件格式包括 csv(以逗号分隔)、tsv(以制表符分隔)以及 bin(二进制)。默认格式为 csv。

-si interval [mm:]ss

指定范例之间的时间间隔,以 [mm:]ss 格式。默认值为一秒钟。

-o FileName

指定输出文件的路径名。默认为 stdout。

-q [object]

显示和查询不包含实例的可用计数器。显示一个对象的计数器,包括该对象的名称。

-qx [object]

显示和查询包含实例的所有可用计数器。显示一个对象的计数器,包括该对象的名称。

-sc samples

指定要收集的范例的数量。默认为一直采样,直到按 CTRL+C 时为止。

-config FileName

指定包含命令行参数的设置文件的路径名。

-s computer_name

如果在计数器路径中未指定服务器,则指定要监视的系统。

/?

在命令提示符显示帮助。

注释

计数器路径格式

计数器路径的通用格式如下:

[\\Computer]\object[parent/instance#index]\counter] where:

父节点、事例、索引和格式的计数器组件可以是有效名或通配符。不是所有计数器都必须具有计算机、父节点、事例和索引组件。

可以根据计数器本身决定计数器路径。例如,LogicalDisk 对象具有事例 index,所以必须提供 #index 或通配符。因此,可以使用如下格式:

\LogicalDisk(*/*#*)\*

相对而言,Process 对象不需要事例 index。因此,可以使用如下格式:

\Process(*)\ID Process

可用格式列表如下:

\\machine\object(parent/instance#index)\counter
\\machine\object(parent/instance)\counter
\\machine\object(instance#index)\counter
\\machine\object(instance)\counter
\\machine\object\counter
\object(parent/instance#index)\counter
\object(parent/instance)\counter 
\object(instance#index)\counter
\object(instance)\counter
\object\counter

如果在父节点名称中指定了通配符,则将返回指定对象的所有与指定事例和计数器域匹配的事例。

如果在事例名称中指定通配符,则将返回指定对象和父节点对象中的所有事例(如果指定索引相应的所有事例名称与通配符匹配)。

如果在计数器名称中指定通配符,则将返回指定对象的所有计数器。

不支持部分计数器字符匹配。

查询格式

对于计数器路径查询,请使用此格式:T

ypeperf [{-q | -qx [\\Computer\] [object] [-o outputfile}]。

对于完整查询,请使用如下命令行:

Typeperf [\\Computer]\object[instance]\counter]
Typeperf -cf input file

使用 -config 选项

与 -config 选项一起使用的设置文件的内容应具有如下格式:

[command_option]

value 其中 command_option 是命令行选项,然后在 value 指定其值。例如:

  • -c
  • \Windows\mypath
  • [-o]
  • report.csv
  • [-s]
  • mysystem

范例

要显示处理器和内存计数器,请键入:

typeperf "\Memory\Available bytes" "\processor(_total)\% processor time"

要以 CSV 输出格式每三秒钟显示一次 Explorer 进程,请键入:

typeperf "\Process(Explorer)\Thread Count" -si 3 -o typeperf.csv

要在计算机 Server_name 上显示 50 个 RAS 计数器的范例,请键入:

typeperf "\RAS port(LPT1)\Bytes Transmitted" -sc 50 -s Server_name

要以 120 秒的范例显示间隔,显示 input.txt 文件中列出的 50 个计数器范例的计数器值,请键入:

typeperf -cf input.txt -si 120 -sc 50 -f TSV -o domain2.tsv

要查询包含实例的已安装计数器,请键入如下命令。注意:-qx 参数将返回比 -q 参数大很多的性能计数器数目。

typeperf -qx

要在计算机 Server5 上查询不包含实例的物理磁盘计数器,并将它们写到名为 diskctrs.txt 的文件中,请键入:

typeperf -q \\Server5\PhysicalDisk -o diskctrs.txt