|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Invoke-NcSysstat
NAME
Invoke-NcSysstat
SYNOPSIS
Get clustered ONTAP controller performance statistics.
SYNTAX
Invoke-NcSysstat [-Node <String[]>] [-Interval <Int32>] [-Count <Int32>] [-C
ontroller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] [-Node <String[]>] [-Vserver <String[]
>] [-Fcp] [-Interval <Int32>] [-Count <Int32>] [-Controller <NcController[]>
] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] [-Node <String[]>] -Ifnet [-Interval <
Int32>] [-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] [-Node <String[]>] -Disk [-Interval <I
nt32>] [-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] -Lun [-Interval <Int32>] [-Count <Int3
2>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] -Nfsv4 [-Interval <Int32>] [-Count <In
t32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] [-Node <String[]>] [-Vserver <String[]
>] [-Iscsi] [-Interval <Int32>] [-Count <Int32>] [-Controller <NcController[
]>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] [-Node <String[]>] [-Vserver <String[]
>] [-Volume] [-Interval <Int32>] [-Count <Int32>] [-Controller <NcController
[]>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] [-Node <String[]>] [-Vserver <String[]
>] [-Cifs] [-Interval <Int32>] [-Count <Int32>] [-Controller <NcController[]
>] [<CommonParameters>]
Invoke-NcSysstat [[-Name] <String[]>] -Nfsv3 [-Interval <Int32>] [-Count <In
t32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Node <String[]>] [-Fcp] -Aggregated [-Interval <Int32>] [
-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Node <String[]>] [-Volume] -Aggregated [-Interval <Int32>
] [-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Node <String[]>] [-Cifs] -Aggregated [-Interval <Int32>]
[-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Node <String[]>] [-Iscsi] -Aggregated [-Interval <Int32>]
[-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Vserver <String[]>] [-Fcp] -Aggregated [-Interval <Int32>
] [-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Vserver <String[]>] [-Iscsi] -Aggregated [-Interval <Int3
2>] [-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Vserver <String[]>] [-Volume] -Aggregated [-Interval <Int
32>] [-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
Invoke-NcSysstat [-Vserver <String[]>] [-Cifs] -Aggregated [-Interval <Int32
>] [-Count <Int32>] [-Controller <NcController[]>] [<CommonParameters>]
DESCRIPTION
Get clustered ONTAP controller performance statistics.
The cmdlet can be used to retrieve the following performance statistics: Sy
stem, FCP, NFSv3, NFSv4, CIFS, iSCSI, Volume, Ifnet, LUN, and Disk.
The cmdlet works in the cluster context. Data ONTAP 8.2 or higher is requir
ed to run the cmdlet in the vserver context.
PARAMETERS
-Node <String[]>
Restrict the returned instances to the given node or nodes.
If used with the Aggregate switch, get aggregated performance statistics
for the given node or nodes.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Interval <Int32>
Sampling frequency. The default is 5 seconds.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Count <Int32>
Number of samples to take. If not specified, samples will be taken inde
finitely.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Name <String[]>
The name of one or more perf object instances for which to collect data.
Wildcards are accepted. The meaning of the name depends on the type o
f performance statistics being collected.
FCP:
- Name of the fcp interface in the format <vserver_name>.<lif_name
> for which to get FCP performance statistics.
NFSv3:
- Name of the NFS server Vserver for which to get NFSv3 performanc
e statistics.
NFSv4:
- Name of the NFS server Vserver for which to get NFSv4 performanc
e statistics.
CIFS:
- Name of the CIFS server Vserver for which to get CIFS performanc
e statistics.
iSCSI:
- Name of the iSCSI interface in the format <vserver_name>.<lif_na
me> for which to get iSCSI performance statistics.
Volume:
- Name of the volume for which to get performance statistics.
Ifnet:
- Name of the network interface port for which to get ifnet perfor
mance statistics.
LUN:
- LUN path of the LUN for which to get performance statistics.
Disk:
- Name of the disk for which to get disk performance statistics.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Vserver <String[]>
Restrict the returned instances to the given vserver or vservers.
If used with the Aggregate switch, get aggregated performance statistics
for the given vserver or vservers.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Fcp
If specified, retrieve FCP performace statistics.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Ifnet
If specified, retrieve Ifnet performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Disk
If specified, retrieve disk performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Lun
If specified, retrieve LUN performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Nfsv4
If specified, retrieve NFSv4 performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Iscsi
If specified, retrieve iSCSI performance statistics.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Volume
If specified, retrieve volume performance statistics.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Cifs
If specified, retrieve CIFS performance statistics.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Nfsv3
If specified, retrieve NFSv3 performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Aggregated
If specified, retrieve aggregated performance statistics for the given n
odes or vservers. The following performance statistics types can be agg
regated for nodes and vservers: CIFS, iSCSI, FCP, and volume.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
NOTES
Category: perf
API: perf-object-get-instances,perf-object-instance-list-info-iter
Family: cluster, vserver
-------------- Example 1 --------------
C:\PS>Invoke-NcSysstat
Get system performance statistics for all of the nodes in the current cluste
r.
Node CPU NFS CIFS HTTP FCP iSCSI Net
Rcvd NetSent DiskRd DiskWr
---- --- --- ---- ---- --- ----- ---
---- ------- ------ ------
sfp-cmode-02-01 3% 0 0 0 0 0
3 KB 8 KB 5 KB 242 KB
sfp-cmode-02-02 2% 0 0 0 0 0
8 KB 3 KB 2 KB 6 KB
-------------- Example 2 --------------
C:\PS>Invoke-NcSysstat -Fcp -Vserver costea01
Get FCP performance statistics for the given vserver.
Name TotOps RdOps WrOps RdLat WrLat
Read Written
---- ------ ----- ----- ----- -----
---- -------
costea01.costea01_lif_data4 0 0 0 0.0 0.0
0 0
costea01.costea01_lif_data5 0 0 0 0.0 0.0
0 0
-------------- Example 3 --------------
C:\PS>Invoke-NcSysstat -Nfsv3 -Name cmorriss01
Get NFSv3 performance statistics.
Name RdOps WrOps RdLat WrLat
---- ----- ----- ----- -----
cmorriss01 0 0 0.0 0.0
-------------- Example 4 --------------
C:\PS>Invoke-NcSysstat -CIFS -Vserver beam01 -Count 5
Get CIFS performance statistics for the given vserver.
Name RdOps WrOps TotOps RdLat WrLat To
tLat
---- ----- ----- ------ ----- ----- --
----
beam01 0 0 0 0.0 0.0
0.0
beam01 0 1 1 0.0 0.7
0.8
beam01 0 123 125 0.0 0.3
0.3
beam01 0 151 154 0.0 0.3
0.3
beam01 0 152 155 0.0 0.4
0.4
-------------- Example 5 --------------
C:\PS>Invoke-NcSysstat -Iscsi -Node MFIT-01
Get iSCSI performance statistics for iSCSI LIFs on the given Node.
Name RdOps WrOps OthOps RdLat WrLat Ot
hLat Read Written
---- ----- ----- ------ ----- ----- --
---- ---- -------
beam01.beam01_data1 0 103 2 0.0 1.7
7.1 1 KB 19 MB
costea01.costea01_lif_data3 0 0 0 0.0 0.0
0.0 0 0
-------------- Example 6 --------------
C:\PS>Invoke-NcSysstat -Volume -Name powershell
Get the performance statistics for the given volume.
Name RdOps WrOps TotOps RdLat WrLat To
tLat Read Written
---- ----- ----- ------ ----- ----- --
---- ---- -------
powershell 764 308 1k 0.6 0.4
0.6 48 MB 19 MB
powershell 0 774 781 0.0 0.6
0.7 0 48 MB
-------------- Example 7 --------------
C:\PS>Invoke-NcSysstat -Ifnet -Name e0* -Node MFIT-01
Get Ifnet performance statistics for the given interface ports on the given
node.
Rcv RcvPkt RcvMPkt RcvDrop RcvErr Snd SndPkt SndMPkt SndErr Coll
Ifnet
--- ------ ------- ------- ------ --- ------ ------- ------
---- -----
2 KB 17 14 0 0 1 KB 2 0 0
0 MFIT-01:kernel:e0M
0 0 0 0 0 0 0 0 0
0 MFIT-01:kernel:e0P
1 KB 19 14 0 0 485 B 4 0 0
0 MFIT-01:kernel:e0a
0 0 0 0 0 0 0 0 0
0 MFIT-01:kernel:e0b
-------------- Example 8 --------------
C:\PS>Invoke-NcSysstat -Lun -Name /vol/powershell/*
Get LUN performance statistics for all of the LUNs in the powershell volume.
Read Written RdOps WrOps TotOps TotLat LunPath
---- ------- ----- ----- ------ ------ -------
13 B 0 0 0 1 7.0 /vol/powershell/luns/cluster
0 0 0 0 0 0.0 /vol/powershell/luns/disk0
-------------- Example 9 --------------
C:\PS>Invoke-NcSysstat -Disk -Node MFIT-01 -Count 1 -Interval 15
Get the disk performance statistics for the disk belonging to the given node
.
Busy DiskRd DiskWr RdOps WrOps TotOps QueueOps PendOps RdLat WrLa
t Disk
---- ------ ------ ----- ----- ------ -------- ------- ----- ----
- ----
2% 1 KB 49 KB 0 2 2 0 0 0.2 0.
8 3a.04.0
2% 0 17 KB 0 1 1 0 0 0.0 1.
6 3a.04.14
0% 0 12 KB 0 0 0 0 0 0.0 0.
4 3a.04.16
0% 0 12 KB 0 0 0 0 0 0.0 0.
3 3a.04.18
1% 0 44 KB 0 1 1 0 0 0.0 1.
0 3a.04.2
0% 0 10 KB 0 0 0 0 0 0.0 0.
7 3a.04.20
0% 0 10 KB 0 0 0 0 0 0.0 0.
6 3a.04.22
2% 1 KB 51 KB 0 2 2 0 0 0.0 0.
7 3b.04.1
1% 0 15 KB 0 0 1 0 0 0.0 1.
0 3b.04.13
1% 0 13 KB 0 0 1 0 0 0.0 1.
3 3b.04.15
0% 0 11 KB 0 0 0 0 0 0.0 0.
5 3b.04.17
0% 0 11 KB 0 0 0 0 0 0.0 0.
3 3b.04.19
0% 0 10 KB 0 0 0 0 0 0.0 0.
6 3b.04.21
-------------- Example 10 --------------
C:\PS>Invoke-NcSysstat -cifs -Node MFIT-01 -Aggregated
Get aggregated CIFS performance statistics for the given node.
Name RdOps WrOps TotOps RdLat WrLat To
tLat
---- ----- ----- ------ ----- ----- --
----
MFIT-01 0 0 0 0.0 0.0
0.0
RELATED LINKS
Get-NcPerfData
Get-NcPerfInstance
Get-NcPerfCounter
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|