2010]

Garrett D'Amore Wed, 07 Apr 2010 23:02:54 -0700

On 04/ 7/10 10:47 PM, Jordan Brown wrote:

Garrett D'Amore wrote:

What's missing is an interface table. I think though that based onthe statement that its not to be parsed ("for humans only"), theoutput is not-an-interface.


Yes.  The stability is the same as the existing command:

    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|
    | Utility Output Format       | Not-an-Interface            |
    |_____________________________|_____________________________|

You haven't mentioned anything about underlying kstats. Is this howthese stats are implemented? Should that be covered under an ARC caseas well (perhaps this one)?


    - Garrett

    - Garrett

On 04/ 7/10 05:51 PM, Jordan Brown wrote:
Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
This information is Copyright (c) 2010, Oracle and/or itsaffiliates. All rights reserved.
1. Introduction
     1.1. Project/Component Working Name:
     SMB/CIFS Statistics
     1.2. Name of Document Author/Supplier:
     Author:  Jose Borrego
     1.3  Date of This Document:
    07 April, 2010

     1.4. Name of Major Document Customer(s)/Consumer(s):
          PSARC
    CIFS team

     1.5. Email Aliases:
          1.5.1. Responsible Manager: barry.greenb...@sun.com
          1.5.2. Responsible Engineer: jose.borr...@sun.com
          1.5.3. Marketing Manager:
    1.5.4. Interest List: cifs-t...@sun.com

4. Technical Description:

Executive Summary:
This case improves the statistics the SMB/CIFS server maintainsas well as
     the output of smbstat.

Problem:
Currently the only statistics the SMB/CIFS server maintains arecounterskeeping track of how many requests of each type were received,the numberof open files, the number of sessions (users logged in) and thenumber ofconnections (trees connected). Those statistics are not enoughto describethe load being applied as well as how the server is respondingto it.
Solution:
In order to get a better picture of the state of the SMB/CIFSserver thefollowing information can be maintained and provided throughsmbstat:
     - Counters:
    * nbt:
        Number of SMB NetBIOS-over-TCP (NBT) sessions.

    * tcp:
        Number of SMB TCP sessions.

    * users:
        Number of users logged in.

    * trees:
        Number of trees connected.

    * files:
        Number of open files.

    * pipes:
        Number of open pipes.

     - Throughput:
    * rbytes/s:
        Number of bytes received per second.

    * tbytes/s:
        Number of bytes transmitted per second.

    * reqs/s:
        Number of requests handled per second.

    * reads/s:
Number of read requests per second. This would be anaggregation of
        the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
        SMB_COM_READ_RAW and SMB_COM_READ_ANDX.

    * writes/s:
Number of write requests per second. This would ba anaggregation ofthe following requests: SMB_COM_WRITE,SMB_COM_WRITE_AND_UNLOCK,
        SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.

     - Utilization:
         * wcnt:
Average number of requests received but waiting for an SMBworker
        thread to execute them.

         * rcnt:
Average number of requests being simultaneously executed byan SMB
        worker thread.

    * wtime:
        Average time a request waits before an SMB worker thread starts
        executing it.

         * rtime:
        Average execution time of a request.

         * w%:
        Percentage of the time during which at least one request was
        waiting.

         * r%:
Percentage of the time during which at least one request wasbeing
        executed.

         * u%:
Percentage of utilization of the SMB/CIFS server. Thisnumber is
        defined as: rcnt / (Max Worker Threads).

         * sat:
Flag indicating if the server saturated in the past.Saturation is
        defined as: u% == 100%.

    * usr%:
        Percentage of the time the processor(s) spent in user space.

    * sys%:
        Percentage of the time the processor(s) spent in kernel space.

    * idle%:
        Percentage of the time the processor(s) was(were) idle.

     - Requests:
         For each type of request:
         * %:
        Percentage of that type of request.

         * rbytes/s:
        Number of bytes received per second.

         * tbytes/s:
        Number of bytes received per second.

         * req/s:
        Number of requests handled per second.

         * rt-mean:
        Average response time in seconds.

         *  rt-stddev:
        Standard deviation of the response time.
To access this information the CLI smbstat must be modified andallow the
     following options:

     -r  Display the statistics of the requests.
-a Display the statistics of all the types of request (the256 of
             them) whether they are valid or not.

         -n  Display in alphabetic order.

         -z  Display the statistics of the requests actually received.

     -t  Display the throughput of the SMB/CIFS server.

     -u  Display the utilization of the SMB/CIFS server.

     -c  Display the counters.
A number can also be provided indicating the interval of timebetweenrefreshes. The first statistics displayed cover the timebetween whenthe server was started and the moment the statistics wererequested.
     Subsequent refreshes cover the last time interval only.
It should be noted that the output is all new replacing the oldone and
     is for humans only.

Examples of smbstat output:

     'smbstat -ctu'

       nbt   tcp users trees files pipes
         0     1     1     2    20     0

     rbytes/s   tbytes/s    reqs/s     reads/s   writes/s
     1.036e+02  1.298e+00  0.000e+00  0.000e+00  0.000e+00
wcnt rcnt wtime rtime w% r% u% satusr% sys% idle%4.317e-01 7.410e+00 2.461e-05 4.224e-04 31 100 0no 0 76 24
     'smbstat -r'
code % rbytes/s tbytes/sreq/s rt-mean rt-stddevSmbCreateDirectory 00 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbDeleteDirectory 01 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbOpen 02 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbCreate 03 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbClose 04 0 0.000e+00 0.000e+000.000e+00 2.496e-04 8.003e-06SmbFlush 05 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbDelete 06 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbRename 07 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbQueryInformation 08 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbSetInformation 09 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbRead 0A 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbWrite 0B 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbLockByteRange 0C 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbUnlockByteRange 0D 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbCreateTemporary 0E 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbCreateNew 0F 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbCheckDirectory 10 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbProcessExit 11 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbSeek 12 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbLockAndRead 13 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbWriteAndUnlock 14 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbReadRaw 1A 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbWriteRaw 1D 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbSetInformation2 22 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbQueryInformation2 23 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbLockingX 24 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbTransaction 25 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbTransactionSecondary 26 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbIoctl 27 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbEcho 2B 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbWriteAndClose 2C 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbOpenX 2D 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbReadX 2E 0 0.000e+00 0.000e+000.000e+00 3.550e-04 1.856e-05SmbWriteX 2F 100 4.607e+02 1.675e+000.000e+00 3.893e-04 2.691e-07SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbTransaction2 32 0 0.000e+00 0.000e+000.000e+00 5.203e-04 8.612e-06SmbTransaction2Secondary 33 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbFindClose2 34 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbTreeConnect 70 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbTreeDisconnect 71 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbNegotiate 72 0 0.000e+00 0.000e+000.000e+00 4.625e-05 0.000e+00SmbSessionSetupX 73 0 0.000e+00 0.000e+000.000e+00 1.145e-01 0.000e+00SmbLogoffX 74 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbTreeConnectX 75 0 0.000e+00 0.000e+000.000e+00 5.851e-04 2.436e-05SmbQueryInformationDisk 80 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbSearch 81 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbFind 82 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbFindUnique 83 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbFindClose 84 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbNtTransact A0 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbNtTransactSecondary A1 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbNtCreateX A2 0 0.000e+00 0.000e+000.000e+00 5.154e-02 2.063e-03SmbNtCancel A4 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbNtRename A5 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbOpenPrintFile C0 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbWritePrintFile C1 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbClosePrintFile C2 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00SmbGetPrintQueue C3 0 0.000e+00 0.000e+000.000e+00 0.000e+00 0.000e+00
     'smbstat -rz'
code % rbytes/s tbytes/sreq/s rt-mean rt-stddevSmbClose 04 0 0.000e+00 0.000e+000.000e+00 2.445e-04 5.906e-06SmbReadX 2E 4 0.000e+00 2.772e+010.000e+00 1.556e-03 7.878e-06SmbWriteX 2F 96 7.162e+02 2.604e+000.000e+00 5.365e-04 3.913e-07SmbTransaction2 32 0 0.000e+00 0.000e+000.000e+00 5.203e-04 8.612e-06SmbNegotiate 72 0 0.000e+00 0.000e+000.000e+00 4.625e-05 0.000e+00SmbSessionSetupX 73 0 0.000e+00 0.000e+000.000e+00 1.145e-01 0.000e+00SmbTreeConnectX 75 0 0.000e+00 0.000e+000.000e+00 5.851e-04 2.436e-05SmbNtCreateX A2 0 0.000e+00 0.000e+000.000e+00 7.250e-02 2.304e-03
6. Resources and Schedule
     6.4. Steering Committee requested information
        6.4.1. Consolidation C-team Name:
        ON
     6.5. ARC review type: FastTrack
     6.6. ARC Exposure: open


_______________________________________________
opensolaris-arc mailing list
opensolaris-arc@opensolaris.org

Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]

Reply via email to