Skip to content

Commit 7b27328

Browse files
authored
Merge pull request #292827 from Akhilesh-microsoft/ACA/health-probes
[UUF347773: ACA: health-probes]: Analyzed and fixed the documentation issue; reviewed and fixed the issues w.r.t freshness. Updated ms.date
2 parents 26f5cfb + c3094db commit 7b27328

File tree

1 file changed

+29
-5
lines changed

1 file changed

+29
-5
lines changed

articles/frontdoor/health-probes.md

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ services: frontdoor
66
author: duongau
77
ms.service: azure-frontdoor
88
ms.topic: concept-article
9-
ms.date: 08/12/2024
9+
ms.date: 01/29/2025
1010
ms.author: duau
1111
---
1212

@@ -21,9 +21,9 @@ ms.author: duau
2121
To determine the health and proximity of each origin for a given Azure Front Door environment, each Front Door profile periodically sends a synthetic HTTP/HTTPS request to all your configured origins. Front Door then uses responses from the health probe to determine the *best* origin to route your client requests to.
2222

2323
> [!WARNING]
24-
> Since each Azure Front Door edge location is sending health probes to your origins, the health probe volume for your origins can be quite high. The number of probes depends on your customer's traffic location and your health probe frequency. If the Azure Front Door edge locations doesn’t receive real traffic from your end users, the frequency of the health probe from the edge location is decreased from the configured frequency. If there is traffic to all the Azure Front Door edge locations, the health probe volume can be high depending on your health probes frequency.
24+
> Since each Azure Front Door edge location is sending health probes to your origins, the health probe volume for your origins can be high. The number of probes depends on your customer's traffic location and your health probe frequency. If the Azure Front Door edge locations don’t receive real traffic from your end users, the frequency of the health probe from the edge location is decreased from the configured frequency. If there's traffic to all the Azure Front Door edge locations, the health probe volume can be high depending on your health probes frequency.
2525
>
26-
> An example to roughly estimate the health probe volume per minute to an origin when using the default probe frequency of 30 seconds. The probe volume on each of your origin is equal to the number of edge locations times two requests per minute. The probing requests will be less if there is no traffic sent to all of the edge locations. For a list of edge locations, see [edge locations by region](edge-locations-by-region.md).
26+
> An example to roughly estimate the health probe volume per minute to an origin when using the default probe frequency of 30 seconds. The probe volume on each of your origin is equal to the number of edge locations times two requests per minute. The probing requests are less if there's no traffic sent to all of the edge locations. For a list of edge locations, see [edge locations by region](edge-locations-by-region.md).
2727
2828
## Supported protocols
2929

@@ -63,7 +63,30 @@ Azure Front Door uses a three-step process across all algorithms to determine he
6363
1. For sets of healthy origins in an origin group, Front Door measures and maintains the latency for each origin.
6464

6565
> [!NOTE]
66-
> If a single endpoint is a member of multiple origin groups, Front Door will optimize the number of health probes sent to the origin to reduce the load on the origin. Health probe requests will be sent based on the lowest configured sample interval. The health of the endpoint in all origin groups will be determined by the responses from same health probes.
66+
> If a single endpoint is a member of multiple origin groups, Front Door optimizes the number of health probes sent to the origin to reduce the load on the origin. Health probe requests are sent based on the lowest configured sample interval. The responses from same health probes determine the health of the endpoint in all origin groups.
67+
68+
## Adjusting probe settings for long-starting containers
69+
70+
When you deal with long-starting containers, adjusting the probe settings can prevent premature failure. Increasing the `ProbeTimeout` and `Interval` values gives your containers more time to start before Front Door marks them as unhealthy.
71+
72+
### Values for long-starting containers
73+
- **ProbeTimeout**: Increase the timeout period to 10–30 seconds.
74+
- **Interval**: Set a longer interval (for example, 30–60 seconds) between probes.
75+
- **UnhealthyThreshold**: Increase the number of consecutive failed probes before the container is considered unhealthy (for example, 3-5 retries).
76+
77+
> [!NOTE]
78+
> The values provided for `ProbeTimeout`, `Interval`, and `UnhealthyThreshold` are sample ranges for example purposes. You can adjust these values based on your specific container's startup behavior and requirements.
79+
80+
> [!NOTE]
81+
> These changes might cause a delay in detecting real failures, so balance these values carefully according to your container's startup behavior.
82+
83+
## Probe interaction during container lifecycle phases
84+
85+
1. **Container Start Phase**: During this phase, the container might not be fully ready to serve traffic. Health probes help detect when a container isn't responding by checking for specific HTTP status codes (for example, `200 OK`). If the probe frequency is too high or the timeout is too short, the container is marked as unhealthy before initialization. Increase probe timeouts or intervals during this phase.
86+
87+
1. **Running Phase**: Once the container is running, probes continue checking for health responses. If health checks consistently return `200 OK`, Front Door keeps the origin in rotation for traffic. If probes consistently fail (for example, due to a container crashing), Front Door marks the origin as unhealthy.
88+
89+
1. **Failure Phase**: If health probes fail for the configured threshold (for example, `UnhealthyThreshold`), the origin is considered unhealthy, and traffic is routed to other healthy origins.
6790

6891
## Complete health probe failure
6992

@@ -76,9 +99,10 @@ Once an origin returns to a healthy state, Front Door resumes the normal load-ba
7699
If you have a single origin in your origin group, you can choose to disable health probes to reduce the load on your application. If you have multiple origins in your origin group and more than one of them is in enabled state, you can't disable health probes.
77100

78101
> [!NOTE]
79-
> If there is only a single origin in your origin group, the single origin will get very few health probes. This may lead to a dip in origin health metrics but your traffic will not be impacted.
102+
> If there's only a single origin in your origin group, the single origin gets few health probes. This might lead to a dip in origin health metrics but your traffic doesn't get impacted.
80103
81104
## Next steps
82105

83106
- Learn how to [create an Azure Front Door profile](create-front-door-portal.md).
84107
- Learn about [Front Door routing architecture](front-door-routing-architecture.md).
108+

0 commit comments

Comments
 (0)