Skip to content

Commit c0eb5a1

Browse files
authored
Merge pull request #314088 from cdpark/refresh-containerapps-batch5
Feature 544850: Q&M: Azure Container Apps Freshness (Set 3 of 5) - batch 5
2 parents 0854872 + 05fab10 commit c0eb5a1

5 files changed

Lines changed: 38 additions & 38 deletions

articles/container-apps/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -236,7 +236,7 @@ items:
236236
href: troubleshooting.md
237237
- name: Errors and failures
238238
items:
239-
- name: Container create
239+
- name: Container exits
240240
href: troubleshoot-container-create-failures.md
241241
- name: Open Container Initiative (OCI)
242242
href: troubleshoot-open-container-initiative-errors.md

articles/container-apps/troubleshoot-container-create-failures.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
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.
44
services: container-apps
55
author: craigshoemaker
66
ms.service: azure-container-apps
77
ms.topic: how-to
8-
ms.date: 01/24/2025
8+
ms.date: 04/01/2026
99
ms.author: cshoe
1010
ms.custom:
1111
---
1212

13-
# Troubleshoot container create failures in Azure Container Apps
13+
# Troubleshoot container exit failures in Azure Container Apps
1414

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.
1616

1717
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.
1818

@@ -22,19 +22,19 @@ The following list details different reasons your application can experience con
2222

2323
- **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.
2424

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.
2626

2727
- **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.
2828

2929
- **Application termination (normal exit)**: A container might exit normally as the application inside completes its task, for example a batch job or a one-off process. This exit condition is expected behavior when the container is configured for short-lived tasks or single-use jobs.
3030

3131
## Diagnostics
3232

33-
The Container Apps diagnostics features an intelligent and interactive experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Azure Container Apps diagnostics.
33+
Container Apps features an intelligent and interactive diagnostics experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Container Apps diagnostics.
3434

3535
1. Go to your container app in the Azure portal.
3636

37-
1. Select **Diagnose and solve problems**.
37+
1. Select **Diagnose and solve problems** in the sidebar menu.
3838

3939
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
4040

articles/container-apps/troubleshoot-health-probe-failures.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
---
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.
44
services: container-apps
55
author: craigshoemaker
66
ms.service: azure-container-apps
77
ms.topic: how-to
8-
ms.date: 01/24/2025
8+
ms.date: 04/01/2026
99
ms.author: cshoe
1010
ms.custom:
1111
---
1212

1313
# Troubleshoot health probe failures in Azure Container Apps
1414

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.
15+
Health probe failures in Azure Container Apps indicate that the container app doesn't pass the required health checks and could be considered unhealthy or unready.
1616

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.
1818

1919
## Causes
2020

21-
Factors related to the container configuration and environments that can lead to a health probe failures include::
21+
Factors that can lead to health probe failures include:
2222

2323
- **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.
2424

@@ -28,21 +28,21 @@ Factors related to the container configuration and environments that can lead to
2828

2929
## Diagnostics
3030

31-
The Container Apps diagnostics features an intelligent and interactive experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Azure Container Apps diagnostics.
31+
Container Apps features an intelligent and interactive diagnostics experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Container Apps diagnostics.
3232

3333
1. Go to your container app in the Azure portal.
3434

35-
1. Select **Diagnose and solve problems**.
35+
1. Select **Diagnose and solve problems** in the sidebar menu.
3636

3737
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
3838

39-
1. In the left navigation of the *Availability and Performance* section, select **Health Probe Failures**.
39+
1. Select **Health Probe Failures**.
4040

4141
This report provides details on the issue, possible causes, and recommended resolutions.
4242

4343
You can review health probe failure events by revision by selecting the required revision of your container app.
4444

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.
4646

4747
You can also review the health probe configuration per revision for your container app by selecting the required revision from the dropdown.
4848

articles/container-apps/troubleshoot-storage-mount-failures.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
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.
44
services: container-apps
55
author: craigshoemaker
66
ms.service: azure-container-apps
77
ms.topic: how-to
8-
ms.date: 01/24/2025
8+
ms.date: 04/01/2026
99
ms.author: cshoe
1010
ms.custom:
1111
---
1212

1313
# Troubleshoot storage mount failures in Azure Container Apps
1414

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.
1616

1717
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.
1818

@@ -28,15 +28,15 @@ Storage mount failures occur when your app's container is unable to successfully
2828

2929
## Diagnostics
3030

31-
The Container Apps diagnostics features an intelligent and interactive experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Azure Container Apps diagnostics.
31+
Container Apps features an intelligent and interactive diagnostics experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Container Apps diagnostics.
3232

3333
1. Go to your container app in the Azure portal.
3434

35-
1. Select **Diagnose and solve problems**.
35+
1. Select **Diagnose and solve problems** in the sidebar menu.
3636

3737
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
3838

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.
4040

4141
This report provides details on the issue, possible causes, and recommended resolutions.
4242

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,47 @@
11
---
2-
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.
44
services: container-apps
55
author: craigshoemaker
66
ms.service: azure-container-apps
77
ms.topic: how-to
8-
ms.date: 01/24/2025
8+
ms.date: 04/01/2026
99
ms.author: cshoe
1010
ms.custom:
1111
---
1212

1313
# Troubleshoot target port settings in Azure Container Apps
1414

15-
Incorrect target port settings in a container app prevent incoming requests from reaching the correct port where the container listens for traffic. This port mismatch stops the container app from routing external traffic to the right application inside the container. Such misconfiguration can cause app downtime or delays in serving requests, reducing service availability. Additionally, if the app scales and the target port is misconfigured, new instances might not function correctly, negatively impacting overall performance and scalability.
15+
Incorrect target port settings in a container app prevent incoming requests from reaching the correct port where the container listens for traffic. This port mismatch stops the container app from routing external traffic to the right application inside the container. Such misconfiguration can cause app downtime or delays in serving requests, reducing service availability. Additionally, if the app scales and the target port is misconfigured, new instances might not function correctly, which can negatively impact overall performance and scalability.
1616

1717
## Causes
1818

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:
2020

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.
2222

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.
2424

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`.
2626

2727
- **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.
2828

2929
## Diagnostics
3030

31-
The Container Apps diagnostics features an intelligent and interactive experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Azure Container Apps diagnostics.
31+
Container Apps features an intelligent and interactive diagnostics experience that helps you troubleshoot your app with no configuration required. Use the following steps to access Container Apps diagnostics.
3232

3333
1. Go to your container app in the Azure portal.
3434

35-
1. Select **Diagnose and solve problems**.
35+
1. Select **Diagnose and solve problems** in the sidebar menu.
3636

3737
1. Under the troubleshooting categories, select the **Availability and Performance** category tile.
3838

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.
4040

4141
Select the required revision of your container app from the dropdown. The latest revision would be populated by default.
4242

4343
:::image type="content" source="media/troubleshooting/port-mismatch.png" alt-text="Screenshot of port mismatch report.":::
4444

4545
This report provides details on the issue, possible causes, and recommended resolutions.
4646

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

Comments
 (0)