topasrec 命令

在线编辑

用途

topasrec 命令将采用二进制格式来记录本地系统度量值、CEC（中央电子复合体）度量值和集群度量值。

注: xmwlm 和 xmtrend 实用程序已过时，将被 topasrec 命令替换。

语法

本地二进制记录：

托帕斯雷克 -L [ -c sample_count ] [ -o < output_filename >] [ -s 秒 ] [ -t 跟踪级别 ]

本地 Azizo 记录：

topasrec -L -O type=azizo

CEC 记录：

托帕斯雷克 -C [ -c sample_count ] [ -o < output_filename > ] [ -s 秒 ] [ -O xmtopas=<hostname> ]

集群记录:

托帕斯雷克 -G [ -c sample_count ] [ -o < output_filename > ] [ -s 秒 ] [ -O xmtopas=<hostname> ]

列表运行记录：

topasrec -l

描述

注意：
  1. 不能在 工作负载分区 (WPAR) 内运行 topasrec 命令。
  2. CEC 或集群记录将在分区迁移或休眠完成后重新衍生。 活动记录文件在分区迁移后重命名为 <current_file_name>.mig.<HH>.<MM>.<SS> ，在分区休眠后重命名为 <current_file_name>.hib.<HH>.<MM>.<SS> 。

topasrec 命令采用二进制格式来记录本地系统数据、跨分区数据（CEC 统计信息）和集群数据。

为 CEC 记录运行topasrec命令时，topasrec命令会从同一 CEC 上运行的AIX®分区收集一组指标。 topasrec 命令收集专用和共享分区数据以及聚集值集，以提供同一 CEC 上的分区集的概述。

topasrec 命令在 /usr/lpp/perfagent/daily.cf 文件中查找将要记录的度量值，您不应更改 daily.cf 文件。 更改 daily.cf 文件会影响以下记录文件：
  1. 持久/非持久本地记录
  2. WLE 记录
  3. 性能管理服务数据收集
  4. 为分析性能问题而收集的性能 PMR (perfpmr) 数据
更改 daily.cf 文件不会影响 nmon、CEC 和集群记录。 如果要减少进行记录的度量值，您可以备份现有 daily.cf 文件，并更改此文件以除去不想记录的度量值。 除去这些度量值会影响前面列出的所有记录文件。 例如，如果不想使用 topasrec 命令记录 Disk/*/busy 度量值，那么可以从 /usr/lpp/perfagent/daily.cf 文件中除去该行。
注: 对于系统的任何动态配置更改，必须重新启动工具以反映新更改。

标志

项 描述
-C 以二进制格式记录 CEC 统计信息。 -C 标志指定将记录跨分区统计信息。
-c sample_count 记录指定的记录数，然后停止。

如果未指定 -c 标志，或者如果 sample_count 参数的值为零，那么记录是持续的并且 topasrec 命令会写入记录文件，直到停止运行该命令。
-L 以二进制格式记录本地统计信息。
-l 列出正在运行的记录。
-s 秒 指定记录时间间隔（以秒为单位）。 seconds 参数的值应该是 60 的倍数。 对于 CEC 和本地统计信息的持续记录（topasrec -c 0），记录时间间隔的缺省值为 900 秒。 对于值大于零的样本计数，记录时间间隔的缺省值为 300 秒。
-O xmtopas=<hostname> 指定用于聚集数据并将它提供给 topasrec 的主机的名称。 如果未指定此标志，那么 topasrec 将从其中一个已知聚集器中获取数据。
注: 不能将覆盖选项与持久记录配合使用。
-o < output_filename > 指定输出文件的名称。 output_filename 参数的值可以是带有可选文件前缀的目录。 可以将下列其中一种类型的文件名指定给 output_filename 参数：
  • 目录。 目录始终应以 / 结尾。 例如，/etc/perf/ 目录。
  • 带有文件名的目录。 例如，/home/tester/perf_load 文件。
  • 文件名。 例如，perf_load 文件。

缺省输出文件是当前目录（./）。

在 CEC 记录、集群记录和本地记录中，文件名的缺省前缀为主机名。

如果您提供的文件名包含一个目录前缀且在 -o output_filename 标志中包含一个文件名前缀，那么所记录文件的名称采用以下格式：
  • 对于 CEC 度量值，输出采用以下格式：

    <filename>_cec_YYMMDD_HHMM.topas

  • 对于集群度量值，输出采用以下格式：

    <filename>_cluster_YYMMDD_HHMM.topas

  • 对于本地度量值，输出采用以下格式：

    <filename>_YYMMDD_HHMM.topas

如果您提供的文件名仅包含目录前缀，那么所记录文件的名称采用以下格式：
  • 对于 CEC 度量值，输出采用以下格式：

    <filename/hostname>_cec_YYMMDD_HHMM.topas

  • 对于集群度量值，输出采用以下格式：

    <filename/hostname>_cluster_YYMMDD_HHMM.topas

  • 对于本地度量值，输出采用以下格式：

    <filename/hostname>_YYMMDD_HHMM.topas

在这些格式中，年（YY）、月（MM）、日（DD）、时（HH）和分（MM）对应于记录文件的创建时间。

注: For CEC/Cluster Recording , if 克斯姆托帕斯 override option is used then filename will be the value specified for xmtopas=<value>.

示例：

< value>_cec_YYMMDD_HHMM.topas
< value>_cluster_YYMMDD_HHMM.topas
-r 保留时间 指定该文件必须保留的天数。 最小值为 1。 例如， -r 5 指定文件保留 5 天。
-R max_days_per_file 指定性能数据写入文件所需的天数。 最小值为 1，最大值为 366。 例如，如果在第一天使用选项 -R 2 启动持久记录，那么第一天和第二天的性能数据会写入相同的文件。 在第三天，将会创建一个包含第三天和第四天性能数据的新文件。
-t 跟踪级别 指定跟踪级别。 跟踪级别可以设置为 1 到 9。

参数

项 描述
样本计数 指定要生成的记录数。
输出文件名 指定输出文件的名称。
秒 指定记录时间间隔（以秒为单位）。

示例

  1. 要开始本地二进制记录，此过程持续运行 5 分钟并且包含每 1 分钟的系统度量值，请输入以下命令：
    topasrec -L -c 5 -s 60
    如果该文件是在 23:14, Mar 10, 2008上创建的，并且主机名为 ses15，那么输出文件名为 ./ses15_080310_2314.topas。
  2. 要使用 /home/test/sample 文件名开始持续的本地二进制记录，请输入以下命令：
    topasrec -L -o /home/test/sample
    如果该文件是在 12:05, Mar 10, 2008上创建的，并且主机名为 ses15，那么输出文件名为 /home/test/sample_080310_1205.topas。
  3. 要开始 CEC 记录，此过程持续运行 20 分钟，以 120- 秒为时间间隔记录度量值，并且生成输出文件 sample，请输入以下命令：
    topasrec -C -o sample -s 120 -c 10
    如果该文件是在 08:07, Feb 1, 2008上创建的，并且主机名为 ses15，那么输出文件名为 ./sample_cec_080201_0807.topas。
  4. 要使用 /home/test/sample_bin 文件名开始持续的本地二进制记录，请输入以下命令：
    topasrec -C -o /home/test/sample_bin
    如果该文件是在 04:20, Feb 1, 2008上创建的，并且主机名为 ses15，那么输出文件名为 /home/test/sample_bin_080201_0420.topas。
  5. 要列出运行记录的详细信息，请输入以下命令：
    topasrec –l
  6. 要启用跟踪，请输入以下命令：
    topasrec –L –t 1
  7. 要开始进行集群记录，其运行时间为 20 分钟，采用 120 秒作为时间间隔来记录度量值，并且生成名为 sample 的输出文件，请输入以下命令：
    topasrec -G -o sample -s 120 -c 10
    如果该文件是在 08:07, Feb 1, 2008 上创建的，并且主机名为 ses15 ，那么输出文件名为 /sample_cluster_080201_0807.topas.。
  8. 要开始连续进行本地集群记录，并且文件名为 /home/test/sample_bin，请输入以下命令；
    topasrec -G -o /home/test/sample_bin
  9. 要手动启动本地 azizo 记录，请输入以下命令：
    topasrec -L -O type=azizo
    如果存在有效 /etc/perf/xmtopas.cf 文件，xmtopas 命令将自动启动 azizo 记录。 After the recording is started, it generates the azizo.<yymmdd> file in the /etc/perf/ directory and runs only if the 克斯姆托帕斯 command is running

文件

项 描述
/usr/bin/topasrec 包含 topasrec 命令。