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/container-apps/troubleshoot-container-create-failures.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,18 +1,18 @@
1
1
---
2
-
title: Troubleshoot container create failures in Azure Container Apps
3
-
description: Learn to troubleshoot container create failures in Azure Container Apps
2
+
title: Troubleshoot Container Exit Failures in Azure Container Apps
3
+
description: Learn to troubleshoot container exit events in Azure Container Apps.
4
4
services: container-apps
5
5
author: craigshoemaker
6
6
ms.service: azure-container-apps
7
7
ms.topic: how-to
8
-
ms.date: 01/24/2025
8
+
ms.date: 04/01/2026
9
9
ms.author: cshoe
10
10
ms.custom:
11
11
---
12
12
13
-
# Troubleshoot container create failures in Azure Container Apps
13
+
# Troubleshoot container exit failures in Azure Container Apps
14
14
15
-
Container exit events indicate that a container is stopped or exited. These exit events can significantly impact the availability, stability, and performance of your container app. The underlying issues that trigger these events can potentially lead to downtime or degraded service. Each event is recorded to provide insights into the container's lifecycle, helping you diagnose issues related to the container's execution.
15
+
Container exit events indicate that a container is stopped or exited. These exit events can significantly affect the availability, stability, and performance of your container app. The underlying issues that trigger these events can potentially lead to downtime or degraded service. Each event is recorded to provide insights into the container's lifecycle, helping you diagnose issues related to the container's execution.
16
16
17
17
When a container exits, it could exit with a nonzero exit code (indicating failure) or a zero exit code (indicating a normal exit). Azure logs each exit event to give you visibility into what happened during the container's run.
18
18
@@ -22,7 +22,7 @@ The following list details different reasons your application can experience con
22
22
23
23
-**Application crash or exception**: If the application inside the container encounters an error or exception that it can't recover from, the error can cause the container to exit. Application errors are among the most common reasons for container exit events.
24
24
25
-
-**Out of memory (OOM) errors**: If the container consumes more memory than the allocated limit, the system might kill the container due to out-of-memory (OOM) errors.
25
+
-**Out-of-memory (OOM) errors**: If the container consumes more memory than the allocated limit, the system might kill the container due to OOM errors.
26
26
27
27
-**Incorrect exit code or misconfiguration in the container**: The container might exit intentionally (but improperly) if the application inside the container exits with a nonzero exit code, indicating an abnormal termination. Additionally, misconfigurations in the container can lead to immediate container shutdown. Misconfigurations that affect the app include missing environment variables, incorrect startup command, or invalid container entry point.
28
28
@@ -34,7 +34,7 @@ The Container Apps diagnostics features an intelligent and interactive experienc
34
34
35
35
1. Go to your container app in the Azure portal.
36
36
37
-
1. Select **Diagnose and solve problems**.
37
+
1. Select **Diagnose and solve problems** in the sidebar menu.
38
38
39
39
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
Copy file name to clipboardExpand all lines: articles/container-apps/troubleshoot-health-probe-failures.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
---
2
-
title: Troubleshoot health probe failures in Azure Container Apps
3
-
description: Learn to troubleshoot health probe failures in Azure Container Apps
2
+
title: Troubleshoot Health Probe Failures in Azure Container Apps
3
+
description: Learn to troubleshoot health probe failures in Azure Container Apps.
4
4
services: container-apps
5
5
author: craigshoemaker
6
6
ms.service: azure-container-apps
7
7
ms.topic: how-to
8
-
ms.date: 01/24/2025
8
+
ms.date: 04/01/2026
9
9
ms.author: cshoe
10
10
ms.custom:
11
11
---
@@ -14,11 +14,11 @@ ms.custom:
14
14
15
15
Health probe failures for in Azure Container Apps indicates that the container app doesn't pass the required health checks and could be considered unhealthy or unready.
16
16
17
-
Health Probes are a great way to determine application health. Specifically, health probes help work around performance issues related to timeouts during container startup, deadlocks when running the container, and serving traffic when the container is not ready to accept traffic.
17
+
Health Probes are a great way to determine application health. Specifically, health probes help work around performance issues related to timeouts during container startup, deadlocks when running the container, and serving traffic when the container isn't ready to accept traffic.
18
18
19
19
## Causes
20
20
21
-
Factors related to the container configuration and environments that can lead to a health probe failures include::
21
+
Factors related to the container configuration and environments that can lead to health probe failures include:
22
22
23
23
-**Incorrect health probe configuration**: Configuration errors surrounding protocols, endpoint addresses, paths, ports, and response codes result in probe failures and mark the container as unhealthy.
24
24
@@ -32,17 +32,17 @@ The Container Apps diagnostics features an intelligent and interactive experienc
32
32
33
33
1. Go to your container app in the Azure portal.
34
34
35
-
1. Select **Diagnose and solve problems**.
35
+
1. Select **Diagnose and solve problems** in the sidebar menu.
36
36
37
37
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
38
38
39
-
1.In the left navigation of the *Availability and Performance* section, select**Health Probe Failures**.
39
+
1.Select**Health Probe Failures**.
40
40
41
41
This report provides details on the issue, possible causes, and recommended resolutions.
42
42
43
43
You can review health probe failure events by revision by selecting the required revision of your container app.
44
44
45
-
From this page you can view health probe failure events per revision by health probe type, inside a time frame, and by failure type.
45
+
From this page, you can view health probe failure events per revision by health probe type, inside a time frame, and by failure type.
46
46
47
47
You can also review the health probe configuration per revision for your container app by selecting the required revision from the dropdown.
Copy file name to clipboardExpand all lines: articles/container-apps/troubleshoot-storage-mount-failures.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,18 +1,18 @@
1
1
---
2
-
title: Troubleshoot storage mount failures in Azure Container Apps
3
-
description: Learn to troubleshoot storage mount failures in Azure Container Apps
2
+
title: Troubleshoot Storage Mount Failures in Azure Container Apps
3
+
description: Learn to troubleshoot storage mount failures in Azure Container Apps.
4
4
services: container-apps
5
5
author: craigshoemaker
6
6
ms.service: azure-container-apps
7
7
ms.topic: how-to
8
-
ms.date: 01/24/2025
8
+
ms.date: 04/01/2026
9
9
ms.author: cshoe
10
10
ms.custom:
11
11
---
12
12
13
13
# Troubleshoot storage mount failures in Azure Container Apps
14
14
15
-
Azure Container Apps allow containers to interact with external storage systems, such as Azure Files, Azure Blob Storage, or Azure Managed Disks, for persisting data. These storage resources are mounted to the container's file system during container startup.
15
+
Azure Container Apps allows containers to interact with external storage systems, such as Azure Files, Azure Blob Storage, or Azure Managed Disks, for persisting data. These storage resources are mounted to the container's file system during container startup.
16
16
17
17
Storage mount failures occur when your app's container is unable to successfully mount or access required storage resources, such as volumes or file systems.
18
18
@@ -32,11 +32,11 @@ The Container Apps diagnostics features an intelligent and interactive experienc
32
32
33
33
1. Go to your container app in the Azure portal.
34
34
35
-
1. Select **Diagnose and solve problems**.
35
+
1. Select **Diagnose and solve problems** in the sidebar menu.
36
36
37
37
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
38
38
39
-
1.From the left navigation, select**Storage Mount Failures** to diagnose and troubleshoot the issue.
39
+
1.Select**Storage Mount Failures** to diagnose and troubleshoot the issue.
40
40
41
41
This report provides details on the issue, possible causes, and recommended resolutions.
title: Troubleshoot target port settings in Azure Container Apps
3
-
description: Learn to troubleshoot target port settings in Azure Container Apps
2
+
title: Troubleshoot Target Port Settings in Azure Container Apps
3
+
description: Learn to troubleshoot target port settings in Azure Container Apps.
4
4
services: container-apps
5
5
author: craigshoemaker
6
6
ms.service: azure-container-apps
7
7
ms.topic: how-to
8
-
ms.date: 01/24/2025
8
+
ms.date: 04/01/2026
9
9
ms.author: cshoe
10
10
ms.custom:
11
11
---
@@ -16,13 +16,13 @@ Incorrect target port settings in a container app prevent incoming requests from
16
16
17
17
## Causes
18
18
19
-
-**Port not exposed in dockerfile or app configuration**: This error comes when there's a mismatch between the container configuration and the port where the application is listening. For instance, if:
19
+
-**Port not exposed in dockerfile or app configuration**: This error comes when there's a mismatch between the container configuration and the port where the application is listening. For instance:
20
20
21
-
-The container configurations don't expose the required port using the `EXPOSE` directive.
21
+
-If the container configurations don't expose the required port using the `EXPOSE` directive.
22
22
23
-
-The containerized application inside the app isn't configured to listen on the container app's expected routing or networking port.
23
+
-If the containerized application inside the app isn't configured to listen on the container app's expected routing or networking port.
24
24
25
-
Then the ports are mismatched. For example, the container might be configured to listen on port `8080`, but the container app is expecting it to be on port `80`.
25
+
Then the ports are mismatched. For example, the container might be configured to listen on port `8080`, but the container app expects it to be on port `80`.
26
26
27
27
-**Multiple containers and service ports conflicts**: In a scenario where multiple containers are running in the same app, there could be conflicts between different services trying to use the same port. Ensuring that each service listens to a unique port or that the routing is configured correctly is essential.
28
28
@@ -32,16 +32,16 @@ The Container Apps diagnostics features an intelligent and interactive experienc
32
32
33
33
1. Go to your container app in the Azure portal.
34
34
35
-
1. Select **Diagnose and solve problems**.
35
+
1. Select **Diagnose and solve problems** in the sidebar menu.
36
36
37
37
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
38
38
39
-
1.In the left navigation, select **Container Apps Ingress Port settings check** to diagnose and troubleshoot the issue.
39
+
1.Select **Ingress Port settings check** to diagnose and troubleshoot the issue.
40
40
41
41
Select the required revision of your container app from the dropdown. The latest revision would be populated by default.
42
42
43
43
:::image type="content" source="media/troubleshooting/port-mismatch.png" alt-text="Screenshot of port mismatch report.":::
44
44
45
45
This report provides details on the issue, possible causes, and recommended resolutions.
46
46
47
-
These errors are only raised when the container app is trying to start or scale. Therefore, if the tool doesn't find any issues during a given period, try running the detector during a time when you know the container app is expected to start or scale. In the case when the app isn't receiving any traffic, try to browse the issue or trigger it.
47
+
These errors are only raised when the container app is trying to start or scale. If the tool doesn't find any issues during a given period, try running the detector during a time when you know the container app is expected to start or scale. In the case when the app isn't receiving any traffic, try to browse the issue or trigger it.
0 commit comments