Get Cache Server Statistics
Note
This feature is available in NCache Enterprise and Professional.
This displays the statistics of the specified cache. It displays a list of performance counters by default which can be extended by a list of custom counters. It helps you save the counters in a .CSV file which can be opened in Microsoft Excel. Moreover, the .CSV file can be converted to .BLG format for viewing counters in Performance Monitor.
Get-CacheServerStatistics [-CacheName] [-Server] [-CounterNames] [-Continuous] [-DoNotShowDefaultCounters] [-Format] [-SampleInterval] [-MaxSamples] [-NoLogo]
Examples
- The following command displays the default counters of the server for demoCache from the default node.
Get-CacheServerStatistics -CacheName demoCache
- The following command displays the default counters for the cache demoCache from the client nodes 20.200.20.11 and 20.200.20.12.
Get-CacheServerStatistics -CacheName demoCache -Server "20.200.20.11,20.200.20.12"
- This command gets values of specified counter names alongside the default counters for demoCache.
Get-CacheServerStatistics -CacheName demoCache -Server "20.200.20.11,20.200.20.12" -CounterNames "Hits/sec,Misses/sec"
- This command gets the 50 samples from defined counters for demoCache.
Get-CacheServerStatistics -CacheName demoCache -Server "20.200.20.11,20.200.20.12" -CounterNames "Hits/sec,Misses/sec" -MaxSamples 50
- This command gets values of specified counter names for demoCache. It does not display the values of default counters.
Get-CacheServerStatistics -CacheName demoCache -Server "20.200.20.11,20.200.20.12" -CounterNames "Hits/sec,Misses/sec" -DoNotShowDefaultCounters
- The following command gets default counters for the cache demoCache continuously after every 3 second interval.
Get-CacheServerStatistics -CacheName demoCache -Continuous -SampleInterval 3
- This command gets values of counters for demoCache continuously after every 5 seconds.
Get-CacheServerStatistics -CacheName demoCache -Server "20.200.20.11,20.200.20.12" -Continuous -SampleInterval 5
- This command gets values of default counters for demoCache continuously after every 3 seconds and saves the output in .CSV format at the given location.
Get-CacheServerStatistics -CacheName demoCache -Continuous -SampleInterval 1 -Format CSV | Out-File -Encoding ASCII "C:\stats.csv"
Properties
Note
The parameters with asterisk (*) on their names are the required parameters and the rest are optional.
| Parameters | Data Types | Description | Default Value |
|---|---|---|---|
-CacheName* |
<String> |
Specifies the name of the cache for which counters need to be fetched. | - |
-Server |
<String> |
Specifies one or more server name(s) where the NCache Service is running and a cache with the specified cache-name is running. NOTE: Comma (,) separated server names are to be specified in case of multiple clients. |
Local Machine |
-CounterNames |
<String> |
Specifies one or more counter(s) not included in default counters that should be displayed. NOTE: Comma (,) separated counter names are to be specified in case of multiple counters. The PerfMon counters mentioned on this page can be fetched by this switch. |
- |
-Continuous |
<SwitchParameter> |
Specified in order to get the statistics continuously. | - |
-DoNotShowDefaultCounters |
<SwitchParameter> |
Specifies whether default counters are to be shown. NOTE: This parameter is only valid if Counter Names are provided. |
False |
-Format |
<String> |
By default display format is tabular but it can be set to CSV, and that output can be saved in CSV file for future use. | Tabular |
-SampleInterval |
<Integer> |
Specifies the time between samples in seconds. Minimum value is 3 seconds. | 1 |
-MaxSamples |
<Integer> |
Specifies the number of samples to get from each counter. To get samples continuously (no maximum sample size), use the Continuous parameter. NOTE: The Continuous parameter and the MaxSamples parameter cannot be used in the same command. If a sample interval is provided, it will take the next Sample after that interval, otherwise it will use the default value, i.e., 3 seconds. |
1 |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | False |