Skip to content

Commit 04513c2

Browse files
Merge pull request #304415 from thisisanniefang/patch-512113
Add probe threshold section + HTTP probe behavior
2 parents d8bbc34 + c05d442 commit 04513c2

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

articles/load-balancer/load-balancer-custom-probe-overview.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,8 @@ Health probes have the following properties:
3434
| Protocol | Protocol of health probe. This is the protocol type you would like the health probe to use. Options are: TCP, HTTP, HTTPS |
3535
| Port | Port of the health probe. The destination port you would like the health probe to use when it connects to the virtual machine to check its health |
3636
| Interval (seconds) | Interval of health probe. The amount of time (in seconds) between different probes on two consecutive health check attempts to the virtual machine |
37-
| Used by | The list of load balancer rules using this specific health probe. You should have at least one rule using the health probe for it to be effective |
37+
| Threshold | Threshold of the health probe. The number of times the health probe needs to succeed or fail in order to allow or deny traffic from being delivered to the virtual machine
38+
| Used by | List of load balancer rules using this health probe. You should have at least one rule using the health probe for it to be effective |
3839

3940
## Probe configuration
4041

@@ -75,6 +76,14 @@ In order to ensure a timely response is received, HTTP/S health probes have buil
7576

7677
For HTTP/S probes, if the configured interval is longer than the above timeout period, the health probe times out and fails if no response is received during the timeout period. For example, if an HTTP health probe is configured with a probe interval of 120 seconds (every 2 minutes), and no probe response is received within the first 30 seconds, the probe reaches its timeout period and fails. When the configured interval is shorter than the above timeout period, the health probe will fail if no response is received before the configured interval period completes and the next probe will be sent immediately.
7778

79+
## Probe threshold
80+
81+
The probe threshold value is the number of times a health probe will need to succeed or fail consecutively in order for the probe to mark a backend instance as healthy or unhealthy, respectively.
82+
83+
For TCP probes, if the probe threshold is configured to 2, the probe will need to receive 2 consecutive responses before a backend instance begins to receive traffic. Similarly, once a backend instance is deemed healthy, 2 consecutive failures or timeouts are required for the instance to be considered unhealthy and stop receiving new traffic.
84+
85+
For HTTP probes, explicit responses will immediately mark the probe as up or down for 200 and non-200 responses, and will effectively reset the threshold. This means that the threshold value only applies to HTTP probes if the probe times out due to no response.
86+
7887
## Design guidance
7988

8089
- When you design the health model for your application, probe a port on a backend endpoint that reflects the health of the instance and the application service. The application port and the probe port aren't required to be the same. In some scenarios, it can be desirable for the probe port to be different than the port your application uses but generally it's recommended that probes use the same port.
@@ -130,4 +139,4 @@ If you don't allow the [source IP](#probe-source-ip-address) of the probe in you
130139
- Learn more about [Standard Load Balancer](./load-balancer-overview.md)
131140
- Learn [how to manage health probes](../load-balancer/manage-probes-how-to.md)
132141
- [Get started creating a public load balancer in Resource Manager by using PowerShell](quickstart-load-balancer-standard-public-powershell.md)
133-
- [REST API for health probes](/rest/api/load-balancer/loadbalancerprobes/)
142+
- [REST API for health probes](/rest/api/load-balancer/loadbalancerprobes/)

0 commit comments

Comments
 (0)