Merge pull request #291443 from MicrosoftDocs/main

12/4/2024 PM Publish

Author: Taojunshen

.openpublishing.redirection.json

@@ -1,5 +1,30 @@
 {
   "redirections": [
+    {
+      "source_path": "articles/partner-solutions/split-experimentation/create.md",
+      "redirect_url": "/previous-versions/azure/partner-solutions/split-experimentation/create",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/partner-solutions/split-experimentation/how-to-set-up-data-access.md",
+      "redirect_url": "/previous-versions/azure/partner-solutions/split-experimentation/how-to-set-up-data-access",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/partner-solutions/split-experimentation/manage.md",
+      "redirect_url": "/previous-versions/azure/partner-solutions/split-experimentation/manage",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/partner-solutions/split-experimentation/overview.md",
+      "redirect_url": "/previous-versions/azure/partner-solutions/split-experimentation/overview",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/partner-solutions/split-experimentation/troubleshoot.md",
+      "redirect_url": "/previous-versions/azure/partner-solutions/split-experimentation/troubleshoot",
+      "redirect_document_id": false
+    },
      {
       "source_path": "articles/virtual-desktop/virtual-desktop-fall-2019/classic-retirement.md",
       "redirect_url": "/previous-versions/azure/virtual-desktop-classic/classic-retirement",
@@ -3986,4 +4011,4 @@
       "redirect_document_id": false
     }
   ]
-}
+}

articles/api-management/api-management-howto-app-insights.md

@@ -293,14 +293,14 @@ If you are configuring the logger for a workspace, create a `Microsoft.ApiManage
 Use the following steps to enable Application Insights logging for an API. You can also enable Application Insights logging for all APIs.
 
 1. Navigate to your **Azure API Management service instance** in the **Azure portal**.
-1. Select **APIs** from the menu on the left.
-1. Click on your API, in this case **Demo Conference API**. If configured, select a version.
+1. Select **APIs** > **APIs** from the menu on the left.
+1. Select an API, such as **Swagger Petstore**. If configured, select a version.
 
    > [!TIP]
    > To enable logging for all APIs, select **All APIs**.
 1. Go to the **Settings** tab from the top bar.
 1. Scroll down to the **Diagnostics Logs** section.  
-    :::image type="content" source="media/api-management-howto-app-insights/apim-app-insights-api-1.png" alt-text="App Insights logger":::
+    :::image type="content" source="media/api-management-howto-app-insights/apim-app-insights-api-1.png" alt-text="Screenshot of Diagnostic Logs configuration in the portal.":::
 1. Check the **Enable** box.
 1. Select your attached logger in the **Destination** dropdown.
 1. Input **100** as **Sampling (%)** and select the **Always log errors** checkbox.

articles/api-management/api-management-howto-cache.md

@@ -1,11 +1,9 @@
 ---
-title: Add caching to improve performance in Azure API Management | Microsoft Docs
+title: Add caching to improve performance in Azure API Management
 description: Learn how to improve the latency, bandwidth consumption, and web service load for API Management service calls.
 author: dlepow
-manager: erikre
-ms.assetid: 740f6a27-8323-474d-ade2-828ae0c75e7a
 ms.service: azure-api-management
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 03/20/2024
 ms.author: danlep
 ---
@@ -42,52 +40,53 @@ To complete this tutorial:
 + [Create an Azure API Management instance](get-started-create-service-instance.md)
 + [Import and publish an API](import-and-publish.md)
 
-## <a name="caching-policies"> </a>Add the caching policies
+## Add the caching policies
 
-With caching policies shown in this example, the first request to the **GetSpeakers** operation returns a response from the backend service. This response is cached, keyed by the specified headers and query string parameters. Subsequent calls to the operation, with matching parameters, will have the cached response returned, until the cache duration interval has expired.
+With caching policies shown in this example, the first request to a test operation returns a response from the backend service. This response is cached, keyed by the specified headers and query string parameters. Subsequent calls to the operation, with matching parameters, will have the cached response returned, until the cache duration interval has expired.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-2. Browse to your APIM instance.
-3. Select the **API** tab.
-4. Click **Demo Conference API** from your API list.
-5. Select **GetSpeakers**.
-6. On the top of the screen, select **Design** tab.
-7. In the **Inbound processing** section, click the **</>** icon.
+1. Browse to your API Management instance.
+1. Select **APIs** > **APIs** from the menu on the left.
+1. Select an API for which you want to configure caching.
+1. On the top of the screen, select **Design** tab.
+1. In the **Inbound processing** section, select the **</>** icon.
+    :::image type="content" source="media/api-management-howto-cache/code-editor.png" alt-text="Screenshot of the API Management policy editor in the portal.":::
 
-    ![code editor](media/api-management-howto-cache/code-editor.png)
+8. In the `inbound` element, add the following policy:
 
-8. In the **inbound** element, add the following policy:
-
-   ```
+   ```xml
    <cache-lookup vary-by-developer="false" vary-by-developer-groups="false">
        <vary-by-header>Accept</vary-by-header>
        <vary-by-header>Accept-Charset</vary-by-header>
        <vary-by-header>Authorization</vary-by-header>
    </cache-lookup>
    ```
 
-9. In the **outbound** element, add the following policy:
+9. In the `outbound` element, add the following policy:
 
-   ```
+   ```xml
    <cache-store duration="20" />
    ```
 
-    **Duration** specifies the expiration interval of the cached responses. In this example, the interval is **20** seconds.
+    In this policy, **duration** specifies the expiration interval of the cached responses. In this example, the interval is **20** seconds.
 
 > [!TIP]
 > If you are using an external cache, as described in [Use an external Azure Cache for Redis in Azure API Management](api-management-howto-cache-external.md), you may want to specify the `caching-type` attribute of the caching policies. See [API Management caching policies](api-management-policies.md#caching) for more details.
 
-## <a name="test-operation"> </a>Call an operation and test the caching
-To see the caching in action, call the operation from the developer portal.
+## Call an operation and test the caching
+To see the caching in action, call an operation from the portal.
 
-1. In the Azure portal, browse to your APIM instance.
-2. Select the **APIs** tab.
-3. Select the API to which you added caching policies.
-4. Select the **GetSpeakers** operation.
-5. Click the **Test** tab in the top right menu.
-6. Press **Send**.
+1. In the Azure portal, browse to your API Management instance.
+1. Select **APIs** > **APIs** from the menu on the left.
+1. Select the API to which you added caching policies.
+1. Select an operation to test.
+1. Select the **Test** tab in the top right menu.
+1. Select **Trace** two or three times in quick succession.
+1. Under **HTTP response**, select the **Trace** tab.
+1. Jump to the **Inbound** section and scroll to the `cache-lookup` policy. You should see a message similar to the one in the following screenshot, indicating a cache hit:
+    :::image type="content" source="media/api-management-howto-cache/test-api-cache-lookup.png" alt-text="Screenshot of cache-lookup when testing an API in the portal.":::
 
-## <a name="next-steps"> </a>Next steps
+## Related content
 * For more information about caching policies, see [Caching policies][Caching policies] in the [API Management policy reference][API Management policy reference].
 * For information on caching items by key using policy expressions, see [Custom caching in Azure API Management](api-management-sample-cache-by-key.md).
 * For more information about using external Azure Cache for Redis, see [Use an external Azure Cache for Redis in Azure API Management](api-management-howto-cache-external.md).
@@ -116,7 +115,4 @@ To see the caching in action, call the operation from the developer portal.
 
 [Create an API Management service instance]: get-started-create-service-instance.md
 
-[Configure an operation for caching]: #configure-caching
-[Review the caching policies]: #caching-policies
-[Call an operation and test the caching]: #test-operation
-[Next steps]: #next-steps
+