[APIM] LLM logginng

Author: gitName

articles/api-management/TOC.yml

@@ -629,10 +629,6 @@
   - name: Azure Policy built-ins
     displayName: samples, policies, definitions
     href: ./policy-reference.md
-  - name: Gateway log schema
-    href: gateway-log-schema-reference.md
-  - name: Developer portal audit log schema
-    href: developer-portal-audit-log-schema-reference.md
   - name: Event Grid events schema
     href: ../event-grid/event-schema-api-management.md?toc=/azure/api-management/toc.json&bc=/azure/api-management/breadcrumb/toc.json
   - name: Virtual network configuration

articles/api-management/api-management-howto-use-azure-monitor.md

@@ -7,7 +7,7 @@ author: dlepow
 ms.service: azure-api-management
 ms.custom: engagement-fy23, devdivchpfy22
 ms.topic: tutorial
-ms.date: 11/01/2024
+ms.date: 02/24/2025
 ms.author: danlep
 ---
 # Tutorial: Monitor published APIs
@@ -154,55 +154,20 @@ To configure resource logs:
 
 For more information, see [Create diagnostic settings to send platform logs and metrics to different destinations](/azure/azure-monitor/essentials/diagnostic-settings).
  
-## View logs and metrics in Azure Monitor
+## View logs and metrics in Azure Log Analytics
 
-If you enable collection of logs or metrics in a Log Analytics workspace, it can take a few minutes for data to appear in Azure Monitor. 
-
-To view the data:
-
-1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
-1. Select **Logs** from the left menu.
-
-    :::image type="content" source="media/api-management-howto-use-azure-monitor/logs-menu-item.png" alt-text="Screenshot of Logs item in Monitoring menu in the portal.":::
-
-1. Run queries to view the data. Several [sample queries](/azure/azure-monitor/logs/queries) are provided, or run your own. For example, the following query retrieves the most recent 24 hours of data from the ApiManagementGatewayLogs table:
-
-    ```kusto
-    ApiManagementGatewayLogs
-    | where TimeGenerated > ago(1d) 
-    ```
-
-    :::image type="content" source="media/api-management-howto-use-azure-monitor/query-resource-logs.png" alt-text="Screenshot of querying ApiManagementGatewayLogs table in the portal." lightbox="media/api-management-howto-use-azure-monitor/query-resource-logs.png":::
+[!INCLUDE [api-management-log-analytics](../../includes/api-management-log-analytics.md)]
 
 For more information about using resource logs for API Management, see:
 
 * [Log Analytics tutorial](/azure/azure-monitor/logs/log-analytics-tutorial).
 
 * [Overview of log queries in Azure Monitor](/azure/azure-monitor/logs/log-query-overview).
 
-* [API Management resource log schema reference](gateway-log-schema-reference.md). 
-
 ## Modify API logging settings
 
-By default, when you create a diagnostic setting to enable collection of resource logs, logging is enabled for all APIs, with default settings. You can adjust the logging settings for all APIs, or override them for individual APIs. For example, adjust the sampling rate or the verbosity of the data, enable logging of headers or request or response payloads, or disable logging for some APIs.
-
-For details about the logging settings, see [Diagnostic logging settings reference](diagnostic-logs-reference.md).
-
-To configure logging settings for all APIs:
-
-1. In the left menu of your API Management instance, select **APIs** > **APIs** > **All APIs**.
-1. Select the **Settings** tab from the top bar.
-1. Scroll down to the **Diagnostic Logs** section, and select the **Azure Monitor** tab.
-1. Review the settings and make changes if needed. Select **Save**. 
-
-To configure logging settings for a specific API:
-
-1. In the left menu of your API Management instance, select **APIs** > **APIs** and then the name of the API.
-1. Select the **Settings** tab from the top bar.
-1. Scroll down to the **Diagnostic Logs** section, and select the **Azure Monitor** tab.
-1. Review the settings and make changes if needed. Select **Save**. 
+[!INCLUDE [api-management-api-logging](../../includes/api-management-api-logging.md)]
 
-[!INCLUDE [api-management-log-entry-size-limit](../../includes/api-management-log-entry-size-limit.md)]
 
 ## Next steps
 

articles/api-management/developer-portal-audit-log-schema-reference.md

@@ -3,7 +3,7 @@ title: Monitor Azure API Management
 description: Learn how to monitor Azure API Management using Azure Monitor, including data collection, analysis, and alerting.
 ms.date: 01/06/2025
 ms.custom: horz-monitor
-ms.topic: conceptual
+ms.topic: concept-article
 author: dlepow
 ms.author: danlep
 ms.service: azure-api-management
@@ -100,47 +100,49 @@ Use [Reports](/rest/api/apimanagement/reports) operations in the API Management
 
 Available operations return report records by API, geography, API operations, product, request, subscription, time, or user.
 
-### Enable logging of developer portal usage in Azure API Management
+### Azure Monitor logs
 
-This section shows you how to enable Azure Monitor logs for auditing and troubleshooting usage of the API Management [developer portal](developer-portal-overview.md). When enabled through a diagnostic setting, the logs collect information about the requests that are received and processed by the developer portal.
+This section shows you how to enable Azure Monitor logs for auditing and troubleshooting usage of different features of your API Management instance. By enabling a diagnostic setting, you can enable collection of one or more of the following categories of resource logs:
 
-Developer portal usage logs include data about activity in the developer portal, including:
+|Category  |Description  | Notes |
+|---------|---------|-----|
+|API Management gateway     |  Requests processed by the API Management gateway, including HTTP methods, protocols, request and response bodies, headers, timings, error details, and cache involvement.       | Adjust settings for all APIs, or override them for individual APIs.  |
+|WebSocket connections     | Events for [WebSocket API](websocket-api.md) connections, starting from the handshake until the connection is terminated.       |
+|Developer portal usage     |  Requests that are received and processed by the API Management [developer portal](developer-portal-overview.md), including user authentication actions, views of API details, and API testing in the interactive test console.|
+| Large language model (LLM)  | Requests processed by the gateway for large language model REST APIs such as Azure OpenAI APIs, including token usage, models, and optionally details of request prompts and response completions. | Enable logging of request messages and/or response messages for specific LLM APIs.
 
-- User authentication actions, such as sign-in and sign-out
-- Views of API details, API operation details, and products
-- API testing in the interactive test console
+For more information, see [API Management monitoring data reference](monitor-api-management-reference.md).
 
-#### Enable diagnostic setting for developer portal logs
 
-To configure a diagnostic setting for developer portal usage logs:
+#### Enable diagnostic setting for Azure Monitor logs
 
-1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
-1. In the left menu, under **Monitoring**, select **Diagnostic settings** > **+ Add diagnostic setting**.
+[!INCLUDE [api-management-diagnostic-settings](../../includes/api-management-diagnostic-settings.md)]
 
-   :::image type="content" source="media/developer-portal-enable-usage-logs/monitoring-menu.png" alt-text="Screenshot of adding a diagnostic setting in the portal.":::
+#### View log data
 
-1. On the **Diagnostic setting** page, enter or select details for the setting:
+Depending on the log destination you choose, it can take a few minutes for data to appear.
 
-    1. **Diagnostic setting name**: Enter a descriptive name.
-    1. **Category groups**: Optionally make a selection for your scenario.
-    1. Under **Categories**: Select **Logs related to Developer Portal usage**. Optionally select other categories as needed.
-    1. Under **Destination details**, select one or more options and specify details for the destination. For example, archive logs to a storage account or stream them to an event hub. For more information, see [Diagnostic settings in Azure Monitor](/azure/azure-monitor/essentials/diagnostic-settings).
-    1. Select **Save**.
+**View logs in Log Analytics workspace**
 
-#### View diagnostic log data
+[!INCLUDE [api-management-log-analytics](../../includes/api-management-log-analytics.md)]
 
-Depending on the log destination you choose, it can take a few minutes for data to appear.
+**View logs in storage account**
 
 If you send logs to a storage account, you can access the data in the Azure portal and download it for analysis.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to the storage account destination.
 1. In the left menu, select **Storage Browser**.
-1. Under **Blob containers**, select **insights-logs-developerportalauditlogs**.
+1. Under **Blob containers**, select a name for the log data, for example, **insights-logs-developerportalauditlogs** for developer portal usage logs.
 1. Navigate to the container for the logs in your API Management instance. The logs are partitioned in intervals of 1 hour.
 1. To retrieve the data for further analysis, select **Download**.
 
+#### Modify API logging settings
+
+[!INCLUDE [api-management-api-logging](../../includes/api-management-api-logging.md)]
+
 [!INCLUDE [azmon-horz-tools](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-tools.md)]
 
+
 ### Visualize API Management monitoring data using a Managed Grafana dashboard
 
 You can use [Azure Managed Grafana](../managed-grafana/index.yml) to visualize API Management monitoring data that is collected into a Log Analytics workspace. Use a prebuilt [API Management dashboard](https://grafana.com/grafana/dashboards/16604-azure-api-management) for real-time visualization of logs and metrics collected from your API Management instance.

articles/api-management/gateway-log-schema-reference.md

@@ -5,7 +5,7 @@ ms.service: azure-api-management
 author: dlepow
 ms.author: danlep
 ms.topic: tutorial
-ms.date: 02/20/2025
+ms.date: 02/24/2025
 ms.custom: devdivchpfy22
 ---
 

articles/api-management/media/api-management-howto-use-azure-monitor/api-management-diagnostic-logs-blade.png

@@ -0,0 +1,27 @@
+---
+author: dlepow
+ms.service: azure-api-management
+ms.topic: include
+ms.date: 02/24/2025
+ms.author: danlep
+---
+
+When you create a diagnostic setting to enable collection of gateway or LLM resource logs, logging is enabled with default settings, which do not include details of request or responses such as response bodies. You can adjust the logging settings for all APIs, or override them for individual APIs. For example, adjust the sampling rate or the verbosity of the gateway log data, enable logging of LLM request or response messages, or disable logging for some APIs.
+
+For details about the logging settings, see [Diagnostic logging settings reference](diagnostic-logs-reference.md).
+
+To configure logging settings for all APIs:
+
+1. In the left menu of your API Management instance, select **APIs** > **APIs** > **All APIs**.
+1. Select the **Settings** tab from the top bar.
+1. Scroll down to the **Diagnostic Logs** section, and select the **Azure Monitor** tab.
+1. Review the settings and make changes if needed. Select **Save**. 
+
+To configure logging settings for a specific API:
+
+1. In the left menu of your API Management instance, select **APIs** > **APIs** and then the name of the API.
+1. Select the **Settings** tab from the top bar.
+1. Scroll down to the **Diagnostic Logs** section, and select the **Azure Monitor** tab.
+1. Review the settings and make changes if needed. Select **Save**. 
+
+[!INCLUDE [api-management-log-entry-size-limit](api-management-log-entry-size-limit.md)]