Skip to content

Commit 57770bf

Browse files
ttorblettorble
authored
Merge pull request #274573 from TimShererWithAquent/us248136b
Azure Monitor horizontal: Azure Communications Gateway
2 parents 89d05c8 + ef4aee8 commit 57770bf

File tree

3 files changed

+89
-93
lines changed

3 files changed

+89
-93
lines changed

‎articles/communications-gateway/monitor-azure-communications-gateway.md

Lines changed: 54 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,67 +1,42 @@
11
---
2-
title: Monitoring your Azure Communications Gateway
3-
description: Start here to learn how to monitor Azure Communications Gateway.
2+
title: Monitor Azure Communications Gateway
3+
description: Start here to learn how to monitor Azure Communications Gateway. Use Azure Monitor and Azure Resource Health to monitor your Azure Communications Gateway.
4+
ms.date: 09/24/2024
5+
ms.custom: horz-monitor
6+
ms.topic: conceptual
47
author: rcdun
58
ms.author: rdunstan
69
ms.service: azure-communications-gateway
7-
ms.topic: conceptual
8-
ms.custom: subject-monitoring
9-
ms.date: 01/25/2024
1010
---
1111

12-
# Monitoring Azure Communications Gateway
13-
14-
When you have critical applications and business processes relying on Azure resources, you want to monitor those resources for their availability, performance, and operation. This article describes how you can use Azure Monitor and Azure Resource Health to monitor your Azure Communications Gateway.
12+
# Monitor Azure Communications Gateway
1513

16-
If you notice any concerning resource health indicators or metrics, you can [raise a support ticket](request-changes.md).
14+
You can use Azure Resource Health and Azure Monitor to monitor the health and performance of Azure Communications Gateway.
1715

18-
## What is Azure Monitor?
16+
Azure Monitor allows you to collect, analyze, and act on telemetry from cloud and on-premises environments to ensure optimal application and service performance.
1917

20-
Azure Communications Gateway creates monitoring data using [Azure Monitor](/azure/azure-monitor/overview), which is a full stack monitoring service in Azure. Azure Monitor provides a complete set of features to monitor your Azure resources. It can also monitor resources in other clouds and on-premises.
18+
[!INCLUDE [horz-monitor-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-intro.md)]
2119

22-
Start with the article [Monitoring Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource), which describes the following concepts:
20+
This article also describes how to use Azure Resource Health to monitor your Azure Communications Gateway.
2321

24-
- What is Azure Monitor?
25-
- Costs associated with monitoring
26-
- Monitoring data collected in Azure
27-
- Configuring data collection
28-
- Standard tools in Azure for analyzing and alerting on monitoring data
29-
30-
The following sections build on this article by describing the specific data gathered for Azure Communications Gateway. These sections also provide examples for configuring data collection and analyzing this data with Azure tools.
22+
The following sections describe the specific data gathered for Azure Communications Gateway. These sections also discuss how to configure data collection and analyze this data with Azure tools.
3123

3224
> [!TIP]
3325
> To understand costs associated with Azure Monitor, see [Azure Monitor cost and usage](/azure/azure-monitor/cost-usage).
3426
35-
## Azure Monitor data for Azure Communications Gateway
36-
37-
Azure Communications Gateway collects metrics. See [Monitoring Azure Communications Gateway data reference](monitoring-azure-communications-gateway-data-reference.md) for detailed information on the metrics created by Azure Communications Gateway. Azure Communications Gateway doesn't collect logs.
38-
39-
For clarification on the different types of metrics available in Azure Monitor, see [Monitoring data from Azure resources](/azure/azure-monitor/essentials/monitor-azure-resource#monitoring-data-from-azure-resources).
40-
41-
## Analyzing, filtering and splitting metrics in Azure Monitor
42-
43-
You can analyze metrics for Azure Communications Gateway, along with metrics from other Azure services, by opening **Metrics** from the **Azure Monitor** menu. See [Analyze metrics with Azure Monitor metrics explorer](/azure/azure-monitor/essentials/analyze-metrics) for details on using this tool.
44-
45-
Azure Communications Gateway metrics support the **Region** dimension, allowing you to filter any metric by the Service Locations defined in your Azure Communications Gateway resource. Connectivity metrics also support the **OPTIONS or INVITE** dimension.
46-
47-
You can also split a metric by these dimensions to visualize how different segments of the metric compare with each other.
48-
49-
For more information on filtering and splitting, see [Advanced features of Azure Monitor](/azure/azure-monitor/essentials/metrics-charts).
50-
51-
## Alerts in Azure Monitor
52-
53-
Azure Monitor alerts proactively notify you when important conditions are found in your monitoring data. They allow you to identify and address issues in your system before your customers notice them. You can set alerts on [metrics](/azure/azure-monitor/alerts/alerts-metric-overview) and the [activity log](/azure/azure-monitor/alerts/activity-log-alerts). Different types of alerts have benefits and drawbacks.
54-
5527
## What is Azure Resource Health?
5628

5729
Azure Resource Health provides a personalized dashboard of the health of your resources. This dashboard helps you diagnose and get support for service problems that affect your Azure resources. It reports on the current and past health of your resources.
5830

31+
> [!NOTE]
32+
> If you notice any concerning resource health indicators or metrics, you can [raise a support ticket](request-changes.md).
33+
5934
Resource Health reports one of the following statuses for each resource.
6035

6136
- *Available*: there are no known problems with your resource.
6237
- *Degraded*: a problem with your resource is reducing its performance.
6338
- *Unavailable*: there's a significant problem with your resource or with the Azure platform. For Azure Communications Gateway, this status usually means that calls can't be handled.
64-
- *Unknown*: Resource Health hasn't received information about the resource for more than 10 minutes.
39+
- *Unknown*: Resource Health doesn't receive information about the resource for more than 10 minutes.
6540

6641
For more information, see [Resource Health overview](/azure/service-health/resource-health-overview).
6742

@@ -74,10 +49,44 @@ To access Resource Health for Azure Communications Gateway:
7449
1. Select your Communications Gateway resource.
7550
1. In the menu in the left pane, select **Resource health**.
7651

77-
You can also [configure Resource Health alerts in the Azure portal](/azure/service-health/resource-health-alert-monitor-guide). These alerts can notify you in near real-time when these resources have a change in their health status.
52+
You can also [configure Resource Health alerts in the Azure portal](/azure/service-health/resource-health-alert-monitor-guide). These alerts can notify you in near real-time when these resources have a change in their health status.
53+
54+
Azure Communications Gateway supports the following [resource health checks](/azure/service-health/resource-health-checks-resource-types#microsoftvoiceservicescommunicationsgateway).
55+
56+
[!INCLUDE [horz-monitor-resource-types](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-resource-types.md)]
57+
58+
For more information about the resource types for Azure Communications Gateway, see [Azure Communications Gateway monitoring data reference](monitoring-azure-communications-gateway-data-reference.md).
59+
60+
[!INCLUDE [horz-monitor-data-storage](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-data-storage.md)]
61+
62+
[!INCLUDE [horz-monitor-platform-metrics](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-platform-metrics.md)]
63+
64+
For a list of available metrics for Azure Communications Gateway, see [Azure Communications Gateway monitoring data reference](monitoring-azure-communications-gateway-data-reference.md#metrics).
65+
66+
## Analyzing, filtering and splitting metrics in Azure Monitor
67+
68+
You can analyze metrics for Azure Communications Gateway, along with metrics from other Azure services, by opening **Metrics** from the **Azure Monitor** menu. See [Analyze metrics with Azure Monitor metrics explorer](/azure/azure-monitor/essentials/analyze-metrics) for details on using this tool.
69+
70+
Azure Communications Gateway metrics support the **Region** dimension, allowing you to filter any metric by the Service Locations defined in your Azure Communications Gateway resource. Connectivity metrics also support the **OPTIONS** or **INVITE** dimension.
71+
72+
You can also split a metric by these dimensions to visualize how different segments of the metric compare with each other.
73+
74+
For more information on filtering and splitting, see [Advanced features of Azure Monitor](/azure/azure-monitor/essentials/metrics-charts).
75+
76+
[!INCLUDE [horz-monitor-no-resource-logs](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-no-resource-logs.md)]
77+
78+
[!INCLUDE [horz-monitor-activity-log](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-activity-log.md)]
79+
80+
[!INCLUDE [horz-monitor-analyze-data](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-analyze-data.md)]
81+
82+
[!INCLUDE [horz-monitor-external-tools](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-external-tools.md)]
83+
84+
[!INCLUDE [horz-monitor-kusto-queries](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-kusto-queries.md)]
85+
86+
[!INCLUDE [horz-monitor-alerts](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-alerts.md)]
7887

79-
## Next steps
88+
## Related content
8089

81-
- See [Monitoring Azure Communications Gateway data reference](monitoring-azure-communications-gateway-data-reference.md) for a reference of the metrics, logs, and other important values created by Azure Communications Gateway.
82-
- See [Monitoring Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource) for an overview of monitoring Azure resources.
83-
- See [Resource Health overview](/azure/service-health/resource-health-overview) for an overview of Resource Health.
90+
- See [Azure Communications Gateway monitoring data reference](monitoring-azure-communications-gateway-data-reference.md) for a reference of the metrics, logs, and other important values created for Azure Communications Gateway.
91+
- See [Monitoring Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource) for general details on monitoring Azure resources.
92+
- See [Resource Health overview](/azure/service-health/resource-health-overview) for an overview of Resource Health.

‎articles/communications-gateway/monitoring-azure-communications-gateway-data-reference.md

Lines changed: 31 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,67 +1,56 @@
11
---
2-
title: Monitoring Azure Communications Gateway data reference
3-
description: Important reference material needed when you monitor Azure Communications Gateway
2+
title: Monitoring data reference for Azure Communications Gateway
3+
description: This article contains important reference material you need when you monitor Azure Communications Gateway.
4+
ms.date: 09/24/2024
5+
ms.custom: horz-monitor
6+
ms.topic: reference
47
author: rcdun
58
ms.author: rdunstan
6-
ms.topic: reference
79
ms.service: azure-communications-gateway
8-
ms.custom: subject-monitoring
9-
ms.date: 02/01/2024
1010
---
1111

12+
# Azure Communications Gateway 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+
Learn about the data and resources collected by Azure Monitor from your Azure Communications Gateway workspace. See [Monitor Azure Communications Gateway](monitor-azure-communications-gateway.md) for details on collecting and analyzing monitoring data for Azure Communications Gateway.
1217

13-
# Monitoring Azure Communications Gateway data reference
18+
[!INCLUDE [horz-monitor-ref-metrics-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-intro.md)]
1419

15-
Learn about the data and resources collected by Azure Monitor from your Azure Communications Gateway workspace. See [Monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md) for details on collecting and analyzing monitoring data for Azure Communications Gateway.
20+
<a name="connectivity-metrics"></a>
1621

17-
## Metrics
22+
### Supported metrics for Microsoft.VoiceServices/communicationsGateways
1823

19-
This section lists all the automatically collected metrics collected for Azure Communications Gateway. The resource provider for these metrics is `Microsoft.VoiceServices/communicationsGateways`.
24+
The following table lists the metrics available for the Microsoft.VoiceServices/communicationsGateways resource type.
2025

21-
### Error metrics
26+
[!INCLUDE [horz-monitor-ref-metrics-tableheader](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-tableheader.md)]
2227

23-
| Metric | Unit | Description |
24-
|:-------|:----|:------------|
25-
|Active Call Failures | Percentage| Percentage of active calls that fail. This metric includes, for example, calls where the media is dropped and calls that are torn down unexpectedly.|
28+
[!INCLUDE [Microsoft.VoiceServices/communicationsGateways](~/reusable-content/ce-skilling/azure/includes/azure-monitor/reference/metrics/microsoft-voiceservices-communicationsgateways-metrics-include.md)]
2629

30+
[!INCLUDE [horz-monitor-ref-metrics-dimensions-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-dimensions-intro.md)]
2731

28-
### Traffic metrics
32+
[!INCLUDE [horz-monitor-ref-metrics-dimensions](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-dimensions.md)]
2933

30-
| Metric | Unit | Description |
31-
|:-------|:----|:------------|
32-
| Active Calls | Count | Count of the total number of active calls. |
33-
| Active Emergency Calls | Count | Count of the total number of active emergency calls.|
34+
- BotType
3435

35-
### Connectivity metrics
36+
- Region
3637

37-
The metrics in the following table refer to the connection between your network and the Azure Communications Gateway resource.
38+
The Service Locations defined in your Azure Communications Gateway resource.
3839

39-
| Metric | Unit | Description |
40-
|:-------|:----|:------------|
41-
| SIP 2xx Responses Received | Count | Count of the total number of SIP 2xx responses received for OPTIONS and INVITEs.|
42-
| SIP 2xx Responses Sent | Count | Count of the total number of SIP 2xx responses sent for OPTIONS and INVITEs.|
43-
| SIP 3xx Responses Received | Count | Count of the total number of SIP 3xx responses received for OPTIONS and INVITEs.|
44-
| SIP 3xx Responses Sent | Count | Count of the total number of SIP 3xx responses sent for OPTIONS and INVITEs.|
45-
| SIP 4xx Responses Received | Count | Count of the total number of SIP 4xx responses received for OPTIONS and INVITEs.|
46-
| SIP 4xx Responses Sent | Count | Count of the total number of SIP 4xx responses sent for OPTIONS and INVITEs.|
47-
| SIP 5xx Responses Received | Count | Count of the total number of SIP 5xx responses received for OPTIONS and INVITEs.|
48-
| SIP 5xx Responses Sent | Count | Count of the total number of SIP 5xx responses sent for OPTIONS and INVITEs.|
49-
| SIP 6xx Responses Received | Count | Count of the total number of SIP 6xx responses received for OPTIONS and INVITEs.|
50-
| SIP 6xx Responses Sent | Count | Count of the total number of SIP 6xx responses sent for OPTIONS and INVITEs.|
40+
- OPTIONS or INVITE
5141

52-
## Metric Dimensions
42+
The SIP method for responses being sent and received:
5343

54-
For more information on what metric dimensions are, see [Multi-dimensional metrics](/azure/azure-monitor/platform/data-platform-metrics#multi-dimensional-metrics).
44+
- SIP OPTIONS responses sent and received by your Azure Communications Gateway resource to monitor its connectivity to its peers
45+
- SIP INVITE responses sent and received by your Azure Communications Gateway resource
5546

56-
Azure Communications Gateway has the following dimensions associated with its metrics.
47+
## Resource logs
5748

58-
| Dimension Name | Description |
59-
| ------------------- | ----------------- |
60-
| **Region** | The Service Locations defined in your Azure Communications Gateway resource. |
61-
| **OPTIONS or INVITE** | The SIP method for responses being sent and received:<br>- SIP OPTIONS responses sent and received by your Azure Communications Gateway resource to monitor its connectivity to its peers<br>- SIP INVITE responses sent and received by your Azure Communications Gateway resource. |
49+
Azure Communications Gateway doesn't collect logs.
6250

51+
[!INCLUDE [horz-monitor-ref-activity-log](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-activity-log.md)]
6352

64-
## Next steps
53+
## Related content
6554

66-
- See [Monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md) for a description of monitoring Azure Communications Gateway.
67-
- See [Monitoring Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource) for details on monitoring Azure resources.
55+
- See [Monitor Azure Communications Gateway](monitor-azure-communications-gateway.md) for a description of monitoring Communications Gateway.
56+
- See [Monitor Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource) for details on monitoring Azure resources.

‎articles/communications-gateway/toc.yml

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -98,12 +98,8 @@ items:
9898
items:
9999
- name: Set up user roles
100100
href: provision-user-roles.md
101-
- name: Monitoring
102-
items:
103-
- name: Overview of monitoring
104-
href: monitor-azure-communications-gateway.md
105-
- name: Monitoring data reference
106-
href: monitoring-azure-communications-gateway-data-reference.md
101+
- name: Monitor Communications Gateway
102+
href: monitor-azure-communications-gateway.md
107103
- name: Maintenance notifications
108104
href: maintenance-notifications.md
109105
- name: Get support or request changes
@@ -122,3 +118,5 @@ items:
122118
href: /microsoftteams/direct-routing-sbc-multiple-tenants
123119
- name: Overview of Zoom Phone Cloud Peering
124120
href: https://partner.zoom.us/partner-type/cloud-peering/
121+
- name: Monitoring data reference
122+
href: monitoring-azure-communications-gateway-data-reference.md

0 commit comments

Comments
 (0)