|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Invoke-NaSysstat
NAME
Invoke-NaSysstat
SYNOPSIS
PowerShell analogue of Data ONTAP's sysstat CLI command.
SYNTAX
Invoke-NaSysstat [-SampleIntervalSeconds <Double>] [-Count <Int32>] [-Hashta
ble] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Cifs [-SampleIntervalSeconds <Double>] [-Count <Int32>] [-
Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Disk <String[]> [-SampleIntervalSeconds <Double>] [-Count
<Int32>] [-Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Fcp [-SampleIntervalSeconds <Double>] [-Count <Int32>] [-H
ashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -HostAdapter <String[]> [-SampleIntervalSeconds <Double>] [
-Count <Int32>] [-Hashtable] [-Controller <NaController>] [<CommonParameters
>]
Invoke-NaSysstat -Ifnet <String[]> [-SampleIntervalSeconds <Double>] [-Count
<Int32>] [-Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Iscsi [-SampleIntervalSeconds <Double>] [-Count <Int32>] [
-Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Lun <String[]> [-VfilerContext <String>] [-SampleIntervalS
econds <Double>] [-Count <Int32>] [-Hashtable] [-Controller <NaController>]
[<CommonParameters>]
Invoke-NaSysstat -Nfs3 [-SampleIntervalSeconds <Double>] [-Count <Int32>] [-
Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Qtree <String[]> [-SampleIntervalSeconds <Double>] [-Count
<Int32>] [-Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Vfiler <String[]> [-SampleIntervalSeconds <Double>] [-Coun
t <Int32>] [-Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Volume <String[]> [-SampleIntervalSeconds <Double>] [-Coun
t <Int32>] [-Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -Wafl [-SampleIntervalSeconds <Double>] [-Count <Int32>] [-
Hashtable] [-Controller <NaController>] [<CommonParameters>]
Invoke-NaSysstat -AllProtocols [-SampleIntervalSeconds <Double>] [-Count <In
t32>] [-Hashtable] [-Controller <NaController>] [<CommonParameters>]
DESCRIPTION
PowerShell analogue of Data ONTAP's sysstat CLI command.
This cmdlet uses the performance APIs to deliver a running tabular display o
f real-time performance metrics. The values presented are as similar as pos
sible to those provided by sysstat within the bounds of the performance APIs
.
Unlike sysstat, Invoke-NaSysstat supports not only top-level controller metr
ics but also performance values for other object classes such as volumes, vf
ilers, LUNs, network interfaces, storage adapters, individual data protocols
, and WAFL.
In some cases, there are more data fields than fit in the tabular views; use
"Format-List *" to see everything.
In the unformatted output, data sizes are presented in bytes. Data rates ar
e presented in bytes per second. Latency values are presented in millisecon
ds.
PARAMETERS
-SampleIntervalSeconds <Double>
Period in seconds of the sampling frequency at which records are returne
d.
Required? false
Position? named
Default value 15
Accept pipeline input? false
Accept wildcard characters? false
-Count <Int32>
Number of iterations to get. Omit to run indefinitely.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Hashtable
Specify to capture performance data in a hashtable keyed by instance nam
e instead of individual objects. This is intended to simplify using and
accessing the performance objects in scripts.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Cifs
Specify to get CIFS-specific performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Disk <String[]>
Specify to get disk-specific performance statistics. Wildcards are supp
orted.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Fcp
Specify to get FCP-specific performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-HostAdapter <String[]>
Specify to get host adapter-specific performance statistics. Wildcards
are supported.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Ifnet <String[]>
Specify to get network interface-specific performance statistics. Wildc
ards are supported.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Iscsi
Specify to get iSCSI-specific performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Lun <String[]>
Specify to get LUN-specific performance statistics. Specify using the f
ull LUN path. Wildcards are supported.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-VfilerContext <String>
If monitoring LUN objects owned by a vfiler, you must specify the name o
f the vfiler.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Nfs3
Specify to get NFSv3-specific performance statistics.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Qtree <String[]>
Qtree to query for performance statistics. Specify using the format <vo
l>/<qtree>. Wildcards are supported.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Vfiler <String[]>
Vfiler to query for performance statistics. Wildcards are supported.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Volume <String[]>
Volume to query for performance statistics. Wildcards are supported.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Wafl
Specify to get WAFL-specific performance statistics, such as cache age a
nd consistency point info.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AllProtocols
Specify to query all of System, Cifs, Fcp, Iscsi, Nfs3 and Wafl statisti
cs in a single wrapper object.
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
DataONTAP.PowerShell.SDK.Cmdlets.Perf.PerfInfo
NOTES
Category: perf
API: perf-object-get-instances
-------------- Example 1 --------------
C:\PS>Invoke-NaSysstat
Get controller-level performance metrics.
CPU NFS CIFS HTTP FCP iSCSI RdOps WrOps TotOps NetRcvd NetSent D
iskRd DiskWr RdLat WrLat TotLat
--- --- ---- ---- --- ----- ----- ----- ------ ------- -------
------ ------ ----- ----- ------
1% 0 0 0 0 0 0 1 1 2 KB 819 B
82 KB 550 KB 0.0 0.0 0.3
-------------- Example 2 --------------
C:\PS>Invoke-NaSysstat -Vfiler vfiler0 -I 60
Get performance statistics for vfiler 'vfiler0'. The samples are to be take
n once per minute.
CPU RdOps WrOps MiscOps NetRcvd NetSent DiskRd DiskWr
--- ----- ----- ------- ------- ------- ------ ------
1% 0 1 7 3 KB 512 B 0 3 KB
1% 0 1 2 3 KB 239 B 0 3 KB
1% 0 1 7 3 KB 205 B 0 3 KB
2% 7 7 62 7 KB 5 KB 35 KB 43 KB
4% 66 83 13 1 MB 1 MB 981 KB 1 MB
3% 17 32 30 746 KB 181 KB 184 KB 753 KB
-------------- Example 3 --------------
C:\PS>$s = Invoke-NaSysstat -Count 1 -Hashtable -Disk 0a.*
$s["0a.16"]
Capture a single performance data set for all disks on the '0a' channel. Re
turn the data as a hashtable, and then print the value of a single disk "0a.
16".
Busy DiskRd DiskWr RdOps WrOps TotOps QueueOps PendOps RdLat WrLa
t Disk
---- ------ ------ ----- ----- ------ -------- ------- ----- ---
-- ----
1% 1 KB 26 KB 0 2 2 0 0 30.6 1
.0 0a.16
-------------- Example 4 --------------
C:\PS>Invoke-NaSysstat -Lun /vol/vfa109_smallvol014/luns/vfa109_lun005 -i 1
-VfilerContext vfa109
While connected to a physical filer, monitor the performance of LUNs owned b
y a vfiler.
Read Written RdOps WrOps TotOps TotLat LunPath
---- ------- ----- ----- ------ ------ -------
0 0 0 0 0 0.0 /vol/vfa109_smallvol014/luns/vfa109_l
un005
0 0 0 0 0 0.0 /vol/vfa109_smallvol014/luns/vfa109_l
un005
0 0 0 0 0 0.0 /vol/vfa109_smallvol014/luns/vfa109_l
un005
0 0 0 0 0 0.0 /vol/vfa109_smallvol014/luns/vfa109_l
un005
0 0 0 0 0 0.0 /vol/vfa109_smallvol014/luns/vfa109_l
un005
RELATED LINKS
Get-NaPerfCounter
Get-NaPerfData
Get-NaPerfInstance
Get-NaPerfObject
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|