CloudConsole

ALB のアイドルタイムアウトと HTTP クライアントのキープアライブ時間

更新日 2026年11月17日 · ガイドの執筆と確認の方法

要点

接続のアイドルタイムアウト(idle_timeout.timeout_seconds)は、その時間データが流れなかったクライアントやターゲットとの接続を閉じます。デフォルトは 60 秒で、1〜4,000 秒を設定できます。HTTP クライアントのキープアライブ時間(client_keep_alive.seconds)はクライアント接続の最大の寿命で、デフォルトは 3,600 秒、60〜604,800 秒を設定できます。ターゲット側のキープアライブのタイムアウトは ALB のアイドルタイムアウトより長くし、アイドルタイムアウトを引き上げるのは、正当に 60 秒を超えて無通信になるリクエストのためだけにしましょう。

タイムライン:ALB のアイドルタイムアウトが作用する場所。クライアント ⇄ ALB の接続:60 秒データなし、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からダウンロード

出典