fcstat 命令
用途
显示指定物理或虚拟光纤通道（FC）设备驱动程序收集的统计信息。
语法
fcstat [ -z [ -d | -c ]| -d | -e [ -d | -c ]| -c ] 设备名称
fcstat -t 时间间隔 [ -p 协议 ] Device_Name
描述
fcstat 命令显示指定物理或虚拟 FC 设备驱动程序收集的统计数据。 您还可以指定除了显示设备通用统计信息之外，还显示特定于设备的统计信息。 如果未指定任何标志，那么 fcstat 命令仅显示设备通用统计信息。 fcstat 命令使用以下过程来收集统计信息:
- 打开 fcstat 命令的信息目录并检查参数列表。
- 访问对象数据管理器 ( ODM ) 数据库，获取与所选适配器相关的信息。
- 访问 ODM 数据库，获取与所选适配器端口相关的信息。
- 打开并访问适配器的统计数据。
- 如果指定 -z 标志，请重新设置某些统计信息。
- 报告统计数据并退出。
如果指定了无效的 Device_Name ，那么 fcstat 命令将返回一条错误消息，指示它在 ODM 数据库中找不到设备。
如果指定的 Device_Name 未连接到网络（即链路断开）， fcstat 命令会通过在诊断模式下打开设备来报告统计数据。 fcstat 命令使用 -d 标志以诊断模式打开设备。 当链路断开且设备以非诊断模式打开时， fcstat 命令会延迟生成输出。 您可以使用 -c 标志来移除此延迟。 如果设备已经打开，而 fcstat 命令是以 -d 标志启动的，则对设备的打开操作会失败，并出现 EACCESS 错误。
如果 fcstat 命令无法从指定的 Device_Name 提取统计信息，则 fcstat 命令会报告从 ODM 数据库提取的信息。
您可以使用 fcstat 命令，通过 -t 标志连续生成流量统计的时间序列报告。 -t 标志的 Interval 参数指定每个报告之间的时间间隔 (以秒为单位)。 如果指定零作为 Interval 参数的值，那么 fcstat 命令将创建单个报告。 在每个报告中，将在一行中打印单个传输协议 (TP) 的流量统计信息。 如果适配器支持多个 TP，则每个协议的统计数据都打印在单独一行中。 要生成特定 TP 的时间序列报告，可以使用 -p 标志的协议参数来指定 TP。
您可以使用 fcstat 命令为以下统计数据生成时间序列报告：
Read Reqs(K)- 表示以千为单位的读取或输入请求数。
Write Reqs(K)- 表示以千为单位的写入或输出请求数。
Read(GB)- 表示以千兆字节为单位读取的输入字节数。
Write(GB)- 表示以千兆字节为单位写入的输出字节数。
如果指定 -l 标志， fcstat 命令将显示物理或虚拟 FC 适配器在指定时间内（以秒为单位）的 I/O 命令延迟。 带有 -l 标志的可选间隔参数指定了每次报告之间的时间间隔（以秒为单位）。 如果没有提供时间间隔，每次报告之间的默认间隔为 3 秒。
I/O 命令的延迟统计具有以下属性：
- 显示外部 SAN 时间、适配器时间、VIOS 时间和管理程序时间。
- 显示一条 I/O 命令所用的最长时间。
- 显示 "良好完成（读、写）"I/O、"错误 "I/O 和 "超时 "I/O 的延迟统计数据。
- 显示为 FC 端口配置的协议的延迟统计信息。注意：
- VIOS 时间和 Hypervisor 时间仅适用于虚拟环境。
- 不显示 NVME 协议的超时命令统计数据。
- 如果源或目标的消费电子控制 (CEC) 固件级别低于 1020，则 LPM 期间的延迟统计不适合虚拟客户机。
标志
| 项 | 描述 |
|---|---|
| -c | 当设备在非诊断模式下打开且链路断开时，消除生成输出的延迟。 |
| -d | 通过在诊断模式下打开适配器来显示统计数据。 |
| -e | 显示包括特定于设备的统计信息，如驱动程序统计信息、链路统计信息、 FC4 类型和重要的小型可插拔（SFP）参数。 |
 -l  |
显示 I/O 命令的延迟时间。 |
| -p | 显示使用协议参数指定的特定 TP 的流量统计时间序列报告。 |
| -t | 连续显示流量统计的时间序列报告，两个连续报告之间的时间间隔用 Interval 参数指定。 |
| -z | 将某些统计信息重置为它们的初始值。 只有有权限的用户才能发出此标记。 |
参数
| 项 | 描述 |
|---|---|
| device_name | 表示 FC 设备的名称。 例如，fcs0。 |
| 持续时间 |
表示收集和显示 I/O 命令延迟的持续时间（秒）。 必须使用 -l 标志指定持续时间。 |
| 时间间隔 | 表示 -t 或 -l 标志生成的两份报告之间的时间间隔（以秒为单位）。 时间间隔的有效值为正整数。 -l 标志的间隔时间为可选项。 |
| 协议 | 表示 -p 标志的特定 TP。 协议》 的有效值为 scsi 和 nvme。 |
统计信息字段
注: 某些适配器可能不支持特定统计信息。 不支持的统计字段的值始终为 0。 使用带有 –z 标志的 fcstat 命令时，所有标有星号 (*) 符号的参数都将重置为初始值。
下表列出了 fcstat 命令输出中显示的统计字段及其说明：
| 项 | 描述 | |
|---|---|---|
Device Type |
显示适配器的描述。 | |
Serial Number |
显示适配器中的序列号。 | |
Option ROM Version |
显示适配器上的选件 ROM 的版本。 | |
ZA |
显示适配器 VPD 中的 ZA 字段。 |
|
Node WWN |
显示适配器的全球名称。 | |
Port FC ID |
显示适配器的 SCSI 标识。 | |
Port Type |
显示适配器的连接类型。 | |
Port Speed |
显示适配器的速度。 | |
Port WWN |
显示端口的全球名称。 | |
Seconds Since Last Reset |
显示上次重置适配器统计数据后的秒数。 | |
| * | Frames |
显示传输和接收的帧数。 |
| * | Words |
显示传输和接收的字数。 |
| * | LIP Count |
显示 LIP 计数。 |
| * | NOS Count |
显示 NOS 计数。 |
Error Frames |
显示出错帧的数量。 | |
| * | Dumped Frames |
显示转储的帧数。 |
Link Failure Count |
显示链路失败计数。 | |
Loss of Sync Count |
显示同步丢失的次数。 | |
Loss of Signal |
显示信号丢失的次数。 | |
Primitive Seq Protocol Err Count |
显示原语序列示错的次数。 | |
Invalid Tx Word Count |
显示发生的无效传输次数。 | |
Invalid CRC Count |
显示发生的 CRC 错误数。 | |
FC SCSI Adapter Driver Information: No DMA Resource Count |
显示 DMA 资源不可用的次数。 | |
FC SCSI Adapter Driver Information: No Adapter Elements Count |
显示无可用适配器元素的次数。 | |
FC SCSI Adapter Driver Information: No Command Resource Count |
显示没有可用的命令资源的次数。 | |
| * | FC SCSI Traffic Statistics: Input Requests |
显示输入请求的数量。 |
| * | FC SCSI Traffic Statistics: Output Requests |
显示输出请求的数量。 |
| * | FC SCSI Traffic Statistics: Control Requests |
显示控制请求的数量。 |
| * | FC SCSI Traffic Statistics: Input Bytes |
显示输入字节数。 |
| * | FC SCSI Traffic Statistics: Output Bytes |
显示输出字节数。 |
Adapter Effective Max Transfer Value |
显示最大有效传输值。 | |
FC4 Types: Supported ULP |
显示受支持的 ULP。 | |
FC4 Types: Active ULP |
显示活动的 ULP。 | |
Network Information: Fabric Node Name |
显示当连接类型为光纤网时适配器所连接的网络交换机的节点名。 | |
Network Information: P2P Port Name |
显示连接类型为点到点时适配器所连接的目标端口的端口名。 | |
SFP Information |
显示重要的 SFP 参数，例如供应商信息，温度和电压信息。 |
退出状态
| 项 | 描述 |
|---|---|
| 重大安全事件数量 | 表示命令成功完成。 |
| >0 | 表示发生错误。 |
示例
- 要显示 FC 设备驱动程序
fcs0的统计信息，请输入以下命令：
将显示与以下屏幕类似的输出：fcstat fcs0注意： 各种 AIX 命令的输出格式并不总是固定不变的。 在编写程序时，不要指望 fcstat 命令的输出结果会保持如下。FIBRE CHANNEL STATISTICS REPORT: fcs0 Device Type: FC Adapter (df1000f9) Serial Number: 1E313BB001 Option ROM Version: 02C82115 ZA: B1F2.10A5 Node WWN: 20000000C9487B04 Port WWN: 10000000C9416DA4 FC4 Types Supported: 0x0000010000000000000000000000000000000000000000000000000000000000 Active: 0x0000010000000000000000000000000000000000000000000000000000000000 Class of Service: 4 Port FC ID: 011400 Port Speed (supported): 2 GBIT Port Speed (running): 1 GBIT Port Type: Fabric Seconds Since Last Reset: 345422 Transmit Statistics Receive Statistics ------------------- ------------------ Frames: 1 Frames: 1 Words: 1 Words: 1 LIP Count: 1 NOS Count: 1 Error Frames: 1 Dumped Frames: 1 Link Failure Count: 1 Loss of Sync Count: 1 Loss of Signal: 1 Primitive Seq Protocol Err Count: 1 Invalid Tx Word Count: 1 Invalid CRC Count: 1 FC SCSI Adapter Driver Information No DMA Resource Count: 0 No Adapter Elements Count: 0 No Command Resource Count: 0 FC SCSI Traffic Statistics Input Requests: 16289 Output Requests: 48930 Control Requests: 11791 Input Bytes: 128349517 Output Bytes: 209883136 - 要显示光纤通道设备
fcs0的流量统计时间序列报告（间隔为 2 秒），请输入以下命令：fcstat -t 2 fcs0将显示与以下屏幕类似的输出：
FIBRE CHANNEL STATISTICS REPORT: fcs0 Device Type: PCIe3 2-Port 32Gb FC Adapter (df1000e314101506) (adapter/pciex/df1000e31410150) TP Read Reqs(K) Write Reqs(K) Read (GB) Write (GB) ===== ================= ================= =========== =========== SCSI 9614 34 695 9 NVMe 2539 147 163 16 SCSI 9679 60 701 10 NVMe 2602 175 167 18 SCSI 9800 114 709 14 NVMe 2644 194 170 19 SCSI 9935 174 718 18 NVMe 2679 209 173 20 SCSI 10070 234 726 22 NVMe 2715 225 175 21 SCSI 10205 294 735 26 NVMe 2751 241 177 22 - 要显示持续时间为 80 秒、间隔为 5 秒的虚拟 FC 端口
fcs0的 I/O 命令延迟统计信息，请输入以下命令：# fcstat -l 80 5 fcs0将显示与以下屏幕类似的输出：# fcstat -l 80 5 fcs0 Proto_stats Num_Cmds IO_time Max_IO_time SAN_time FC_adapter_time avg(usec) (usec) avg(usec) avg(usec) ============= ======== =========== =========== ============ =============== SCSI(Read) 5279 5909 10182 5580 329 SCSI(Write) 5243 7883 19024 7265 618 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 618 5885 19119 4674 1211 NVME(Write) 589 6307 19116 5280 1027 NVME(Error) 0 0 0 0 0 ITERATION #2 ------------- SCSI(Read) 9790 5772 10182 5473 298 SCSI(Write) 9673 7882 19024 7259 622 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 1167 6243 19119 5047 1196 NVME(Write) 1125 6333 19230 5333 999 NVME(Error) 0 0 0 0 0 ITERATION #3 ------------- SCSI(Read) 14214 5760 18850 5480 280 SCSI(Write) 14117 7886 19098 7297 590 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 1673 6151 19119 5007 1144 NVME(Write) 1630 6422 19230 5469 953 NVME(Error) 0 0 0 0 0 ITERATION #4 ------------- SCSI(Read) 18625 5773 18850 5506 269 SCSI(Write) 18534 7867 19098 7294 575 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 2178 6076 19119 4918 1158 NVME(Write) 2143 6464 19230 5529 930 NVME(Error) 0 0 0 0 0 - 要显示物理 FC 端口
fcs0的持续时间为 60 秒且不带间隔的 I/O 命令延迟统计信息，请输入以下命令：
默认时间间隔为 3 秒。# fcstat -l 60 fcs0将显示与以下屏幕类似的输出：# fcstat -l 60 fcs0 Proto_stats Num_Cmds IO_time Max_IO_time SAN_time FC_adapter_time avg(usec) (usec) avg(usec) avg(usec) ============= ======== =========== =========== ============ =============== SCSI(Read) 4812 4361 19267 3922 444 SCSI(Write) 226 5103 19069 4381 721 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 9178 2244 19054 1671 572 NVME(Write) 125 4712 9906 3888 823 NVME(Error) 0 0 0 0 0 ITERATION #2 ------------- SCSI(Read) 8303 4378 19267 3935 446 SCSI(Write) 409 5143 19069 4505 637 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 15832 2211 19082 1652 558 NVME(Write) 219 4830 9919 4141 688 NVME(Error) 0 0 0 0 0 ITERATION #3 ------------- SCSI(Read) 11753 4380 19267 3931 451 SCSI(Write) 562 5089 19069 4486 603 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 22445 2199 19082 1642 556 NVME(Write) 314 4885 9919 4222 662 NVME(Error) 0 0 0 0 0 ITERATION #4 ------------- SCSI(Read) 15231 4405 19487 3958 448 SCSI(Write) 705 5191 19069 4561 630 SCSI(Error) 0 0 0 0 0 SCSI(Timeout) 0 0 0 0 0 NVME(Read) 29297 2185 19082 1643 542 NVME(Write) 411 4746 10052 4078 668 NVME(Error) 0 0 0 0 0
位置
/usr/sbin/fcstat