Measure-CachePerformance
This PowerShell cmdlet measures and reports the performance of cache operations for a specified cache. It gives insight into cache's efficiency by displaying the key metrics such as ReadWriteRatio
, ThreadCount
, and Duration
. It is different from the Test-Stress cmdlet as the output includes average Read/Write time and Request/sec.
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
- This command measures performance of a cache named demoCache on server 20.200.20.11 with default settings of object size 100 bytes, read-write ratio 4, duration 120 seconds, thread count 1, and absolute expiration 300 seconds.
Measure-CachePerformance -Server 20.200.20.11 -CacheName demoCache
- This command measures performance of the demoCache with object size 10 bytes, read-write ratio 4, duration 60 seconds, and thread count 1.
Measure-CachePerformance -Server 20.200.20.11 -CacheName demoCache -ObjectSize 10 -Duration 60
- This command measures performance of the demoCache with object size 5 bytes, read-write ratio 3, duration 30 seconds, and thread count 10.
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 seconds |
-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. | - |