設定 AWS Blu Age Runtime 的速率限制 - AWS 大型主機現代化
速率限制概觀組態屬性啟用速率限制用戶端識別速率限制標頭記憶體管理

AWS Mainframe Modernization Service （受管執行期環境體驗） 不再向新客戶開放。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱AWS 大型主機現代化可用性變更。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定 AWS Blu Age Runtime 的速率限制

AWS Blu Age Runtime 包含內建速率限制功能，可保護 gapwalk 應用程式免於過度請求和潛在的濫用。速率限制系統使用權杖儲存貯體演算法來提供高載容量和持續速率限制。

速率限制概觀

速率限制系統提供下列功能：

權杖儲存貯體演算法

  • 允許爆量流量達到設定的爆量容量

  • 根據每分鐘請求，以穩定速率補充字符

  • 提供順暢的速率限制，而不會封鎖合法流量峰值

用戶端識別

  • 使用代理支援依 IP 地址識別用戶端

  • 支援 X-Forwarded-For 和 X-Real-IP 標頭

  • 處理負載平衡器和反向代理案例

自動記憶體管理

  • 自動清除過期的速率限制儲存貯體

  • 可設定的清除間隔和到期時間

  • 防止長時間執行應用程式中的記憶體流失

HTTP 整合

  • 超過限制時傳回 HTTP 429 （太多請求）

  • 在回應中包含標準速率限制標頭

  • 提供用戶端的重試後資訊

組態屬性

在 application-main.yaml 檔案中設定速率限制：

gapwalk:
  ratelimiting:
    enabled: true                                        # Enable/disable rate limiting
    requestsPerMinute: 1000                              # Sustained rate limit per minute
    burstCapacity: 1500                                  # Maximum burst requests allowed
    includeHeaders: true                                 # Include X-RateLimit-* headers
    cleanupIntervalMinutes: 5                            # Cleanup interval for expired buckets
    bucketExpiryHours: 1                                 # Hours after which unused buckets expire
    errorMessage: "Too many requests. Try again later."  # Custom error message
    whitelistIps: ""                                     # Comma-separated IPs to bypass limiting
    perEndpointLimiting: false                           # Apply limits per endpoint (not implemented)

屬性描述

已啟用

主切換以啟用或停用速率限制功能。預設：false

requestsPerMinute

允許持續速率限制的每分鐘請求數。這表示字符重新填充率。預設：1000

burstCapacity

在套用速率限制之前，爆量中允許的請求數量上限。應高於 requestsPerMinute以允許流量峰值。預設：1500

includeHeaders

是否要在 HTTP 回應中包含標準速率限制標頭 (X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset)。預設：true

cleanupIntervalMinutes

自動清除過期速率限制儲存貯體之間的間隔，以分鐘為單位。有助於防止記憶體洩漏。預設：5

bucketExpiryHours

未使用的費率限制儲存貯體被視為過期且符合清除資格的時數。預設：1

errorMessage

超過速率限制時，在 JSON 回應中傳回的自訂錯誤訊息。預設："Too many requests. Try again later."

whitelistIps

以逗號分隔的 IP 地址清單，完全略過速率限制。適用於運作狀態檢查或受信任系統。預設：empty

perEndpointLimiting

是否針對每個端點套用個別的速率限制，而不是僅針對每個用戶端套用個別的速率限制。目前未實作。預設：false

啟用速率限制

若要使用預設設定啟用速率限制：

gapwalk:
  ratelimiting:
    enabled: true

用戶端識別

速率限制系統會使用下列優先順序來識別用戶端：

  1. X-Forwarded-For 標頭 （以逗號分隔的第一個 IP)

  2. X-Real-IP 標頭

  3. 來自 HTTP 請求的遠端地址

這可確保應用程式落後時適當的用戶端識別：

  • 負載平衡器

  • 反向代理

  • CDNs

  • API 閘道

用戶端識別範例

# Direct connection
Client IP: 192.168.1.100

# Behind load balancer with X-Forwarded-For
X-Forwarded-For: 203.0.113.45, 192.168.1.100
Client IP: 203.0.113.45 (first IP used)

# Behind reverse proxy with X-Real-IP
X-Real-IP: 203.0.113.45
Client IP: 203.0.113.45

速率限制標頭

啟用 includeHeaders 時，下列標頭會新增至 HTTP 回應：

X-RateLimit-Limit

用戶端的速率限制上限 （每分鐘請求數）

X-RateLimit-Remaining

目前速率限制時段中剩餘的請求數量

X-RateLimit-Reset

速率限制視窗重設的時間 (Unix 時間戳記）

回應標頭範例

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1640995200

超出速率限制的回應

超過速率限制時，系統會傳回：

HTTP 狀態

429 請求過多

內容類型

application/json

之後重試

重試前要等待的秒數

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60,
  "timestamp": 1640995140000
}

記憶體管理

速率限制系統會自動管理記憶體，以防止長時間執行的應用程式發生洩漏：

自動清除

  • 每分鐘執行cleanupIntervalMinutes一次

  • 移除未使用的儲存貯體數bucketExpiryHours小時

  • 記錄用於監控的清除活動

記憶體效率

  • 使用並行資料結構確保執行緒安全

  • 建立延遲儲存貯體 （僅在需要時）

  • 有效率的字符儲存貯體實作

監控清除活動

檢查清除訊息的日誌：

INFO  RateLimitingService - Cleaned up 15 expired rate limiting buckets