Top
PRIMECLUSTER Global File Services Configuration and Administration Guide 4.6
FUJITSU Software

B.2.11 sfcstat(8) Report statistics on GFS Shared File Systems

<SYNOPSIS>

sfcstat [ -abcdefghijklmnopqrstA ] [ interval [ count ]] [ mount_point... ]

<DESCRIPTION>

The sfcstat command displays statistics about GFS Shared File Systems.

If sfcstat is used without parameters, it reports statistical information recorded after the file system is mounted. The next time, it reports the information recorded since the last report.

If interval is specified, the command reports statistical information each number of seconds defined by interval.

If count is specified, the command reports statistical information repeatedly for the value defined by count.

If mount_point is specified, the command reports the information for the specified file system.

<OPTIONS>

The following options can be specified:

-A

Reports all information.

-a

Reports AC information about read/write operations. Reports the number of RPC messages for the following purposes:

  • To change file atime or mtime

  • To change file attributes

  • To access file attributes

  • To access file size

  • To acquire tokens when changing file size

  • To change file size

  • To purge tokens when changing file size

  • To access information about extent allocations

  • To change information about extent allocations

-b

Reports AC information about meta-data management buffers. Reports the number of buffer allocations, the number of dynamic buffer allocations, and the number of sleep occurred during buffer requests.

-c

Reports MDS information about meta-data management buffers. Reports the number of buffer allocations, the number of dynamic buffer allocations, and the number of sleep occurred during buffer requests.

-d

Reports AC information about direct I/O. Reports the following information:

  • Number of direct I/O read operations

  • Number of direct I/O write operations

  • Number of blocks read

  • Number of blocks written

  • Number of read requests changed to normal I/O

  • Number of write requests changed to normal I/O

  • Number of page flush after reading

  • Number of page flush after writing

-e

Reports MDS information about purging tokens. Reports the following information:

  • Number of purging tokens

  • Number of AC that purged tokens

  • Number of purging tokens (by token type)

  • Number of AC that purged tokens (by token type)

-f

Reports AC information about VFS operations. Reports the number of RPC messages for the following purposes:

  • To access file handle

  • To access file attributes

  • To purge tokens

-g

Reports the number of times MDS was received requests for tokens (by token type).

-h

Reports MDS information about the meta-daemon. Reports the number of times the meta-daemon was activated, the number of buffers in the meta-daemon I/O queues, the number of times the meta-daemon was activated because the disk was full, and the number of times the meta-daemon was activated because the meta-cache was full.

-i

Reports AC information about actual I/O. Reports the number of actual I/O reading, the number of actual I/O writing, the number of I/O blocks actually read, and the number of I/O blocks actually written.

-j

Reports MDS information about the log daemon. Reports the following information:

  • Number of times log daemon was activated

  • Number of sync requests

  • Number of fsync requests

  • Number of times log buffer full

  • Number of requests issued from meta-write daemon

  • Number of times sleep occurs because transaction limit exceeded

  • Number of times sleep occurs because log disk full

  • Number of times sleep occurs because of a preceding large transaction

  • Number of times sleep occurs because a preceding transaction enlarged

  • Number of requests for I/O operation issued from log daemon

  • Time(msec) required for writing

  • Number of blocks written

  • Number of valid blocks

  • Number of requests to log transactions

  • Number of parallel operation transactions to be logged

  • Average number of parallel operation transactions

  • Number of times huge buffer was used

  • Number of sub-transactions generated

-k

Reports MDS information about operations for free extents. Reports the number of search requests, the number of times blocks acquired, the number of acquired blocks, the number of blocks acquisition failed, the number of times blocks released, the number of released blocks, the number of times released blocks successfully linked, the number of division of free extent management, and the number of joining free extent management.

-l

Reports AC information about file and record locks. Reports the number of RPC messages for the following purposes:

  • To open file

  • To close file

  • To map file to address space

  • To read file

  • To write file

  • To set lock, clear lock, or get lock information

  • To set mandatory lock, or clear mandatory lock

-m

Reports MDS information about meta cache (by meta type). Reports the number of accesses, the number of cache hits, the number of updates, the number of read operations, the number of write operations, writing time, and average time(msec).

-n

Reports AC information about RNODE operations. Reports the number of RPC messages for the following purposes:

  • To be requested to purge tokens

  • To be requested to purge tokens of freed RNODE

  • To purge tokens to free RNODE

-o

Reports AC information about VNODE operations. Reports the following information:

  • Number of RPC messages to open file

  • Number of RPC messages to close file

  • Number of access to file attributes

  • Number of RPC messages to access file attributes

  • Number of re-sent RPC messages to access file attributes

  • Number of RPC messages to access the number of blocks of regular file

  • Number of access to symbolic link

  • Number of RPC messages to access symbolic link

  • Number of RPC messages to move modified attributes to storage devices

  • Number of access to directory

  • Number of RPC messages to access directory

  • Number of re-sent RPC messages to access directory

-p

Reports MDS information about file operation. Reports the following information:

  • Number of requests to operate files (by operation type)

  • Size of RPC messages to operate files (by operation type)

  • Number of successful replies (by operation type)

  • Size of successful replies (by operation type)

  • Number of failed replies (by operation type)

  • Time(msec) required for operating files (by operation type)

-q

Reports MDS information about operations for allocated extents. Reports the number of search requests, the number of times blocks acquired, the number of acquired blocks, the number of blocks acquisition failed, the number of times blocks released, the number of released blocks, the number of times released blocks successfully linked, the number of division of free extent management, and the number of joining free extent management.

-r

Reports AC information about file operation. Reports the following information:

  • Number of sending requests to operate files

  • Number of receiving replies

  • Number of timeouts while receiving replies

  • Number of requests waiting to be sent (by operation type)

  • Time for requests to wait to be sent (by operation type)

  • Number of sending requests (by operation type)

  • Time(msec) to wait to receive replies (by operation type)

  • Number of successful replies (by operation type)

  • Number of replies failed because no file existed (by operation type)

  • Number of replies failed because file attributes changed (by operation type)

  • Number of replies failed because file existed (by operation type)

  • Number of replies failed because of other error (by operation type)

  • Number of failure to receive replies (by operation type)

-s

Reports MDS information about operations for reserving extents. Reports the number of requests to reserve extents, the number of reserved extents, the number of reserved blocks, the number of requests to reserve extents contiguously, and the number of extents failed to reserve.

-t

Reports the number of times MDS is request to purging tokens. Reports the following information:

  • Number of changing information about extent allocations

  • Number of extents whose allocation information were changed

  • Number of blocks whose allocation information were changed

  • Number of changing information about extent allocations partially

  • Number of extents whose allocation information were changed partially

  • Number of blocks whose allocation information were changed partially

  • Number of purging tokens (by token type)

If the options are omitted, the command reports all information.

<OPERAND>

The following operand can be specified:

mount_point

Specifies the path name of the mount point where the file system has been mounted.

<EXAMPLE>

# sfcstat 5 /mnt <Enter>

<SEE ALSO>

sar(1) in the online manual

<NOTE>

The AC does not get meta-data management buffers dynamically at present. So, AC information about meta-data management buffers such as the numbers of buffer allocations, dynamic buffer allocations, and sleep that occurred during buffer requests will be 0 at all times.