ALB のアイドルタイムアウトと HTTP クライアントのキープアライブ時間
接続のアイドルタイムアウト(idle_timeout.timeout_seconds)は、その時間データが流れなかったクライアントやターゲットとの接続を閉じます。デフォルトは 60 秒で、1〜4,000 秒を設定できます。HTTP クライアントのキープアライブ時間(client_keep_alive.seconds)はクライアント接続の最大の寿命で、デフォルトは 3,600 秒、60〜604,800 秒を設定できます。ターゲット側のキープアライブのタイムアウトは ALB のアイドルタイムアウトより長くし、アイドルタイムアウトを引き上げるのは、正当に 60 秒を超えて無通信になるリクエストのためだけにしましょう。
2 つの設定の仕組み
アイドルタイムアウトは、ロードバランサーの両側、つまりクライアントからの接続と、ALB からターゲットへの接続の両方に適用されます。アイドル期間の間に 1 バイトも送受信されなければ、ALB は接続を閉じます。バックエンドが最初の 1 バイトを送るまで 90 秒かかるリクエストは、デフォルトの 60 秒では 504 で失敗します。HTTP/2 の PING フレームではタイマーはリセットされません。
HTTP クライアントのキープアライブ時間は、1 つのクライアント接続を再利用できる時間の上限です。期限が切れると、ALB はもう 1 つリクエストを受け付けてから接続を正常に閉じます(HTTP/1.x では Connection: close、HTTP/2 では GOAWAY フレーム)。接続を開いたときから始まり、通信があってもリセットされません。値を小さくするとクライアントが早く再接続するため、ゾーンシフトや IP アドレスの変更のあとで通信を移しやすくなります。
推奨値
| 状況 | アイドルタイムアウト | クライアントのキープアライブ |
|---|---|---|
| 一般的な API や Web アプリ | 60 秒(デフォルト) | 3,600 秒(デフォルト) |
| 60 秒を超える間隔でストリーミングやロングポーリングを行うエンドポイント | 最長の無通信の間隔に余裕を加えた値(たとえば 120〜300 秒) | デフォルト |
| ALB を通る大きなアップロード | 最も遅いクライアントのチャンクの間隔より長く | デフォルト |
| WebSocket / Server-Sent Events | ハートビートの間隔より長く。大きく引き上げる代わりに、30〜50 秒ごとにハートビートを送る | デフォルト |
| ゾーンシフトや頻繁な IP の変更を使う場合 | デフォルト | 小さく、たとえば 300〜900 秒 |
どの値を選んでも、ターゲットのキープアライブのタイムアウトは ALB のアイドルタイムアウトより長くなければなりません。アプリケーションが先にアイドル状態の接続を閉じると、ALB がすでに閉じかけているソケットにリクエストを送り、クライアントに 502 Bad Gateway を返すことがあります。典型的な対処:
- Node.js:60 秒の ALB なら
server.keepAliveTimeout = 65000とserver.headersTimeout = 66000。 - Gunicorn:
--keep-alive 65、nginx:keepalive_timeout 65s;、Apache:KeepAliveTimeout 65。
変更する
コンソール:EC2 の「ロードバランサー」で ALB を選び、「属性」、「編集」を開き、トラフィックの設定にある「接続のアイドルタイムアウト」と「HTTP クライアントのキープアライブ時間」を設定します。
CLI:
aws elbv2 modify-load-balancer-attributes \
--load-balancer-arn arn:aws:elasticloadbalancing:eu-west-2:123456789012:loadbalancer/app/web/50dc6c495c0c9188 \
--attributes Key=idle_timeout.timeout_seconds,Value=120 Key=client_keep_alive.seconds,Value=3600
aws elbv2 describe-load-balancer-attributes \
--load-balancer-arn arn:aws:elasticloadbalancing:eu-west-2:123456789012:loadbalancer/app/web/50dc6c495c0c9188 \
--query "Attributes[?starts_with(Key,'idle_timeout') || starts_with(Key,'client_keep_alive')]"CloudFormation:AWS::ElasticLoadBalancingV2::LoadBalancer の LoadBalancerAttributes にエントリを追加します:
LoadBalancerAttributes:
- Key: idle_timeout.timeout_seconds
Value: "120"
- Key: client_keep_alive.seconds
Value: "3600"Terraform:aws_lb の idle_timeout と client_keep_alive の引数。
誤った設定の症状
| 症状 | 考えられる原因 |
|---|---|
| 遅いエンドポイントで、ちょうどアイドルタイムアウトの時間に 504 | バックエンドの無通信がアイドルタイムアウトより長い |
| 低頻度でランダムな 502、静かな時間のあとに多い | ターゲットのキープアライブが ALB のアイドルタイムアウトより短い |
アクセスログで、ターゲットの処理時間が -1 の ELB 5xx | ターゲットが接続を閉じた、またはリセットした |
| タイムアウトを引き上げたあと、ターゲットにアイドル状態の接続が多い | アイドルタイムアウトを必要よりはるかに大きく設定した |
| シフト後も、クライアントが障害の起きたゾーンにアクセスし続ける | クライアントのキープアライブが長い |
詳しい診断は ALB 502 (EN) と ALB 504 (EN) を参照してください。
よくある質問
Application Load Balancer のデフォルトのアイドルタイムアウトは?
60 秒です。idle_timeout.timeout_seconds 属性で 1〜4,000 秒に設定できます。
ALB のアイドルタイムアウトとキープアライブの違いは?
アイドルタイムアウトは、データのない期間が続いた接続を閉じます。HTTP クライアントのキープアライブ時間は、通信の有無にかかわらずクライアント接続の寿命の合計に上限をかけ、デフォルトは 3,600 秒です。
Terraform で ALB のアイドルタイムアウトを設定するには?
aws_lb リソースの idle_timeout 引数を使います。client_keep_alive でキープアライブ時間を設定します。
キープアライブの不一致による断続的な 502 は、狙って再現するのが困難です。AWS 用のスマホアプリ CloudConsole は、ロードバランサーの 5xx アラームをスマホで確認し、デプロイや通信量と照らし合わせられるよう開発中です。
アプリについて → · App Storeからダウンロード