Pumaでの設定

persistent_timeout(seconds) - Pumaが持続的接続を閉じるまでのアイドル時間を定義します。seconds(秒数)には、整数を指定します。

first_data_timeout(seconds) - データが受信されなかった場合に、TCPソケットを開けている時間を定義します。seconds(秒数)には、整数を指定します。

*force_shutdown_after(val=:forever) * - スレッドをシャットダウンする際に、スレッドが停止するまで待機する時間を定義します。秒数も指定することができますが、:foreverもしくは:immediatelyを指定できます。

worker_timeout(seconds) - 指定したタイムアウト(秒数)内に、全てのワーカがマスタプロセスにチェックインしたかどうかを検証します。これはリクエストのタイムアウトではなく、プロセスの停止やハングアップを防ぐためのものです。この値を設定しても、時間の掛かるリクエストを防げるわけではありません。最小値は6秒、デフォルト値は60秒です。

worker_boot_timeout(seconds) - ワーカが起動する際のデフォルトのタイムアウトを変更します。指定されていない場合は、デフォルトはworker_timeoutの値になります。

worker_shutdown_timeout(seconds) - ワーカがシャットダウンする際のタイムアウトを設定します。

wait_for_less_busy_worker(val=0.005) - ソケットのリッスンを遅らせることにより、ビジーでないワーカにトラフィックをルーティングし、リクエストを最初に取得してもらうための待ち時間です。

DefaultWorkerTimeout = 60

DefaultWorkerShutdownTimeout = 30

クラスタモードはpreload_appと互換性がありません。

新しいワーカを正常にフォークするために、ワーカ0はサーバをシャットダウンし、リクエストの処理を停止します。これにより、プロセス間で共有されてオープン中のファイル記述子やその他のグローバルな共有状態がなくなり、新しくフォークされたワーカ間でコピーオンライト(COW)の効率が最大化されます。このため、段階的な再起動/リフォーク中にクラスタの総処理能力が一時的に減少する場合があります。

*workers(count) * - 実行するワーカプロセスの数。通常、使用可能なCPUコア数を設定します。 環境変数WEB_CONCURRENCYに値が設定されている場合は、それがデフォルトです。それ以外の場合は0です。

before_fork(&block) - マスタプロセスがワーカをフォークする前に実行(起動時に1回)するコード。プロセスが終了する前に、Pumaが関与しないバックグラウンド操作が終了するのを待機する必要がある場合に指定します。

on_worker_boot(&block) - アプリを起動する前にプロセスをセットアップするために、ワーカの起動時に実行するコード。

on_worker_shutdown(&block) - ワーカがシャットダウンする直前(HTTPリクエストの処理が完了した後)に実行するコード。

on_worker_fork(&block) - ワーカが起動する直前にマスタプロセスで実行するコード。ワーカのインデックスが引数として渡されます。

after_worker_fork(&block) - ワーカが起動された後にマスタプロセスで実行するコード。ワーカのインデックスが引数として渡されます。

on_refork(&block) - サーバがリクエストの受付けを一時的に停止した後、ワーカ0が他の全てのワーカをこのプロセスからリフォークする前に実行するコード(リフォークごとに1回呼び出されます)。コピーオンライト(COW)の効率を最大化するために追加のガベージコレクションのトリガとして使用できます。また、リモートサーバ（データベース、Redisなど)との接続を閉じるためにも使用できます。

out_of_band(&block) - ワーカがアイドル状態の時に不定期に実行されるコード。リクエスト処理が終わりワーカにビジー状態のスレッドが存在しなくなった直後に実行されます。このコードが終了するまで、ワーカは新しいリクエストを受付けません。これは、不定期のガベージコレクションを実行したり、レスポンスの後に実行する非同期タスクをスケジュールする場合に便利です。

fork_worker(after_request=1000) - この設定を有効にすると、ワーカはマスタプロセスからではなくワーカ0からフォークされます。このオプションは、アプリケーションがフォークする前にプリロードされるため"preload_app"に似ていますが、段階的な再起動と互換性があります。このオプションでreforkコマンドも有効になります。

nakayoshi_fork(enabled=true) - これは少し異なるオプションですが、ワーカをフォークする前にPumaが4回GC(ガベージコレクション)を実行します。起動とフォークの所要時間が長くなります。起動処理にかかる時間の詳細については、ログを参照してください。ほとんどのアプリケーションでは1秒以下になると考えられます。このフォーク方法は、笹田耕一氏とAaron Patterson氏の研究に基づいており、このオプションはプリロードを有効にしたクラスタモードのPumaのメモリ使用量を削減できる可能性があります。

Rubyエージェントの設定

Rubyエージェントのサポート対象テクノロジ