You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/api-management/how-to-configure-cloud-metrics-logs.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,12 +1,12 @@
1
1
---
2
-
title: Configure cloud metrics and logs for Azure API Management self-hosted gateway | Microsoft Docs
2
+
title: Configure Cloud Metrics and Logs for Azure API Management Self-Hosted Gateway | Microsoft Docs
3
3
description: Learn how to configure cloud metrics and logs for Azure API Management self-hosted gateway
4
4
services: api-management
5
5
author: dlepow
6
6
manager: gwallace
7
7
ms.service: azure-api-management
8
8
ms.topic: how-to
9
-
ms.date: 04/30/2020
9
+
ms.date: 10/06/2025
10
10
ms.author: danlep
11
11
---
12
12
@@ -16,19 +16,19 @@ ms.author: danlep
16
16
17
17
This article provides details for configuring cloud metrics and logs for the [self-hosted gateway](./self-hosted-gateway-overview.md).
18
18
19
-
The self-hosted gateway has to be associated with an API management service and requires outbound TCP/IP connectivity to Azure on port 443. The gateway leverages the outbound connection to send telemetry to Azure, if configured to do so.
19
+
You must associate the self-hosted gateway with an Azure API Management service and provide outbound TCP/IP connectivity to Azure on port 443. The gateway uses the outbound connection to send telemetry to Azure, if you configure it to do so.
20
20
21
21
## Metrics
22
-
By default, the self-hosted gateway emits a number of metrics through [Azure Monitor](https://azure.microsoft.com/services/monitor/), same as the managed gateway [in the cloud](api-management-howto-use-azure-monitor.md).
23
22
24
-
The feature can be enabled or disabled using the `telemetry.metrics.cloud` key in the ConfigMap of the gateway Deployment. Below is a breakdown of the available configurations:
23
+
By default, the self-hosted gateway emits several metrics through [Azure Monitor](https://azure.microsoft.com/services/monitor/), just like the managed gateway [in the cloud](api-management-howto-use-azure-monitor.md).
24
+
25
+
You can enable or disable this feature by using the `telemetry.metrics.cloud` key in the ConfigMap of the gateway Deployment. The following table describes the available configurations:
25
26
26
27
| Field | Default | Description |
27
28
| ------------- | ------------- | ------------- |
28
29
| telemetry.metrics.cloud |`true`| Enables logging through Azure Monitor. Value can be `true`, `false`. |
29
30
30
-
31
-
Here is a sample configuration:
31
+
Here's a sample configuration:
32
32
33
33
```yaml
34
34
apiVersion: v1
@@ -46,16 +46,16 @@ The self-hosted gateway currently emits the following metrics through Azure Moni
46
46
| ------------- | ------------- |
47
47
| Requests | Number of API requests in the period |
48
48
| Duration of gateway requests | Number of milliseconds from the moment gateway received request until the moment response sent in full |
49
-
| Duration of backend requests | Number of milliseconds spent on overall backend IO (connecting, sending and receiving bytes) |
49
+
| Duration of backend requests | Number of milliseconds spent on overall backend IO (connecting, sending, and receiving bytes) |
50
50
51
51
## Logs
52
52
53
-
The self-hosted gateway currently does not send [diagnostic logs](./api-management-howto-use-azure-monitor.md#activity-logs) to the cloud. However, it is possible to [configure and persist logs locally](how-to-configure-local-metrics-logs.md) where the self-hosted gateway is deployed.
53
+
The self-hosted gateway currently doesn't send [diagnostic logs](./api-management-howto-use-azure-monitor.md#activity-logs) to the cloud. However, you can [configure and persist logs locally](how-to-configure-local-metrics-logs.md) where the self-hosted gateway is deployed.
54
54
55
-
If a gateway is deployed in [Azure Kubernetes Service](https://azure.microsoft.com/services/kubernetes-service/), you can enable [Azure Monitor for containers](/azure/azure-monitor/containers/container-insights-overview) to collect logs from your containers and view them in Log Analytics.
55
+
If a gateway is deployed in [Azure Kubernetes Service](https://azure.microsoft.com/services/kubernetes-service/), you can enable [Azure Monitor for containers](/azure/azure-monitor/containers/container-insights-overview) to collect logs from your containers and view them in Log Analytics.
56
56
57
57
## Related content
58
58
59
-
* To learn more about the [observability capabilities of the Azure API Management gateways](observability.md).
59
+
* Learn more about the [observability capabilities of the Azure API Management gateways](observability.md).
60
60
* To learn more about the self-hosted gateway, see [Azure API Management self-hosted gateway overview](self-hosted-gateway-overview.md)
61
61
* Learn about [configuring and persisting logs locally](how-to-configure-local-metrics-logs.md)
0 commit comments