Skip to content

Add note clarifying that WAF rate-limit thresholds apply per gateway instance, not gateway-wide - #128641

Open
E-G-C wants to merge 2 commits into
MicrosoftDocs:mainfrom
E-G-C:main
Open

Add note clarifying that WAF rate-limit thresholds apply per gateway instance, not gateway-wide#128641
E-G-C wants to merge 2 commits into
MicrosoftDocs:mainfrom
E-G-C:main

Conversation

@E-G-C

@E-G-C E-G-C commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Clarify the behavior of rate limiting with multiple Application Gateway instances and provide a cautionary note on threshold configuration.

Clarify the behavior of rate limiting with multiple Application Gateway instances and provide a cautionary note on threshold configuration.
@Court72

Court72 commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Trying a close/reopen to nudge the stuck build.

@prmerger-automator

Copy link
Copy Markdown
Contributor

@E-G-C : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@prmerger-automator

Copy link
Copy Markdown
Contributor

@E-G-C : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@Court72
Court72 requested a review from Copilot July 17, 2026 14:43

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Clarifies that WAF rate-limit thresholds on Application Gateway v2 are enforced per gateway instance (when scaled out), not as a single gateway-wide aggregate—helping readers avoid misconfiguring thresholds under autoscaling.

Changes:

  • Adds a NOTE explaining per-instance rate-limit counting under multiple Application Gateway instances.
  • Provides an example showing how requests can bypass a gateway-wide expectation due to distribution across instances.
  • Adds guidance that configured thresholds shouldn’t be treated as strict gateway-wide limits during scale-out.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


The sliding window algorithm blocks all matching traffic for the first window in which the threshold is exceeded, and then throttles traffic in future windows. Use caution when defining thresholds when configuring wide-matching rules with either *GeoLocation* or *None* as the *GroupByVariables*. Incorrectly configured thresholds could lead to frequent short outages for matching traffic.

> [!NOTE]
The sliding window algorithm blocks all matching traffic for the first window in which the threshold is exceeded, and then throttles traffic in future windows. Use caution when defining thresholds when configuring wide-matching rules with either *GeoLocation* or *None* as the *GroupByVariables*. Incorrectly configured thresholds could lead to frequent short outages for matching traffic.

> [!NOTE]
> Depending on its the autoscaling configuration, the Application Gateway v2 can run multiple instances. When multiple instances are active, incoming requests are distributed among them, and each instance maintains its own rate-limit count.

> [!NOTE]
> Depending on its the autoscaling configuration, the Application Gateway v2 can run multiple instances. When multiple instances are active, incoming requests are distributed among them, and each instance maintains its own rate-limit count.
> For example, with a limit of 400 requests per client IP per minute, 500 requests might be divided between two instances as 270 and 230. Neither instance reaches the limit, so the WAF allows the requests even though the combined total exceeds 400.
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 4ae1e59:

✅ Validation status: passed

File Status Preview URL Details
articles/web-application-firewall/ag/rate-limiting-overview.md ✅Succeeded

For more details, please refer to the build report.

@Court72

Court72 commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

@halkazwini

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator Bot added the aq-pr-triaged tracking label for the PR review team label Jul 17, 2026
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 072e651:

✅ Validation status: passed

File Status Preview URL Details
articles/web-application-firewall/ag/rate-limiting-overview.md ✅Succeeded

For more details, please refer to the build report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants