Merge pull request #283290 from dlepow/281930

[APIM] Analytics updates

Author: v-dirichards

articles/api-management/breaking-changes/analytics-dashboard-retirement-march-2027.md

@@ -1,11 +1,11 @@
 ---
 title: Azure API Management - Analytics dashboard retirement (March 2027)
-description: Azure API Management is replacing the built-in API analytics dashboard as of March 2027. An equivalent dashboard is available based on an Azure Monitor Workbook.
+description: Azure API Management is replacing the built-in API analytics dashboard as of March 2027. A similar Azure Monitor-based dashboard is available.
 services: api-management
 author: dlepow
 ms.service: azure-api-management
 ms.topic: reference
-ms.date: 05/16/2024
+ms.date: 08/05/2024
 ms.author: danlep
 ---
 
@@ -17,14 +17,14 @@ Effective 15 March 2027, the dashboard and reports associated with API Managemen
 
 ## Is my service affected by this?
 
-The Premium, Standard, Basic, and Developer tiers of API Management provide a [built-in analytics dashboard](../howto-use-analytics.md#legacy-built-in-analytics) and reports ("legacy built-in analytics") for each API Management instance. As of early 2024, API Management also provides identical API analytics using an [Azure Monitor-based dashboard](../howto-use-analytics.md#azure-monitor-based-dashboard) that aggregates data in an Azure Log Analytics workspace. The Azure Monitor-based dashboard is now the recommended solution for viewing API Management analytics data in the portal.
+The Premium, Standard, Basic, and Developer tiers of API Management provide a [built-in analytics dashboard](../howto-use-analytics.md#legacy-built-in-analytics) and reports ("legacy built-in analytics" or "classic built-in analytics") for each API Management instance. As of early 2024, API Management also provides closely similar API analytics using an [Azure Monitor-based dashboard](../howto-use-analytics.md#azure-monitor-based-dashboard) that aggregates data in an Azure Log Analytics workspace. The Azure Monitor-based dashboard is now the recommended solution for viewing API Management analytics data in the portal.
 
 ## What is the deadline for the change?
 After 15 March 2027, the legacy built-in analytics will not be supported. Both the legacy built-in analytics and Azure Monitor-based analytics will be available in parallel for a period of time to allow for a smooth transition to the Azure Monitor-based implementation.
 
 ## What do I need to do?
 
-From now through 15 March 2027, you will have access to both implementations in the Azure portal, featuring identical dashboards and reports. We recommend that you start using the Azure Monitor-based dashboard to view your API Management analytics data. To use the Azure Monitor-based dashboard, configure a Log Analytics workspace as a data source for API Management gateway logs. For more information, see [Tutorial: Monitor published APIs](../api-management-howto-use-azure-monitor.md).
+From now through 15 March 2027, you will have access to both implementations in the Azure portal, featuring closely similar dashboards and reports. We recommend that you start using the Azure Monitor-based dashboard to view your API Management analytics data. To use the Azure Monitor-based dashboard, configure a Log Analytics workspace as a data source for API Management gateway logs. For more information, see [Tutorial: Monitor published APIs](../api-management-howto-use-azure-monitor.md).
 
 When an option to do so becomes available, we recommend disabling the legacy analytics dashboard to improve the capacity performance of your API Management instance. We recommend pursuing this change proactively before the retirement date.
 

articles/api-management/howto-use-analytics.md

@@ -1,11 +1,11 @@
 ---
 title: Use API analytics in Azure API Management | Microsoft Docs
-description: Use analytics in Azure API Management to understand and categorize the usage of your APIs and API performance. Analytics is provided using an Azure workbook.
+description: Use analytics in Azure API Management to understand and categorize the usage of APIs and API performance. Analytics uses an Azure Monitor-based dashboard.
 author: dlepow
 
 ms.service: azure-api-management
 ms.topic: article
-ms.date: 03/26/2024
+ms.date: 08/05/2024
 ms.author: danlep
 ---
 
@@ -23,11 +23,11 @@ Azure API Management provides analytics for your APIs so that you can analyze th
 
 * API Management provides analytics using an [Azure Monitor-based dashboard](../azure-monitor/visualize/workbooks-overview.md). The dashboard aggregates data in an Azure Log Analytics workspace. 
 
-* In the classic API Management service tiers, your API Management instance also includes legacy *built-in analytics* in the Azure portal, and analytics data can be accessed using the API Management REST API. Equivalent data is shown in the Azure Monitor-based dashboard and built-in analytics.
+* In the classic API Management service tiers, your API Management instance also includes *legacy built-in analytics* in the Azure portal, and analytics data can be accessed using the API Management REST API. Closely similar data is shown in the Azure Monitor-based dashboard and built-in analytics.
 
 > [!IMPORTANT]
 > * The Azure Monitor-based dashboard is the recommended way to access analytics data.
-> * Legacy built-in analytics isn't available in the v2 tiers. 
+> * Built-in (classic) analytics isn't available in the v2 tiers. 
 
 With API analytics, analyze the usage and performance of the APIs in your API Management instance across several dimensions, including:
 
@@ -47,7 +47,7 @@ With API analytics, analyze the usage and performance of the APIs in your API Ma
 
 ## Azure Monitor-based dashboard
 
-To use the Azure Monitor-based dashboard, you need to configure a Log Analytics workspace as a data source for API Management gateway logs. 
+To use the Azure Monitor-based dashboard, you need a Log Analytics workspace as a data source for API Management gateway logs. 
 
 If you need to configure one, the following are brief steps to send gateway logs to a Log Analytics workspace. For more information, see [Tutorial: Monitor published APIs](api-management-howto-use-azure-monitor.md#resource-logs). This is a one-time setup.
 
@@ -63,23 +63,23 @@ If you need to configure one, the following are brief steps to send gateway logs
 After a Log Analytics workspace is configured, access the Azure Monitor-based dashboard to analyze the usage and performance of your APIs.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
-1. In the left-hand menu, under **Monitoring**, select **Insights**. The analytics dashboard opens.
+1. In the left-hand menu, under **Monitoring**, select **Analytics**. The analytics dashboard opens.
 1. Select a time range for data.
 1. Select a report category for analytics data, such as **Timeline**, **Geography**, and so on.
 
 ## Legacy built-in analytics
 
-In certain API Management service tiers, built-in analytics is also available in the Azure portal, and analytics data can be accessed using the API Management REST API. 
+In certain API Management service tiers, built-in analytics (also called *legacy analytics* or *classic analytics*) is also available in the Azure portal, and analytics data can be accessed using the API Management REST API. 
 
 ### Built-in analytics - portal
 
-To access the built-in analytics in the Azure portal:
+To access the built-in (classic) analytics in the Azure portal:
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance. 
-1. In the left-hand menu, under **Monitoring**, select **Analytics**. 
+1. In the left-hand menu, under **Monitoring**, select **Analytics (classic)**. 
 1. Select a time range for data, or enter a custom time range.
 1. Select a report category for analytics data, such as **Timeline**, **Geography**, and so on.
-1. Optionally, filter the report by one or more additional categories.
+1. Optionally, filter the report by one or more other categories.
 
 ### Analytics - REST API
 
@@ -91,4 +91,5 @@ Available operations return report records by API, geography, API operations, pr
 
 * For an introduction to Azure Monitor features in API Management, see [Tutorial: Monitor published APIs](api-management-howto-use-azure-monitor.md)
 * For detailed HTTP logging and monitoring, see [Monitor your APIs with Azure API Management, Event Hubs, and Moesif](api-management-log-to-eventhub-sample.md).
-* Learn about integrating [Azure API Management with Azure Application Insights](api-management-howto-app-insights.md).
+* Learn about integrating [Azure API Management with Azure Application Insights](api-management-howto-app-insights.md).
+* Learn about [Built-in API analytics dashboard retirement (March 2027)](breaking-changes/analytics-dashboard-retirement-march-2027.md)