Skip to content

Commit c3fff68

Browse files
Merge pull request #91634 from yegu-ms/master
Updated Import and Export screenshots
2 parents f12d706 + 969d055 commit c3fff68

25 files changed

+508
-340
lines changed

articles/azure-cache-for-redis/TOC.yml

Lines changed: 29 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -28,19 +28,17 @@
2828
- name: Azure Cache for Redis samples
2929
href: cache-redis-samples.md
3030
- name: Azure PowerShell
31-
href: cache-howto-manage-redis-cache-powershell.md
31+
href: cache-how-to-manage-redis-cache-powershell.md
3232
- name: Azure CLI
3333
href: cli-samples.md
3434
- name: Concepts
3535
items:
36-
- name: Best Practices
37-
items:
38-
- name: Best Practices for Azure Cache for Redis
39-
href: cache-best-practices.md
40-
- name: Azure Architecture Best Practices for Caching
41-
href: https://docs.microsoft.com/azure/architecture/best-practices/caching?toc=%2Fazure%2Fredis-cache%2Ftoc.json
42-
- name: Failover and patching explained
36+
- name: Best practices
37+
href: cache-best-practices.md
38+
- name: Failover and patching
4339
href: cache-failover.md
40+
- name: Architecture best practices for caching
41+
href: https://docs.microsoft.com/azure/architecture/best-practices/caching?toc=%2Fazure%2Fredis-cache%2Ftoc.json
4442
- name: How-to guides
4543
items:
4644
- name: Plan
@@ -58,19 +56,25 @@
5856
- name: Automate
5957
items:
6058
- name: Deploy and manage using Azure Powershell
61-
href: cache-howto-manage-redis-cache-powershell.md
59+
href: cache-how-to-manage-redis-cache-powershell.md
6260
- name: Deploy and Manage using Azure CLI
6361
href: cli-samples.md
6462
- name: Provision an Azure Cache for Redis
6563
href: cache-redis-cache-arm-provision.md
6664
- name: Provision a Web App with Azure Cache for Redis
6765
href: cache-web-app-arm-with-redis-cache-provision.md
68-
- name: Integrate with ASP.NET
66+
- name: Integrate with application
6967
items:
70-
- name: Session state provider
71-
href: cache-aspnet-session-state-provider.md
72-
- name: Output cache provider
73-
href: cache-aspnet-output-cache-provider.md
68+
- name: ASP.NET
69+
items:
70+
- name: Use session state provider
71+
href: cache-aspnet-session-state-provider.md
72+
- name: Use output cache provider
73+
href: cache-aspnet-output-cache-provider.md
74+
- name: Java Spring
75+
items:
76+
- name: Use Spring Boot Initializer
77+
href: cache-java-spring-boot-initializer-with-redis-cache.md
7478
- name: Manage
7579
items:
7680
- name: Configure in Azure portal
@@ -85,24 +89,28 @@
8589
href: cache-administration.md#schedule-updates
8690
- name: Configure redis-cli.exe access
8791
href: cache-how-to-redis-cli-tool.md
88-
- name: Monitor and troubleshoot
92+
- name: Monitor
8993
items:
9094
- name: Monitor in Azure portal
9195
href: cache-how-to-monitor.md
92-
- name: Troubleshoot cache issues
93-
href: cache-how-to-troubleshoot.md
9496
- name: Set alerts for exceptions
9597
href: cache-how-to-monitor.md#operations-and-alerts
98+
- name: Diagnose and troubleshoot
99+
items:
100+
- name: Troubleshoot Redis server
101+
href: cache-how-to-troubleshoot-server.md
102+
- name: Troubleshoot Redis client
103+
href: cache-how-to-troubleshoot-client.md
104+
- name: Troubleshoot timeouts
105+
href: cache-how-to-troubleshoot-timeouts.md
106+
- name: Troubleshoot data loss
107+
href: cache-how-to-troubleshoot-data-loss.md
96108
- name: Scale
97109
items:
98110
- name: Update to a different size and tier
99111
href: cache-how-to-scale.md
100112
- name: Use Redis cluster to scale in/out
101113
href: cache-how-to-premium-clustering.md
102-
- name: Integrate with Spring Boot
103-
items:
104-
- name: Use a Spring Boot Initializer app with Azure Cache for Redis
105-
href: cache-java-spring-boot-initializer-with-redis-cache.md
106114
- name: Reference
107115
items:
108116
- name: Code samples

articles/azure-cache-for-redis/cache-administration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ If you reboot both the **Master** and **Slave** nodes, all data in the cache (or
6767
If you reboot just one of the nodes, data is not typically lost, but it still may be. For example if the master node is rebooted and a cache write is in progress, the data from the cache write is lost. Another scenario for data loss would be if you reboot one node and the other node happens to go down due to a failure at the same time. For more information about possible causes for data loss, see [What happened to my data in Redis?](https://gist.github.com/JonCole/b6354d92a2d51c141490f10142884ea4#file-whathappenedtomydatainredis-md)
6868

6969
### Can I reboot my cache using PowerShell, CLI, or other management tools?
70-
Yes, for PowerShell instructions see [To reboot an Azure Cache for Redis](cache-howto-manage-redis-cache-powershell.md#to-reboot-an-azure-cache-for-redis).
70+
Yes, for PowerShell instructions see [To reboot an Azure Cache for Redis](cache-how-to-manage-redis-cache-powershell.md#to-reboot-an-azure-cache-for-redis).
7171

7272
## Schedule updates
7373
The **Schedule updates** blade allows you to designate a maintenance window for your cache instance. When the maintenance window is specified, any Redis server updates are made during this window.

articles/azure-cache-for-redis/cache-best-practices.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,9 @@ By following these best practices, you can help maximize the performance and cos
2727

2828
* **Develop your system such that it can handle connection blips** [because of patching and failover](https://gist.github.com/JonCole/317fe03805d5802e31cfa37e646e419d#file-azureredis-patchingexplained-md).
2929

30-
* **Configure your [maxmemory-reserved setting](cache-configure.md#maxmemory-policy-and-maxmemory-reserved) to improve system responsiveness** under memory pressure conditions. This setting is especially important for write-heavy workloads or if you're storing larger values (100 KB or more) in Redis. I would recommend starting with 10% of the size of your cache, then increase if you have write-heavy loads. See [some considerations](cache-how-to-troubleshoot.md#considerations-for-memory-reservations) when selecting a value.
30+
* **Configure your [maxmemory-reserved setting](cache-configure.md#maxmemory-policy-and-maxmemory-reserved) to improve system responsiveness** under memory pressure conditions. This setting is especially important for write-heavy workloads or if you're storing larger values (100 KB or more) in Redis. It's recommended that you start with 10% of the size of your cache and then increase the percentage if you have write-heavy loads.
3131

32-
* **Redis works best with smaller values**, so consider chopping up bigger data into multiple keys. In [this Redis discussion](https://stackoverflow.com/questions/55517224/what-is-the-ideal-value-size-range-for-redis-is-100kb-too-large/), some considerations are listed that you should consider carefully. Read [this article](cache-how-to-troubleshoot.md#large-requestresponse-size) for an example problem that can be caused by large values.
32+
* **Redis works best with smaller values**, so consider chopping up bigger data into multiple keys. In [this Redis discussion](https://stackoverflow.com/questions/55517224/what-is-the-ideal-value-size-range-for-redis-is-100kb-too-large/), some considerations are listed that you should consider carefully. Read [this article](cache-how-to-troubleshoot-client.md#large-request-or-response-size) for an example problem that can be caused by large values.
3333

3434
* **Locate your cache instance and your application in the same region.** Connecting to a cache in a different region can significantly increase latency and reduce reliability. While you can connect from outside of Azure, it not recommended *especially when using Redis as a cache*. If you're using Redis as just a key/value store, latency may not be the primary concern.
3535

@@ -39,7 +39,7 @@ By following these best practices, you can help maximize the performance and cos
3939
> [!NOTE]
4040
> This guidance is specific to the *connection attempt* and not related to the time you're willing to wait for an *operation* like GET or SET to complete.
4141
42-
* **Avoid expensive commands** - Some redis operations, like the [KEYS command](https://redis.io/commands/keys), are *very* expensive and should be avoided. For more information, see [some considerations around expensive commands](cache-how-to-troubleshoot.md#expensive-commands)
42+
* **Avoid expensive operations** - Some Redis operations, like the [KEYS](https://redis.io/commands/keys) command, are *very* expensive and should be avoided. For more information, see some considerations around [long-running commands](cache-how-to-troubleshoot-server.md#long-running-commands)
4343

4444
* **Use TLS encryption** - Azure Cache for Redis requires TLS encrypted communications by default. TLS versions 1.0, 1.1 and 1.2 are currently supported. However, TLS 1.0 and 1.1 are on a path to deprecation industry-wide, so use TLS 1.2 if at all possible. If your client library or tool doesn't support TLS, then enabling unencrypted connections can be done [through the Azure portal](cache-configure.md#access-ports) or [management APIs](https://docs.microsoft.com/rest/api/redis/redis/update). In such cases where encrypted connections aren't possible, placing your cache and client application into a virtual network would be recommended. For details on which ports are used for
4545

articles/azure-cache-for-redis/cache-configure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -426,7 +426,7 @@ New Azure Cache for Redis instances are configured with the following default Re
426426
For more information about databases, see [What are Redis databases?](cache-faq.md#what-are-redis-databases)
427427

428428
> [!NOTE]
429-
> The `databases` setting can be configured only during cache creation and only using PowerShell, CLI, or other management clients. For an example of configuring `databases` during cache creation using PowerShell, see [New-AzRedisCache](cache-howto-manage-redis-cache-powershell.md#databases).
429+
> The `databases` setting can be configured only during cache creation and only using PowerShell, CLI, or other management clients. For an example of configuring `databases` during cache creation using PowerShell, see [New-AzRedisCache](cache-how-to-manage-redis-cache-powershell.md#databases).
430430
>
431431
>
432432

articles/azure-cache-for-redis/cache-dotnet-core-quickstart.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ ms.custom: mvc
2020
---
2121
# Quickstart: Use Azure Cache for Redis with a .NET Core app
2222

23-
In this quickstart, you incorporate Azure Cache for Redis into a .NET Core app to have access to a secure, dedicated cache that is accessible from any application within Azure. You specifically use the [StackExchange.Redis](https://github.com/StackExchange/StackExchange.Redis) client with C# code in a .NET Core console app.
23+
In this quickstart, you incorporate Azure Cache for Redis into a .NET Core app to have access to a secure, dedicated cache that is accessible from any application within Azure. You specifically use the [StackExchange.Redis](https://github.com/StackExchange/StackExchange.Redis) client with C# code in a .NET Core console app.
2424

2525
## Prerequisites
2626

articles/azure-cache-for-redis/cache-faq.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ The following FAQs cover basic concepts and questions about Azure Cache for Redi
6969
* [Performance considerations around connections](#performance-considerations-around-connections)
7070

7171
## Monitoring and troubleshooting FAQs
72-
The FAQs in this section cover common monitoring and troubleshooting questions. For more information about monitoring and troubleshooting your Azure Cache for Redis instances, see [How to monitor Azure Cache for Redis](cache-how-to-monitor.md) and [How to troubleshoot Azure Cache for Redis](cache-how-to-troubleshoot.md).
72+
The FAQs in this section cover common monitoring and troubleshooting questions. For more information about monitoring and troubleshooting your Azure Cache for Redis instances, see [How to monitor Azure Cache for Redis](cache-how-to-monitor.md) and the various troubleshoot guides.
7373

7474
* [How do I monitor the health and performance of my cache?](#how-do-i-monitor-the-health-and-performance-of-my-cache)
7575
* [Why am I seeing timeouts?](#why-am-i-seeing-timeouts)
@@ -174,7 +174,7 @@ For more information on considerations when using Azure Cache for Redis with oth
174174
- [Azure China 21Vianet Cloud - Azure Cache for Redis](https://www.azure.cn/home/features/redis-cache/)
175175
- [Microsoft Azure Germany](https://azure.microsoft.com/overview/clouds/germany/)
176176

177-
For information on using Azure Cache for Redis with PowerShell in Azure Government Cloud, Azure China 21Vianet Cloud, and Microsoft Azure Germany, see [How to connect to other clouds - Azure Cache for Redis PowerShell](cache-howto-manage-redis-cache-powershell.md#how-to-connect-to-other-clouds).
177+
For information on using Azure Cache for Redis with PowerShell in Azure Government Cloud, Azure China 21Vianet Cloud, and Microsoft Azure Germany, see [How to connect to other clouds - Azure Cache for Redis PowerShell](cache-how-to-manage-redis-cache-powershell.md#how-to-connect-to-other-clouds).
178178

179179
<a name="cache-configuration"></a>
180180

@@ -193,6 +193,7 @@ Usually the default values of the client are sufficient. You can fine-tune the o
193193
* For ConnectRetry and ConnectTimeout, the general guidance is to fail fast and retry again. This guidance is based on your workload and how much time on average it takes for your client to issue a Redis command and receive a response.
194194
* Let StackExchange.Redis automatically reconnect instead of checking connection status and reconnecting yourself. **Avoid using the ConnectionMultiplexer.IsConnected property**.
195195
* Snowballing - sometimes you may run into an issue where you are retrying and the retries snowball and never recovers. If snowballing occurs, you should consider using an exponential backoff retry algorithm as described in [Retry general guidance](../best-practices-retry-general.md) published by the Microsoft Patterns & Practices group.
196+
196197
* **Timeout values**
197198
* Consider your workload and set the values accordingly. If you are storing large values, set the timeout to a higher value.
198199
* Set `AbortOnConnectFail` to false and let StackExchange.Redis reconnect for you.
@@ -439,7 +440,7 @@ These tools enable you to monitor the health of your Azure Cache for Redis insta
439440
<a name="cache-timeouts"></a>
440441

441442
### Why am I seeing timeouts?
442-
Timeouts happen in the client that you use to talk to Redis. When a command is sent to the Redis server, the command is queued up and Redis server eventually picks up the command and executes it. However the client can time out during this process and if it does an exception is raised on the calling side. For more information on troubleshooting timeout issues, see [Client-side troubleshooting](cache-how-to-troubleshoot.md#client-side-troubleshooting) and [StackExchange.Redis timeout exceptions](cache-how-to-troubleshoot.md#stackexchangeredis-timeout-exceptions).
443+
Timeouts happen in the client that you use to talk to Redis. When a command is sent to the Redis server, the command is queued up and Redis server eventually picks up the command and executes it. However the client can time out during this process and if it does an exception is raised on the calling side. For more information on troubleshooting timeout issues, see [client-side troubleshooting](cache-how-to-troubleshoot-client.md) and [StackExchange.Redis timeout exceptions](cache-how-to-troubleshoot-timeouts.md#stackexchangeredis-timeout-exceptions).
443444

444445
<a name="cache-disconnect"></a>
445446

0 commit comments

Comments
 (0)