Skip to content

Commit 3329ad3

Browse files
Implement templates, in progress.
1 parent f85ab5b commit 3329ad3

File tree

2 files changed

+166
-0
lines changed

2 files changed

+166
-0
lines changed
Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
title: Monitoring data reference for Azure API Management
3+
description: This article contains important reference material you need when you monitor Azure API Management by using Azure Monitor.
4+
ms.date: 12/10/2024
5+
ms.custom: horz-monitor
6+
ms.topic: reference
7+
author: dlepow
8+
ms.author: danlep
9+
ms.service: azure-api-management
10+
---
11+
12+
# API Management monitoring data reference
13+
14+
[!INCLUDE [horz-monitor-ref-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-intro.md)]
15+
16+
See [Monitor API Management](monitor-api-management.md) for details on the data you can collect for Azure API Management and how to use it.
17+
18+
[!INCLUDE [horz-monitor-ref-metrics-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-intro.md)]
19+
20+
### Supported metrics for Microsoft.ApiManagement/service
21+
22+
The following table lists the metrics available for the Microsoft.ApiManagement/service resource type.
23+
24+
[!INCLUDE [horz-monitor-ref-metrics-tableheader](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-tableheader.md)]
25+
26+
[Microsoft.ApiManagement/service](~/reusable-content/ce-skilling/azure/includes/azure-monitor/reference/metrics/microsoft-apimanagement-service-metrics-include.md)
27+
28+
[!INCLUDE [horz-monitor-ref-metrics-dimensions-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-dimensions-intro.md)]
29+
30+
[!INCLUDE [horz-monitor-ref-metrics-dimensions](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-dimensions.md)]
31+
32+
- ApiId
33+
- BackendResponseCode
34+
- BackendResponseCodeCategory
35+
- Destination
36+
- GatewayResponseCode
37+
- GatewayResponseCodeCategory
38+
- Hostname
39+
- LastErrorReason
40+
- Location
41+
- ResourceType
42+
- Source
43+
- State
44+
45+
[!INCLUDE [horz-monitor-ref-resource-logs](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-resource-logs.md)]
46+
47+
### Supported resource logs for Microsoft.ApiManagement/service
48+
49+
[!INCLUDE [Microsoft.ApiManagement/service](~/reusable-content/ce-skilling/azure/includes/azure-monitor/reference/logs/microsoft-apimanagement-service-logs-include.md)]
50+
51+
### Supported resource logs for Microsoft.ApiManagement/service/workspaces
52+
53+
[!INCLUDE [Microsoft.ApiManagement/service/workspaces](~/reusable-content/ce-skilling/azure/includes/azure-monitor/reference/logs/microsoft-apimanagement-service-workspaces-logs-include.md)]
54+
55+
[!INCLUDE [horz-monitor-ref-logs-tables](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-logs-tables.md)]
56+
57+
### API Management Microsoft.ApiManagement/service
58+
59+
- [APIMDevPortalAuditDiagnosticLog](/azure/azure-monitor/reference/tables/apimdevportalauditdiagnosticlog#columns)
60+
- [AzureActivity](/azure/azure-monitor/reference/tables/azureactivity#columns)
61+
- [AzureMetrics](/azure/azure-monitor/reference/tables/azuremetrics#columns)
62+
- [AzureDiagnostics](/azure/azure-monitor/reference/tables/azurediagnostics#columns)
63+
- [ApiManagementGatewayLogs](/azure/azure-monitor/reference/tables/apimanagementgatewaylogs#columns)
64+
- [ApiManagementWebSocketConnectionLogs](/azure/azure-monitor/reference/tables/apimanagementwebsocketconnectionlogs#columns)
65+
66+
[!INCLUDE [horz-monitor-ref-activity-log](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-activity-log.md)]
67+
68+
- [Microsoft.ApiManagement resource provider operations](/azure/role-based-access-control/resource-provider-operations#microsoftapimanagement)
69+
70+
## Related content
71+
72+
- See [Monitor API Management](monitor-api-management.md) for a description of monitoring Azure API Management.
73+
- See [Monitor Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource) for details on monitoring Azure resources.
Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
---
2+
title: Monitor Azure API Management
3+
description: Learn how to monitor Azure API Management using Azure Monitor, including data collection, analysis, and alerting.
4+
ms.date: 12/10/2024
5+
ms.custom: horz-monitor
6+
ms.topic: conceptual
7+
author: dlepow
8+
ms.author: danlep
9+
ms.service: azure-api-management
10+
---
11+
12+
<!--
13+
According to the Content Pattern guidelines, all comments must be removed before publication!!!
14+
IMPORTANT
15+
When using this template, first:
16+
1. Search and replace [TODO-replace-with-service-name] with the official name of your service.
17+
2. Search and replace [TODO-replace-with-service-filename] with the service name to use in GitHub filenames.-->
18+
19+
<!-- VERSION 4.0 November 2024
20+
For background about this template, see https://review.learn.microsoft.com/en-us/help/contribute/contribute-monitoring?branch=main -->
21+
22+
<!-- Add service-specific information after the includes.
23+
Your service should have the following two articles:
24+
1. The overview monitoring article (based on this template)
25+
- Title: "Monitor [TODO-replace-with-service-name]"
26+
- TOC title: "Monitor [TODO-replace-with-service-name]"
27+
- Filename: "monitor-[TODO-replace-with-service-filename].md"
28+
2. A reference article that lists all the metrics and logs for your service (based on the template data-reference-template.md).
29+
- Title: "[TODO-replace-with-service-name] monitoring data reference"
30+
- TOC title: "Monitoring data reference"
31+
- Filename: "monitor-[TODO-replace-with-service-filename]-reference.md".
32+
-->
33+
34+
# Monitor API Management
35+
36+
[!INCLUDE [azmon-horz-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-intro.md)]
37+
38+
## Collect data with Azure Monitor
39+
40+
This table describes how you can collect data to monitor your service, and what you can do with the data once collected:
41+
42+
|Data to collect|Description|How to collect and route the data|Where to view the data|Supported data|
43+
|---------|---------|---------|---------|---------|
44+
|Metric data|Metrics are numerical values that describe an aspect of a system at a particular point in time. Metrics can be aggregated using algorithms, compared to other metrics, and analyzed for trends over time.|- Collected automatically at regular intervals.</br> - You can route some platform metrics to a Log Analytics workspace to query with other data. Check the **DS export** setting for each metric to see if you can use a diagnostic setting to route the metric data.|[Metrics explorer](/azure/azure-monitor/essentials/metrics-getting-started)| [Azure API Management metrics supported by Azure Monitor](/azure/api-management/monitor-api-management-reference#metrics)|
45+
|Resource log data|Logs are recorded system events with a timestamp. Logs can contain different types of data, and be structured or free-form text. You can route resource log data to Log Analytics workspaces for querying and analysis.|[Create a diagnostic setting](/azure/azure-monitor/essentials/create-diagnostic-settings) to collect and route resource log data.| [Log Analytics](/azure/azure-monitor/learn/quick-create-workspace)|[Azure API Management resource log data supported by Azure Monitor](/azure/api-management/monitor-api-management-reference#resource-logs) |
46+
|Activity log data|The Azure Monitor activity log provides insight into subscription-level events. The activity log includes information like when a resource is modified or a virtual machine is started.|- Collected automatically.</br> - [Create a diagnostic setting](/azure/azure-monitor/essentials/create-diagnostic-settings) to a Log Analytics workspace at no charge.|[Activity log](/azure/azure-monitor/essentials/activity-log)| |
47+
48+
[!INCLUDE [azmon-horz-supported-data](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-supported-data.md)]
49+
50+
## Built in monitoring for API Management
51+
52+
<!-- Add any monitoring mechanisms build in to your service here. -->
53+
54+
<!--## Use Azure Monitor tools to analyze the data-->
55+
[!INCLUDE [azmon-horz-tools](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-tools.md)]
56+
57+
<!--## Export Azure Monitor data -->
58+
[!INCLUDE [azmon-horz-export-data](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-export-data.md)]
59+
60+
<!--## Use Kusto queries to analyze log data -->
61+
[!INCLUDE [azmon-horz-kusto](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-kusto.md)]
62+
63+
### Recommended Kusto queries for API Management
64+
65+
<!-- Add any recommended Kusto queries here. -->
66+
67+
<!-- Add any links to community resources with sample Kusto queries here. -->
68+
69+
<!-- ## Use Azure Monitor alerts to notify you of issues -->
70+
[!INCLUDE [azmon-horz-alerts-part-one](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-alerts-part-one.md)]
71+
72+
<!-- Add any recommended alert rules here. -->
73+
### Recommended Azure Monitor alert rules for API Management
74+
75+
The following table lists common and recommended alert rules for API Management.
76+
77+
| Alert type | Condition | Examples |
78+
|:---|:---|:---|
79+
| Metric | | |
80+
| Log search | | |
81+
| Activity Log | | |
82+
| Service Health | | |
83+
| Resource Health | | |
84+
85+
[!INCLUDE [azmon-horz-alerts-part-two](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-alerts-part-two.md)]
86+
87+
<!-- ## Get personalized recommendations using Azure Advisor -->
88+
[!INCLUDE [azmon-horz-advisor](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/azmon-horz-advisor.md)]
89+
90+
## Related content
91+
92+
- [API Management monitoring data reference](monitor-api-management-reference.md)
93+
- [Monitoring Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource)

0 commit comments

Comments
 (0)