NAME

Get-DcsPerformanceCounter

SYNOPSIS

Returns performance counter data for the specified object.

SYNTAX

Get-DcsPerformanceCounter   -Object <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns performance counter data for the specified object. Some counter values accumulate and some counter values are displayed as the value at collection time (CollectionTime field in the returned object, see example). The accumulated values in returned objects are raw, unprocessed data at collection time, not "per second" as displayed in the DataCore Management Console. For instance, to receive values per second the cmdlet would have to be invoked at least twice to calculate values per second. Descriptions of performance counters are provided as tool tips in the Performance tool in the DataCore DataCore Management Console. Some counters in the Performance tool are derived from raw data counters found in PerformanceData objects. Therefore, some raw data counters may not appear in the tool and some derived counters may not appear in retrieved PerformanceData objects. Special notes about these raw data counters are documented. For the Pool PerformanceData object: TotalWriteTime is a cumulative counter that measures the total time it took to perform all the write I/Os to the back-end pool disk. It is used to compute the Average Time/Write counter in the Performance tool. Average Time per Write = ∆ TotalWriteTime / ∆ TotalWrites. TotalReadTime is a cumulative counter that measures the total time it took to perform all read I/Os to the back-end pool disk. It is used to compute the Average Time/Read counter in the Performance tool. Average Time per Read = ∆ TotalReadTime / ∆ TotalReads.

PARAMETERS

-Object<Object>

Any object or ID that identifies one of the following object types: servers, server SCSI ports, server groups, client hosts, host groups, client host SCSI ports, physical disks, pool Members, pools, pool mirrors, virtual disks, snapshots, logical disks, logical disks with Continuous Data Protection, virtual logical units, target devices, and target domains. Special Notes: To get performance counter data for a shared physical disk, provide the SharedPhysicalDiskData object; data will be aggregated from all servers sharing the physical disk. If the PhysicalDiskData object is provided for a shared physical disk, then the performance counter data returned will only be from one server. To get performance counter data for a shared disk pool, always provide the SharedDiskPoolData object for the pool.

Required: true

Position: 1

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Connection<String>

Alias of the connection to the server group. If not specified, the default connection is used.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PipelineVariable<String>

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

INPUTS

Object : Any object that has performance counters, used to identify the Object parameter.

OUTPUTS

PerformanceData : Object that describes the performance data for an object.

NOTES

To add counters to a recording session, see Add-DcsRecordingPoint. Also see Get-DcsRecordingInstance, Get-DcsRecordingPerformance, Get-DcsRecordingPoint, Get-DcsRecordingResolution, Get-DcsRecordingEndpoint, Get-DcsRecordingSession, Get-DcsRecordingStatistics

EXAMPLES

Get-DcsPool -Server SSV1 -Pool "Disk pool 1" | Get-DcsPerformanceCounter
			

Get-DcsLogicalDisk -VirtualDisk 'Virtual Disk 1' -Server SSV2 | Get-DcsPerformanceCounter | select-object BytesAllocated
			

BytesAllocated
--------------
4194304
		

$resultsLocation = "C:\"
$allocationResult = @()
foreach($vd in (Get-DcsVirtualDisk))
{
$result = New-Object PSObject
$result | Add-Member -MemberType NoteProperty -Name "Virtual Disk" -Value ($vd.Alias)
$result | Add-Member -MemberType NoteProperty -Name "Allocation" -Value (($vd[0] | Get-DcsPerformanceCounter).BytesAllocated)
$result | Add-Member -MemberType NoteProperty -Name "Size" -Value "Bytes"
$allocationResult += $result
}
$allocationResult > $resultsLocation\allocation-results.txt

Virtual Disk                        Allocation Size
------------                        ---------- ----
Virtual disk 1                     53284438016 Bytes
Virtual disk 2                     30601641984 Bytes
Virtual disk 3                     24293408768 Bytes
Virtual disk 4                     24024973312 Bytes
		

$MiB = 1024*1024
$Pools = Get-DcsPool
foreach($p in $Pools)
{
Write-Host "Allocation for" $p.ExtendedCaption " = " $Alloc ($p | Get-DcsPerformanceCounter | % {$_.BytesAllocated/$MiB}) "MiB"
Write-Host
}
			

Allocation for Disk pool 1 on SSV1  =  1408 MiB
Allocation for Shared pool 1 on SSV1  =  2176 MiB
Allocation for Disk pool 2 on SSV2  =  896 MiB
Allocation for Shared pool 1 on SSV2  =  2176 MiB
Allocation for Disk pool 3 on SSV3  =  512 MiB
Allocation for Shared pool 1 on SSV3  =  2176 MiB
		

Get-DcsPoolMember -Pool "Disk pool 1" | Get-DcsPerformanceCounter
		

Get-DcsLogicalDisk -VirtualDisk "Virtual Disk 1" -Server SSV2 | Get-DcsPerformanceCounter
			

(Get-DcsLogicalDisk -VirtualDisk "[VIRTUAL DISK NAME]" -Server [DATACORE SERVER NAME] | Get-DcsPerformanceCounter).RetentionPeriod/(1000*60*60)