Measure-CachePerformance - PowerShell Cmdlet
This PowerShell cmdlet measures and reports the performance of cache operations for a specified cache. The PowerShell cmdlet displays key metrics such as ReadWriteRatio, ThreadCount, and Duration giving insight into cache's efficiency. It is different from the Test-Stress cmdlet as the output includes average Read/Write time and Request/sec.
Note
This feature is only available in NCache Enterprise.
Warning
The performance metrics provided are indicative and reflect the relative performance of the NCache server under the specified test conditions. Actual performance may vary due to factors such as machine hardware, network conditions, and the nature of the data being processed.
Measure-CachePerformance [-CacheName] [-Server] [-ObjectSize] [-ReadWriteRatio] [-Duration] [-ThreadCount] [-AbsoluteExpiration] [-Credentials]
Examples of Measure-CachePerformance - PowerShell Cmdlet
- This command measures performance of a cache named demoCache on server 20.200.20.11 with default settings of ObjectSize 100 bytes, Read-Write Ratio 4, Duration 120 seconds, ThreadCount 1, and AbsoluteExpiration 300 seconds.
Measure-CachePerformance -Server 20.200.20.11 -CacheName demoCache
- This command measures performance of the demoCache with ObjectSize 10 bytes, Read-Write Ratio 4, Duration 60 seconds, and 1 thread.
Measure-CachePerformance -Server 20.200.20.11 -CacheName demoCache -ObjectSize 10 -Duration 60
- This command measures performance of the demoCache with ObjectSize 5 bytes, Read-Write Ratio 3, Duration 30 seconds, and 10 threads.
Measure-CachePerformance -Server 20.200.20.11 -CacheName demoCache -ObjectSize 5 -ReadWriteRatio 3 -Duration 30 -ThreadCount 10
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 you want to measure performance. | - |
-Server* |
<string> |
Specifies one or more server IP addresses where the cache is running. | - |
-ObjectSize |
<int> |
Specifies the size of objects in bytes to be used in the performance test. | 100 |
-ReadWriteRatio |
<int> |
Specifies the ratio of read to write operations. | 4 |
-Duration |
<int> |
Specifies the duration in seconds for which the performance test should run. The value can range from 1-2147483647. | 120 |
-ThreadCount |
<int> |
Specifies the number of threads to be used for the test. | 1 |
-AbsoluteExpiration |
<double> |
Specifies absolute expiration for cache item in seconds. | 300 |
-Credentials |
<pscredential> |
Specifies the user credentials required to authorize access for the specified operation. The credentials should belong to a user with appropriate permissions at the node. | - |
