About azure-managed-redis
A reference skill for agents working with Azure Managed Redis, covering troubleshooting, architecture, security, configuration, and migration. It pairs local quick-reference material with remote documentation retrieval for client integration, operations, and deployment.
Key features
- 01Diagnose connectivity, latency, and data issues
- 02Guidance on capacity, clustering, and migration
- 03Authentication and encryption configuration
- 04Monitoring and instance management references
- 05Local references plus remote document retrieval
Use cases
- 01Investigate Redis client or server timeouts
- 02Plan tiers, capacity, and migration
- 03Configure persistence, monitoring, and access controls
MCP support
The skill recommends retrieving online documentation with mcp_microsoftdocs:microsoft_docs_fetch, with fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-managed-redisAfter installing, type/azure-managed-redisin Claude Code to confirm it loaded.
Details
From the project READMEAzure Managed Redis Skill
This skill provides expert guidance for Azure Managed Redis. Covers troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L36-L46 | Diagnosing and fixing Redis issues: using diagnostic commands, handling common errors, client and connectivity problems, data loss, server performance, latency, and timeouts. |
| Best Practices | L47-L63 | Best practices for connecting, scaling, monitoring, and optimizing Azure Managed Redis, including memory, performance, resiliency, Kubernetes hosting, and common FAQ patterns. |
| Decision Making | L64-L81 | Guidance on choosing Azure Managed Redis tiers, capacity, clustering, reliability, modules, and planning or executing migrations from legacy Redis and Redis Enterprise, including cost optimization. |
| Architecture & Design Patterns | L82-L86 | Internal design of Azure Managed Redis: cluster topology, sharding, persistence, networking, and how architecture impacts performance, scaling, and reliability. |
| Security | L87-L96 | Securing Azure Managed Redis: ACL-based access, Entra ID auth, disk encryption with CMK, TLS configuration, security best practices, and enforcing compliance via Azure Policy. |
| Configuration | L97-L116 | Configuring Azure Managed Redis instances: settings, scaling, persistence, modules, networking, geo-replication, maintenance, monitoring, alerts, metrics, logs, and admin via CLI/PowerShell. |
| Integrations & Coding Patterns | L117-L130 | Client integration patterns for Azure Managed Redis: language SDKs (.NET, Go, Node, Python), Entra ID auth, ASP.NET caching, data import/export, tools, and semantic routing. |
| Deployment | L131-L139 | Migrating Redis workloads to Azure Managed Redis (self-service, tooling-based, Redis Enterprise) and deploying new instances via ARM templates and Bicep. |
Troubleshooting
| Topic | URL |
|---|---|
| Use Redis diagnostic commands in Azure Managed Redis | https://learn.microsoft.com/en-us/azure/redis/common-redis-commands |
| Monitor and troubleshoot Redis: common error FAQs | https://learn.microsoft.com/en-us/azure/redis/monitor-troubleshoot-faq |
| Troubleshoot Azure Managed Redis client-side issues | https://learn.microsoft.com/en-us/azure/redis/troubleshoot-client |
| Troubleshoot connectivity issues in Azure Managed Redis | https://learn.microsoft.com/en-us/azure/redis/troubleshoot-connectivity |
| Diagnose and resolve data loss in Managed Redis | https://learn.microsoft.com/en-us/azure/redis/troubleshoot-data-loss |
| Diagnose Azure Managed Redis server performance issues | https://learn.microsoft.com/en-us/azure/redis/troubleshoot-server |
| Resolve latency and timeout problems in Managed Redis | https://learn.microsoft.com/en-us/azure/redis/troubleshoot-timeouts |
Best Practices
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Understand Azure Managed Redis internal architecture | https://learn.microsoft.com/en-us/azure/redis/architecture |
Security
| Topic | URL |
|---|---|
| Configure custom Redis ACL-based data access in Azure Managed Redis | https://learn.microsoft.com/en-us/azure/redis/configure-access-permissions |
| Authenticate to Azure Managed Redis using Microsoft Entra ID | https://learn.microsoft.com/en-us/azure/redis/entra-for-authentication |
| Set up disk encryption with customer-managed keys for Azure Managed Redis | https://learn.microsoft.com/en-us/azure/redis/how-to-encryption |
| Apply security best practices to Azure Managed Redis | https://learn.microsoft.com/en-us/azure/redis/secure-azure-managed-redis |
| Apply Azure Policy compliance to Redis caches | https://learn.microsoft.com/en-us/azure/redis/security-controls-policy |
| Configure TLS settings for Azure Managed Redis connections | https://learn.microsoft.com/en-us/azure/redis/tls-configuration |
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Execute self-service migration to Azure Managed Redis | https://learn.microsoft.com/en-us/azure/redis/migrate/migrate-basic-standard-premium-self-service |
| Use Azure migration tooling for Redis tier upgrade | https://learn.microsoft.com/en-us/azure/redis/migrate/migrate-basic-standard-premium-with-tooling |
| Execute migration from Redis Enterprise to Managed Redis | https://learn.microsoft.com/en-us/azure/redis/migrate/migrate-redis-enterprise-self-service |
| Use Azure tooling to migrate Redis Enterprise to Managed Redis | https://learn.microsoft.com/en-us/azure/redis/migrate/migrate-redis-enterprise-with-tooling |
| Provision Azure Managed Redis with ARM templates | https://learn.microsoft.com/en-us/azure/redis/redis-cache-arm-provision |
| Deploy Azure Managed Redis using Bicep | https://learn.microsoft.com/en-us/azure/redis/redis-cache-bicep-provision |