Skip to content

Commit 8c96c00

Browse files
committed
Incorporate feedback
1 parent 42a536d commit 8c96c00

7 files changed

+112
-151
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1135,6 +1135,11 @@
11351135
"redirect_url": "/azure/container-instances/container-instances-multi-container-group",
11361136
"redirect_document_id": false
11371137
},
1138+
{
1139+
"source_path_from_root": "/articles/container-instances/container-instances-monitor.md",
1140+
"redirect_url": "/azure/container-instances/monitor-azure-container-instances",
1141+
"redirect_document_id": false
1142+
},
11381143
{
11391144
"source_path_from_root": "/articles/cassandra-managed-instance/compare-cosmosdb-managed-instance.md",
11401145
"redirect_url": "/azure/managed-instance-apache-cassandra/compare-cosmosdb-managed-instance",

articles/container-instances/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,7 @@
164164
href: container-instances-update.md
165165
- name: Monitor and log
166166
items:
167-
- name: Monitor
167+
- name: Monitor Container Instances
168168
href: monitor-azure-container-instances.md
169169
- name: Monitor CPU and memory usage
170170
href: container-instances-monitor.md

articles/container-instances/container-instances-log-analytics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -172,7 +172,7 @@ For more information about querying logs and configuring alerts in Azure Monitor
172172

173173
For information about monitoring container instance CPU and memory resources, see:
174174

175-
* [Monitor container resources in Azure Container Instances](container-instances-monitor.md).
175+
* [Monitor Azure Container Instances](cmonitor-azure-container-instances.md).
176176

177177
<!-- IMAGES -->
178178
[log-search-01]: ./media/container-instances-log-analytics/portal-query-01.png

articles/container-instances/container-instances-monitor.md

Lines changed: 0 additions & 144 deletions
This file was deleted.

articles/container-instances/container-instances-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ Some features are currently restricted to Linux containers:
5959

6060
* Multiple containers per container group
6161
* Volume mounting ([Azure Files](container-instances-volume-azure-files.md), [emptyDir](container-instances-volume-emptydir.md), [GitRepo](container-instances-volume-gitrepo.md), [secret](container-instances-volume-secret.md))
62-
* [Resource usage metrics](container-instances-monitor.md) with Azure Monitor
62+
* [Resource usage metrics](monitor-azure-container-instances.md#get-metrics) with Azure Monitor
6363
* [GPU resources](container-instances-gpu.md) (preview)
6464

6565
For Windows container deployments, use images based on common [Windows base images](./container-instances-faq.yml#what-windows-base-os-images-are-supported-).

articles/container-instances/container-instances-troubleshooting.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ This error indicates that due to heavy load in the region in which you are attem
9898
## Issues during container group runtime
9999
### Container had an isolated restart without explicit user input
100100

101-
There are two broad categories for why a container group may restart without explicit user input. First, containers may experience restarts caused by an application process crash. The ACI service recommends applying observability solutions such as [Application Insights SDK](../azure-monitor/app/app-insights-overview.md), [container group metrics](container-instances-monitor.md), and [container group logs](container-instances-get-logs.md) to determine why the application experienced issues. Second, customers may experience restarts initiated by the ACI infrastructure due to maintenance events. To increase the availability of your application, run multiple container groups behind an ingress component such as an [Application Gateway](../application-gateway/overview.md) or [Traffic Manager](../traffic-manager/traffic-manager-overview.md).
101+
There are two broad categories for why a container group may restart without explicit user input. First, containers may experience restarts caused by an application process crash. The ACI service recommends applying observability solutions such as [Application Insights SDK](../azure-monitor/app/app-insights-overview.md), [container group metrics](monitor-azure-container-instances.md#get-metrics), and [container group logs](container-instances-get-logs.md) to determine why the application experienced issues. Second, customers may experience restarts initiated by the ACI infrastructure due to maintenance events. To increase the availability of your application, run multiple container groups behind an ingress component such as an [Application Gateway](../application-gateway/overview.md) or [Traffic Manager](../traffic-manager/traffic-manager-overview.md).
102102

103103
### Container continually exits and restarts (no long-running process)
104104

articles/container-instances/monitor-azure-container-instances.md

Lines changed: 103 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,111 @@ For more information about the resource types for Azure Container Instances, see
2020

2121
[!INCLUDE [horz-monitor-platform-metrics](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-platform-metrics.md)]
2222

23-
For a list of available metrics for Container Instances, see [Container Instances monitoring data reference](monitor-azure-container-instances-reference.md#metrics).
23+
For a list of available metrics for Container Instances, see [Container Instances monitoring data reference](monitor-azure-container-instances-reference.md#metrics). These metrics are available for a container group and individual containers. By default, the metrics are aggregated as averages.
2424

25-
All metrics for Container Instances are in the namespace **Container group standard metrics**. In a container group with multiple containers, you can filter on the **containerName** dimension to acquire metrics from a specific container within the group.
25+
All metrics for Container Instances are in the namespace **Container group standard metrics**. In a container group with multiple containers, you can filter on the **containerName** dimension to acquire metrics from a specific container within the group. Containers generate similar data as other Azure resources, but they require a containerized agent to collect required data.
2626

27-
Containers generate similar data as other Azure resources, but they require a containerized agent to collect required data. For more information about container metrics for Container Instances, see [Monitor container resources in Azure Container Instances](container-instances-monitor.md).
27+
### Get metrics
28+
29+
You can gather Azure Monitor metrics for container instances using either the Azure portal or Azure CLI.
30+
31+
> [!IMPORTANT]
32+
> Azure Monitor metrics in Azure Container Instances are currently in preview. At this time, Azure Monitor metrics are only available for Linux containers. Previews are made available to you on the condition that you agree to the [supplemental terms of use](https://azure.microsoft.com/support/legal/preview-supplemental-terms). Some aspects of this feature may change prior to general availability (GA).
33+
34+
#### Use the Azure portal
35+
36+
When a container group is created, Azure Monitor data is available in the Azure portal. To see metrics for a container group, go to the **Overview** page for the container group. Here you can see pre-created charts for each of the available metrics.
37+
38+
:::image type="content" source="media/container-instances-monitor/metrics.png" alt-text="Screenshot of pre-created charts for available metrics.":::
39+
40+
In a container group that contains multiple containers, use a [dimension](../azure-monitor/essentials/data-platform-metrics.md#multi-dimensional-metrics) to display metrics by container. To create a chart with individual container metrics, perform the following steps:
41+
42+
1. In the **Overview** page, select one of the metric charts, such as **CPU**.
43+
1. Select the **Apply splitting** button, and select **Container Name**.
44+
45+
:::image type="content" source="media/container-instances-monitor/dimension.png" alt-text="Screenshot that shows the metrics for a container instance with Apply splitting selected and Container Name selected.":::
46+
47+
#### Use Azure CLI
48+
49+
Metrics for container instances can also be gathered using the Azure CLI. First, get the ID of the container group using the following command. Replace `<resource-group>` with your resource group name and `<container-group>` with the name of your container group.
50+
51+
```azurecli
52+
CONTAINER_GROUP=$(az container show --resource-group <resource-group> --name <container-group> --query id --output tsv)
53+
```
54+
55+
Use the following command to get **CPU** usage metrics.
56+
57+
```azurecli
58+
az monitor metrics list --resource $CONTAINER_GROUP --metric CPUUsage --output table
59+
```
60+
61+
```output
62+
Timestamp Name Average
63+
------------------- --------- ---------
64+
2020-12-17 23:34:00 CPU Usage
65+
. . .
66+
2020-12-18 00:25:00 CPU Usage
67+
2020-12-18 00:26:00 CPU Usage 0.4
68+
2020-12-18 00:27:00 CPU Usage 0.0
69+
```
70+
71+
Change the value of the `--metric` parameter in the command to get other [supported metrics](monitor-azure-container-instances-reference.md#metrics). For example, use the following command to get **memory** usage metrics.
72+
73+
```azurecli
74+
az monitor metrics list --resource $CONTAINER_GROUP --metric MemoryUsage --output table
75+
```
76+
77+
```output
78+
Timestamp Name Average
79+
------------------- ------------ ----------
80+
2019-04-23 22:59:00 Memory Usage
81+
2019-04-23 23:00:00 Memory Usage
82+
2019-04-23 23:01:00 Memory Usage 0.0
83+
2019-04-23 23:02:00 Memory Usage 8859648.0
84+
2019-04-23 23:03:00 Memory Usage 9181184.0
85+
2019-04-23 23:04:00 Memory Usage 9580544.0
86+
2019-04-23 23:05:00 Memory Usage 10280960.0
87+
2019-04-23 23:06:00 Memory Usage 7815168.0
88+
2019-04-23 23:07:00 Memory Usage 7739392.0
89+
2019-04-23 23:08:00 Memory Usage 8212480.0
90+
2019-04-23 23:09:00 Memory Usage 8159232.0
91+
2019-04-23 23:10:00 Memory Usage 8093696.0
92+
```
93+
94+
For a multi-container group, the `containerName` dimension can be added to return metrics per container.
95+
96+
```azurecli
97+
az monitor metrics list --resource $CONTAINER_GROUP --metric MemoryUsage --dimension containerName --output table
98+
```
99+
100+
```output
101+
Timestamp Name Containername Average
102+
------------------- ------------ -------------------- -----------
103+
2019-04-23 22:59:00 Memory Usage aci-tutorial-app
104+
2019-04-23 23:00:00 Memory Usage aci-tutorial-app
105+
2019-04-23 23:01:00 Memory Usage aci-tutorial-app 0.0
106+
2019-04-23 23:02:00 Memory Usage aci-tutorial-app 16834560.0
107+
2019-04-23 23:03:00 Memory Usage aci-tutorial-app 17534976.0
108+
2019-04-23 23:04:00 Memory Usage aci-tutorial-app 18329600.0
109+
2019-04-23 23:05:00 Memory Usage aci-tutorial-app 19742720.0
110+
2019-04-23 23:06:00 Memory Usage aci-tutorial-app 14786560.0
111+
2019-04-23 23:07:00 Memory Usage aci-tutorial-app 14651392.0
112+
2019-04-23 23:08:00 Memory Usage aci-tutorial-app 15470592.0
113+
2019-04-23 23:09:00 Memory Usage aci-tutorial-app 15450112.0
114+
2019-04-23 23:10:00 Memory Usage aci-tutorial-app 15339520.0
115+
2019-04-23 22:59:00 Memory Usage aci-tutorial-sidecar
116+
2019-04-23 23:00:00 Memory Usage aci-tutorial-sidecar
117+
2019-04-23 23:01:00 Memory Usage aci-tutorial-sidecar 0.0
118+
2019-04-23 23:02:00 Memory Usage aci-tutorial-sidecar 884736.0
119+
2019-04-23 23:03:00 Memory Usage aci-tutorial-sidecar 827392.0
120+
2019-04-23 23:04:00 Memory Usage aci-tutorial-sidecar 831488.0
121+
2019-04-23 23:05:00 Memory Usage aci-tutorial-sidecar 819200.0
122+
2019-04-23 23:06:00 Memory Usage aci-tutorial-sidecar 843776.0
123+
2019-04-23 23:07:00 Memory Usage aci-tutorial-sidecar 827392.0
124+
2019-04-23 23:08:00 Memory Usage aci-tutorial-sidecar 954368.0
125+
2019-04-23 23:09:00 Memory Usage aci-tutorial-sidecar 868352.0
126+
2019-04-23 23:10:00 Memory Usage aci-tutorial-sidecar 847872.0
127+
```
28128

29129
[!INCLUDE [horz-monitor-resource-logs](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-resource-logs.md)]
30130

0 commit comments

Comments
 (0)