Azure Redis Cache

Learn about the other Azure service support on our Azure docs.

Sensor (Data Collection)

Tracked Configuration

Redis Details Description
Name The name of the Redis instance
Resource Group The resource group of the Redis instance
Location The region where the Redis instance is located
Subscription Id The subscription ID of the Redis instance
Version The Redis version running
Host Name The FQDN the Redis instance is reachable at
Provisioning Status Redis instance provisioning status
SSL Port Redis SSL Port
Non SSL Port Enabled Specifies whether the non-SSL Redis server port is enabled
Port The non-SSL port Redis is listening on
SKU The SKU (Pricing tier) of the Redis cache
Clustering
Clustering Enabled Specifies whether custering is enabled
Shard Count The number of shards to be created on a Premium Cluster Cache
Configuration
Max Clients Maximum number of client connections
Max Memory Reserved The amount of memory, in MB, that is reserved for non-cache operations, such as replication during failover (only available for Standard and Premium caches)
Max Fragmentation Memory Reserved The amount of memory in MB that is reserved to accommodate for memory fragmentation (only available for Standard and Premium caches)
Max Memory Delta The max-memory delta for this Redis instance
Network
Static IP Static IP address. Required when deploying a Redis cache inside an existing Azure Virtual Network
Subnet ID The full resource ID of a subnet in a virtual network to deploy the Redis cache in

Metrics

Redis Metric Description Per Shard
Connections
Connected Clients Maximum number of client connections Yes
Operations
Total Operations Total number of commands processed by the cache server Yes
Operations per Second Maximum number of operations per second by the cache server Yes
Cache Hits/Misses
Cache Hits Total number of successful key lookups Yes
Cache Misses Total number of failed key lookups Yes
Gets/Sets
Gets Total number of get operations from the cache Yes
Sets Total number of set operations to the cache Yes
Keys
Total keys Maximum number of keys in the cache Yes
Expired Keys Total number of items expired from the cache
Evicted Keys Total number of items evicted from the cache due to the maxmemory limit Yes
Memory
Used Maximum amount of cache memory used for key/value pairs in the cache in MB Yes
Used RSS Maximum amount of cache memory used in MB including fragmentation and metadata Yes
Used Percentage Maximum percentage of total memory that is being used No
Cache Read/Write
Cache Read Maximum amount of data read from the cache in Megabytes per second (MB/s) Yes
Cache Write Maximum amount of data written to the cache in Megabytes per second (MB/s) Yes
Server Load
Server Load Maximum percentage of cycles in which the Redis server is busy processing and not waiting idle for messages Yes
CPU
CPU Maximum CPU utilization of the Azure Redis Cache server as a percentage Yes
Latency
Cache Latency The average latency of the cache calculated based off the internode latency of the cache. This metric is measured in microseconds No
Errors
Errors Total number of specific failures and performance issues that the cache could be experiencing No

Health Checks

The Azure Redis Cache sensor will conduct custom health checks and execute them every minute. If the checks fail for at least one minute, an issue will be raised to inform the user.

Health Description
Memory Usage Azure Redis Cache is using more than 90% of available memory
Client Connections Azure Redis Cache is using more than 90% of available client connections

Configuration

Azure Redis Cache sensor can be disabled and it can be filtered by tags and resource groups. It is possible to configure Azure Redis Cache sensor via agent configuration in <agentinstall_dir>/etc/instana/configuration.yaml by:

com.instana.plugin.azure.rediscache:
    # Valid values: true, false
    enabled: false # enabled (true) by default
    # Comma separated list of tags in key:value format
    include_tags: 
    # Comma separated list of tags in key:value format
    exclude_tags: 
    # Comma separated list of resource groups
    include_resource_groups: 
    # Comma separated list of resource groups
    exclude_resource_groups: 

Azure Redis Cache sensor can be disabled. To disable monitoring of the Azure Redis Cache services use the folowing configuration:

com.instana.plugin.azure.rediscache:
    enabled: false

Multiple tags and resource groups can be defined, separated by a comma. Tags should be provided as a key-value pair separated by :. In order to make configuration easier, it is possible to define which tags and resource groups you want to include in discovery or exclude from discovery. In case of defining tag or resource group in both lists (include and exclude), exclude list has higher priority. If there is no need for services filtering, the configuration should not be defined. It’s not mandatory to define all values in order to enable filtering.

To include services by tags into discovery use folowing configuration:

com.instana.plugin.azure.rediscache:
    include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

To exclude services by tags from discovery use folowing configuration:

com.instana.plugin.azure.rediscache:
    exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

To include services by resource groups into discovery use folowing configuration:

com.instana.plugin.azure.rediscache:
    include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)

To exclude services by resource groups from discovery use folowing configuration:

com.instana.plugin.azure.rediscache:
    exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)

Discovery filtering can be configured on the global level for all Azure services. In case of defining filters for Azure Redis Cache service, global filters will be overridden. For more details about global Azure service discovery filtering visit Azure Configuration.

Note

Metrics for Redis are pulled every minute, which is the resolution Azure provides for monitoring of these services.