Monitor Azure In-Role Cache
Important
Microsoft recommends all new developments use Azure Redis Cache. For current documentation and guidance on choosing an Azure Cache offering, see Which Azure Cache offering is right for me?
This topic provides an overview of the monitoring capabilities and performance counters specific to In-Role Cache.
Monitoring In-Role Cache Applications
You can monitor key performance metrics for your Cloud Services in the Azure Management Portal, and can customize what you monitor in the portal to meet your needs. Monitoring displays in the are highly configurable. You can choose the metrics you want to monitor in the metrics list on the Monitor page, and you can choose which metrics to plot in metrics charts on the Monitor page and the dashboard. The monitoring features are available for Microsoft Azure Cloud Services, including In-Role Cache applications. For information on monitoring Azure Cloud Services, see How to Monitor Cloud Services. This topic provides an overview of the monitoring capabilities and performance counters specific to In-Role Cache.
Caching Performance Counters
In-Role Cache provides performance monitor counters that allow you to monitor and troubleshoot In-Role Cache applications. There are five counter categories for caching divided into server and client counter categories:
Cache Server Performance Counters
Azure Caching:Cache
Azure Caching:Host
Azure Caching:Secondary
Cache Client Performance Counters
Azure Caching:Client
Azure Caching:Client Host
Note that the GetAndLock method is considered read operation. If the object is returned to the client, the returned count is incremented. If the object is already locked, then the miss count is incremented. In the same way, the PutAndUnlock is a write operation.
Methods that change the state of objects in the cache, such as Unlock and ResetTimeout, are not included in the read or write counts. Instead, these methods are reflected in the client request count.
Cache Server Performance Counters
There are three categories of cache server performance counters.
Azure Caching:Cache
Azure Caching:Host
Azure Caching:Secondary
Azure Caching:Cache
The Azure Caching:Cache performance counter category provides cache-specific counters that pertain to all caches on the cache host. Each instance of a cache counter corresponds to a separate named cache in the cache host.
Performance Counter | Description |
---|---|
Cache Miss Percentage |
The percentage of unsuccessful cache requests to the total number of requests since start of cache service. |
Total Cache Misses |
The total number of unsuccessful cache requests since start of cache service. |
Total Cache Misses / sec |
The total number of unsuccessful cache requests per second since start of cache service. |
Total Data Size Bytes |
Represents the total size of cached data in the cache, not including cache overhead. Indicates the current data memory usage of the server. |
Total Primary Data Size Bytes |
Represents the total size of primary cached data in the cache, not including cache overhead. Indicates the current primary memory data usage of the cache. |
Total Secondary Data Size Bytes |
Represents the total size of secondary cached data in the cache, not including cache overhead. Indicates the current secondary memory data usage of the cache. |
Total Object Count |
Represents the total number of objects stored in cache. |
Total Client Requests |
The total number of client requests, including all API calls. |
Total Client Requests / sec |
The total number of client requests per second, including all API calls. |
Total Read Requests |
The number of read requests (Bulk Get, Get and Enumeration) received from all clients since start of cache service. |
Total Read Requests / sec |
The number of read requests (Bulk Get, Get and Enumeration) received per second from all clients since start of cache service. |
Total Objects Returned |
The number of objects returned by client read requests. This counter along with total read requests counter indicates the success of read operations. |
Total Objects Returned / sec |
The number of objects returned by client read requests per second. |
Total Write Operations |
The number of write requests since start of cache service. Put, Add, and Lock methods are included with write operations. |
Total Write Operations / sec |
The number of write requests per second since start of cache service. Put, Add, and Lock methods are included with write operations. |
Total GetAndLock Requests |
The total number of GetAndLock requests since start of cache service. |
Total GetAndLock Requests / sec |
The total number of GetAndLock requests per second since start of cache service. |
Total Successful GetAndLock Requests |
The number of GetAndLock requests succeeded since start of cache service. |
Total Successful GetAndLock Requests / sec |
The number of GetAndLock requests succeeded per second since start of cache service. |
Azure Caching:Host
The Azure Caching:Host performance counter category provides counters that pertain to a single cache host. Host counters track information such as total active connections and total client requests for a single cache host.
Performance Counter | Description |
---|---|
Average Quorum Response Time / operation Microsecond |
The average time spent in quorum response. It indicates amount of time spent by write operations in replication. |
Average Secondary Response Time / operation Microsecond |
The average time spent to get response from all the secondary servers. |
Cache Miss Percentage |
The percentage of unsuccessful cache requests to the total number of requests since start of cache service. |
Total Cache Misses |
The total number of unsuccessful cache requests since start of cache service. |
Total Cache Misses / sec |
The total number of unsuccessful cache requests per second since start of cache service. |
Total Data Size Bytes |
Represents the total size of cached data in the cache, not including cache overhead. Indicates the current data memory usage of the server. |
Total Evicted Objects |
The number of evicted objects since start of cache service. |
Total Eviction Runs |
The number of eviction runs since the start of the cache service. |
Total Expired Objects |
The total number of expired objects since start of cache service. |
Total Memory Evicted |
The amount of memory freed from cache since start of cache service. This counter also includes expired object memory. |
Total Primary Data Size Bytes |
Represents the total size of primary cached data in the cache, not including cache overhead. Indicates the current primary memory data usage of the server. |
Total Secondary Data Size Bytes |
Represents the total size of secondary cached data in the cache, not including cache overhead. Indicates the current secondary memory data usage of the server. |
Total Failure Exceptions |
The number of exceptions thrown since start of the cache cluster. |
Total Failure Exceptions / sec |
The number of exceptions per second thrown since the start of cache cluster. |
Total Retry Exception |
The total number of retry operation exceptions since start of cache service. |
Total Retry Exception / sec |
The total number of retry operation exceptions per second since start of cache service. |
Total Client Requests |
The total number of client requests, including all API calls. |
Total Client Requests / sec |
The total number of client requests per second, including all API calls. |
Total Get Misses |
The number of Get misses from all clients since start of cache service. |
Total Get Misses / sec |
The number of Get misses per second from all clients since start of cache service. |
Total Get Requests |
The number of Get requests received from all clients since service has started. |
Total Get Requests / sec |
The number of Get requests per second received from all clients since service has started. |
Total GetAndLock Requests |
The total number of GetAndLock requests since start of cache service. |
Total GetAndLock Requests / sec |
The total number of GetAndLock requests per second since start of cache service. |
Total Successful GetAndLock Requests |
The number of GetAndLock requests succeeded since start of cache service. |
Total Successful GetAndLock Requests / sec |
The number of GetAndLock requests succeeded per second since start of cache service. |
Total Read Requests |
The number of read requests (Bulk Get, Get and Enumeration) received from all clients since start of cache service. |
Total Read Requests / sec |
The number of read requests (Bulk Get, Get and Enumeration) received per second from all clients since start of cache service. |
Total Write Operations |
The number of write requests since start of cache service. Put, Add and Lock methods are included with write operations. |
Total Write Operations / sec |
The number of write requests per second since start of cache service. Put, Add and Lock methods are included with write operations. |
Total Requests Served |
The number of requests served and responses sent by the server since start of cache service. |
Total Requests Served / sec |
The number of requests served and responses sent by the server per second since start of cache service. |
Total Object Count |
Represents the total number of objects stored in host. |
Total Objects Returned |
The number of objects returned by client read requests. This counter along with total read requests counter indicates the success of read operations. |
Total Objects Returned / sec |
The number of objects returned by client read requests per second. |
Total Notification Delivered |
The number of notifications delivered to clients. |
Total Notification Delivered / sec |
The number of notifications per second delivered to clients. |
Total Notification Poll Requests |
The total number of poll request from client since start of cache service. |
Total Notification Poll Requests / sec |
The total number of poll request per second from client since start of cache service. |
Azure Caching:Secondary
The Azure Caching:Secondary performance counter category provides information that pertains to cache servers only when high availability (HA) is enabled. When HA is enabled, each primary partition has a corresponding secondary partition which is located in a different role instance. Each role instance may contain both its own primary partitions and secondary partitions that correspond to primary partitions in other role instances. When HA is not enabled, no secondary partitions are available and the counters within this category do not provide any useful data.
Performance Counter | Description |
---|---|
Total Replication Retries |
The total number of retry replication operations for each secondary server. |
Cache Client Performance Counters
There are two categories of cache client performance counters: Azure Caching:Client and Azure Caching:Client Host. Azure Caching:Client has counters that provide information about a single cache client. Azure Caching:Client Host has the same counters as Azure Caching:Client, and provides aggregated information about all of the cache clients on a machine.
Azure Caching:Client
Azure Caching:Client Host
Note
To view cache client performance counters in the , select counters from the Azure Caching:Client Host category.
Azure Caching:Client
The Azure Caching:Client performance counter category provides counters that pertain to a single cache client.
Performance Counter | Description |
---|---|
Average Get Latency / operation Microsecond |
The average latency in, microseconds for Get requests irrespective of whether they access the local cache or the cache cluster. |
Average Get Latency (Network) / operation Microsecond |
The average latency in microseconds for Get requests that access the cache cluster. This excludes calls that access the local cache. |
Average Put Latency / operation Microsecond |
The average latency in microseconds for Put requests. |
Local Cache Hits Percentage |
The percentage of Get requests across all cache clients (irrespective of their local cache settings) that are fulfilled by the local cache. |
Local Cache Filled Percentage |
The percentage of objects stored in local cache in relation to the total capacity of the local cache. Note that that is an aggregation of the local cache properties of all cache clients in the current process. |
Read Requests |
The number of Read requests (Get and Enumeration) since the start of the process. |
Write Requests |
The number of Write requests (Put and Add) requests since the start of the process. |
Bytes Received / sec |
The number of bytes of data received from the cache during the previous second. |
Bytes Sent / sec |
The number of bytes of data sent to the cache during the previous second. |
Current Server Connections |
The number of active connections to the cache cluster from this process. |
Total Connection Requests Failed |
The number of failed connection requests since start of the process. |
Current Waiting Requests |
The current number of requests which have not yet received a response from the cache cluster. |
Total Notifications Received |
The number of Caching notifications received since start of the process. |
Failure Exceptions |
The number of Caching exceptions received since the start of the process. |
Failure Exceptions / sec |
The rate of Caching exceptions received by the process. |
Retry Exceptions |
The number of retry operation exceptions received since the start of the process. |
Retry Exceptions / sec |
The rate of retry operation exceptions received by the process. |
Timeout Exceptions |
The number of timeout exceptions received since the start of the process. |
Timeout Exceptions / sec |
The rate of timeout exceptions received by the process. |
Network Exceptions |
The number of network exceptions received since the start of the process. |
Network Exceptions / sec |
The rate of network exceptions received by the process. |
Server Responses Dropped / sec |
The total number of times when the process was unable to receive a response from the cache cluster. This can happen when a client thread experiences a timeout and there are no other threads available to receive the response. |
Requests |
The number of requests sent from process to the cache cluster since start of the process. |
Requests / sec |
The rate of requests sent from the process to the cache cluster. |
Total Local Cache Hits |
The total number of requests that are fulfilled by the local cache since start of the process. This does not differentiate between different cache clients with different local cache settings. |
Total Local Cache Objects |
The total number of objects in local cache. Note that that is an aggregation of the local cache properties of all cache clients in the current process. |
Azure Caching:Client Host
The Azure Caching:Client Host performance counter category provides counters that pertain to all of the cache clients on a machine. To view cache client performance counter data in the , use performance counters from the Azure Caching:Client Host category.
Performance Counter | Description |
---|---|
Average Get Latency / operation Microsecond |
The average latency in, microseconds for Get requests irrespective of whether they access the local cache or the cache cluster. |
Average Get Latency (Network) / operation Microsecond |
The average latency in microseconds for Get requests that access the cache cluster. This excludes calls that access the local cache. |
Average Put Latency / operation Microsecond |
The average latency in microseconds for Put requests. |
Local Cache Hits Percentage |
The percentage of Get requests across all cache clients (irrespective of their local cache settings) that are fulfilled by the local cache. |
Local Cache Filled Percentage |
The percentage of objects stored in local cache in relation to the total capacity of the local cache. Note that that is an aggregation of the local cache properties of all cache clients in the current process. |
Read Requests |
The number of Read requests (Get and Enumeration) since the start of all client processes on the machine. |
Write Requests |
The number of Write requests (Put and Add) requests since the start of all client processes on the machine. |
Bytes Received / sec |
The number of bytes of data received from the cache during the previous second. |
Bytes Sent / sec |
The number of bytes of data sent to the cache during the previous second. |
Current Server Connections |
The number of active connections to the cache cluster from all client processes on the machine. |
Total Connection Requests Failed |
The number of failed connection requests since start of all client processes on the machine. |
Current Waiting Requests |
The current number of requests which have not yet received a response from the cache cluster. |
Total Notifications Received |
The number of Caching notifications received since start of all client processes on the machine. |
Failure Exceptions |
The number of Caching exceptions received since the start of all client processes on the machine. |
Failure Exceptions / sec |
The rate of Caching exceptions received by all client processes on the machine. |
Retry Exceptions |
The number of retry operation exceptions received since the start of all client processes on the machine. |
Retry Exceptions / sec |
The rate of retry operation exceptions received by all client processes on the machine. |
Timeout Exceptions |
The number of timeout exceptions received since the start of all client processes on the machine. |
Timeout Exceptions / sec |
The rate of timeout exceptions received by all client processes on the machine. |
Network Exceptions |
The number of network exceptions received since the start of all client processes on the machine. |
Network Exceptions / sec |
The rate of network exceptions received by the process. |
Server Responses Dropped / sec |
The total number of times all clients on the machine were unable to receive a response from the cache cluster. This can happen when a client thread experiences a timeout and there are no other threads available to receive the response. |
Requests |
The number of requests sent from process to the cache cluster since start of all client processes on the machine. |
Requests / sec |
The rate of requests sent from all client processes on the machine to the cache cluster. |
Total Local Cache Hits |
The total number of requests that are fulfilled by the local cache since start of all client processes on the machine. This does not differentiate between different cache clients with different local cache settings. |
Total Local Cache Objects |
The total number of objects in local cache. Note that that is an aggregation of the local cache properties of all cache clients in the current process. |