Monitor Azure In-Role Cache

Article
11/09/2015

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.