1---
2name: azure-cache-redis
3description: Expert knowledge for Azure Cache for Redis development including troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, and deployment. Use when configuring geo-replication, persistence, VNet/private endpoints, Entra/RBAC auth, or ARM/Bicep deployments, and other Azure Cache for Redis related development tasks. Not for Azure Managed Redis (use azure-managed-redis), Azure Cosmos DB (use azure-cosmos-db), Azure Table Storage (use azure-table-storage).
4compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
5metadata:
6 generated_at: "2026-08-31"
7 generator: "docs2skills/1.0.0"
8---
9
10# Azure Cache for Redis Skill
11
12This skill provides expert guidance for Azure Cache for Redis. Covers troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
13
14## How to Use This Skill
15
16> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file
17
18> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)
19
20This skill requires **network access** to fetch documentation content:
21- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
22- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.
23
24## Category Index
25
26| Category | Lines | Description |
27|----------|-------|-------------|
28| Troubleshooting | L35-L43 | Diagnosing and fixing Azure Cache for Redis issues: client/server errors, connectivity, data loss, latency, and timeouts, plus targeted troubleshooting steps. |
29| Best Practices | L44-L58 | Best practices for client usage, reliability, scaling, memory, performance testing, monitoring, failover behavior, and Kubernetes/Enterprise tier usage in Azure Cache for Redis |
30| Decision Making | L59-L68 | Guidance on sizing and tier selection, cost reservations, network isolation options, and planning/migrating Redis caches, including retirement and Private Link migrations. |
31| Architecture & Design Patterns | L69-L73 | Strategies for architecting highly available Redis caches on Azure, including redundancy, failover, disaster recovery, and SLA-focused design patterns. |
32| Security | L74-L86 | Securing Azure Cache for Redis: Entra auth/RBAC, TLS config, disk encryption, private endpoints/VNet, managed identities, and Azure Policy compliance settings. |
33| Configuration | L87-L106 | Configuring and operating Azure Cache for Redis: server settings, geo-replication, persistence, zone redundancy, monitoring/logging, CLI/PowerShell management, and data import/export. |
34| Deployment | L107-L114 | Scaling, upgrading, and region-moving Redis caches, plus deploying them via ARM/Bicep templates and managing tier/version/region changes. |
35
36### Troubleshooting
37| Topic | URL |
38|-------|-----|
39| Access client-specific troubleshooting for Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-client |
40| Troubleshoot connectivity issues with Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-connectivity |
41| Diagnose and fix data loss in Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-data-loss |
42| Access server-side troubleshooting for Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-server |
43| Resolve latency and timeout problems in Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-timeouts |
44
45### Best Practices
46| Topic | URL |
47|-------|-----|
48| Use Redis client libraries effectively with Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-client-libraries |
49| Improve Azure Redis connection resilience and reliability | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-connection |
50| Implement development patterns for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-development |
51| Use Azure Redis Enterprise and Flash tiers effectively | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-enterprise-tiers |
52| Run Kubernetes client apps against Azure Redis reliably | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-kubernetes |
53| Optimize memory management for Azure Redis caches | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-memory-management |
54| Conduct performance testing for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-performance |
55| Apply scaling best practices for Azure Redis caches | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-scale |
56| Monitor CPU utilization and server load for Azure Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-best-practices-server-load |
57| Apply development best practices for Azure Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-development-faq |
58| Understand failover and patching behavior in Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-failover |
59
60### Decision Making
61| Topic | URL |
62|-------|-----|
63| Plan and execute migrations to Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-migration-guide |
64| Choose Azure Redis network isolation options | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-network-isolation |
65| Plan Azure Cache for Redis capacity and tiers | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-planning-faq |
66| Choose and manage Azure Redis reservations for cost | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-reserved-pricing |
67| Migrate Azure Redis VNet caches to Private Link | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-vnet-migration |
68| Plan migration for Azure Cache for Redis retirement | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/retirement-faq |
69
70### Architecture & Design Patterns
71| Topic | URL |
72|-------|-----|
73| Design high availability strategies for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-high-availability |
74
75### Security
76| Topic | URL |
77|-------|-----|
78| Configure Microsoft Entra authentication for Azure Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-azure-active-directory-for-authentication |
79| Define Redis data access policies and RBAC via Entra | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-configure-role-based-access-control |
80| Configure disk encryption for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-encryption |
81| Configure Premium Azure Redis with virtual networks | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-premium-vnet |
82| Use managed identities with Azure Redis and storage | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-managed-identity |
83| Configure Azure Private Link for Redis caches | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-private-link |
84| Remove TLS 1.0/1.1 and enforce TLS 1.2 for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-remove-tls-10-11 |
85| Configure TLS settings for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-tls-configuration |
86| Use built-in Azure Policy definitions for Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/policy-reference |
87
88### Configuration
89| Topic | URL |
90|-------|-----|
91| Administer Azure Cache for Redis reboots and updates | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-administration |
92| Configure Azure Cache for Redis server settings | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-configure |
93| Configure Event Grid integration for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-event-grid |
94| Configure active geo-replication for Enterprise Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-active-geo-replication |
95| Configure passive geo-replication for Premium Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-geo-replication |
96| Import and export Azure Redis data via Blob storage | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-import-export-data |
97| Add and manage replicas in Premium Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-multi-replicas |
98| Configure data persistence for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-premium-persistence |
99| Enable zone redundancy for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-zone-redundancy |
100| Use Azure Monitor insights for Redis performance | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-insights-overview |
101| Configure diagnostic settings for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-monitor-diagnostic-settings |
102| Use Azure CLI scripts to manage Redis caches | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cli-samples |
103| Administer Azure Cache for Redis via PowerShell | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/how-to-manage-redis-cache-powershell |
104| Reference monitoring metrics and logs for Azure Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/monitor-cache-reference |
105| Create and manage Redis caches with Azure CLI | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/scripts/create-manage-cache |
106| Provision clustered Premium Redis via Azure CLI | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/scripts/create-manage-premium-cache-cluster |
107
108### Deployment
109| Topic | URL |
110|-------|-----|
111| Scale Azure Cache for Redis instances across tiers | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-scale |
112| Upgrade Azure Cache for Redis server versions | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-upgrade |
113| Move Azure Cache for Redis across Azure regions | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-moving-resources |
114| Deploy Azure Cache for Redis with ARM templates | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/redis-cache-arm-provision |
115| Deploy Azure Cache for Redis using Bicep templates | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/redis-cache-bicep-provision |
microsoftdocs