|
1 | 1 | --- |
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. |
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 target port settings in Azure Container Apps |
14 | 14 |
|
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. |
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 |
|
29 | 29 | ## Diagnostics |
30 | 30 |
|
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. |
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