2017-05-12 15:16:55 -04:00
|
|
|
require_relative "helper"
|
2011-11-22 00:15:40 -05:00
|
|
|
|
2016-11-22 10:05:49 -05:00
|
|
|
require "puma/cli"
|
|
|
|
|
|
|
|
class TestCLI < Minitest::Test
|
2011-11-22 00:15:40 -05:00
|
|
|
def setup
|
2012-07-05 16:38:06 -04:00
|
|
|
@environment = 'production'
|
2011-12-05 14:15:44 -05:00
|
|
|
@tmp_file = Tempfile.new("puma-test")
|
|
|
|
@tmp_path = @tmp_file.path
|
|
|
|
@tmp_file.close!
|
|
|
|
|
|
|
|
@tmp_path2 = "#{@tmp_path}2"
|
|
|
|
|
|
|
|
File.unlink @tmp_path if File.exist? @tmp_path
|
|
|
|
File.unlink @tmp_path2 if File.exist? @tmp_path2
|
2013-07-05 19:54:15 -04:00
|
|
|
|
|
|
|
@wait, @ready = IO.pipe
|
|
|
|
|
2016-02-03 15:06:00 -05:00
|
|
|
@events = Puma::Events.strings
|
2013-07-05 19:54:15 -04:00
|
|
|
@events.on_booted { @ready << "!" }
|
|
|
|
end
|
|
|
|
|
|
|
|
def wait_booted
|
|
|
|
@wait.sysread 1
|
2011-12-05 14:15:44 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
def teardown
|
|
|
|
File.unlink @tmp_path if File.exist? @tmp_path
|
|
|
|
File.unlink @tmp_path2 if File.exist? @tmp_path2
|
2013-07-05 19:54:15 -04:00
|
|
|
|
|
|
|
@wait.close
|
|
|
|
@ready.close
|
2011-11-22 00:15:40 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
def test_pid_file
|
2011-12-05 14:15:44 -05:00
|
|
|
cli = Puma::CLI.new ["--pidfile", @tmp_path]
|
2016-02-06 22:00:29 -05:00
|
|
|
cli.launcher.write_pid
|
2011-11-22 00:15:40 -05:00
|
|
|
|
2011-12-05 14:15:44 -05:00
|
|
|
assert_equal File.read(@tmp_path).strip.to_i, Process.pid
|
|
|
|
end
|
|
|
|
|
2012-06-21 12:01:18 -04:00
|
|
|
def test_control_for_tcp
|
|
|
|
url = "tcp://127.0.0.1:9877/"
|
|
|
|
cli = Puma::CLI.new ["-b", "tcp://127.0.0.1:9876",
|
|
|
|
"--control", url,
|
|
|
|
"--control-token", "",
|
2017-04-11 17:08:18 -04:00
|
|
|
"test/rackup/lobster.ru"], @events
|
2013-07-05 19:54:15 -04:00
|
|
|
|
2012-06-21 12:01:18 -04:00
|
|
|
t = Thread.new do
|
2016-09-05 14:28:52 -04:00
|
|
|
Thread.current.abort_on_exception = true
|
|
|
|
cli.run
|
2015-03-13 19:08:07 -04:00
|
|
|
end
|
2012-06-21 12:01:18 -04:00
|
|
|
|
2013-07-05 19:54:15 -04:00
|
|
|
wait_booted
|
2012-06-21 12:01:18 -04:00
|
|
|
|
|
|
|
s = TCPSocket.new "127.0.0.1", 9877
|
|
|
|
s << "GET /stats HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read
|
2017-12-11 16:05:36 -05:00
|
|
|
assert_equal '{ "backlog": 0, "running": 0 }', body.split(/\r?\n/).last
|
Expose top level Puma.stats API
Right now to get stats for a puma process the only way is to go through the control server. The puma-stats-logger does this by reading in a state file then querying the control server manually.
https://github.com/hired/puma-stats-logger/blob/7ad7798e9d06ff44e047ac56d0307c4ff9c73751/lib/puma_stats_logger/middleware.rb#L28
Instead, I’m proposing adding a top level `Puma.stats` method that will allow anyone inside of the same process to get access to the stats.
This could be instrumented by a gem to theoretically export these stats to say a Heroku dashboard where we could list out backlog or thread count.
The format of stats is a hash, and will change depending on if the server is in “single” or “clustered” mode.
Clustered:
```
{ "workers": 2, "phase": 0, "booted_workers": 2, "old_workers": 0, "worker_status": [{ "pid": 19832, "index": 0, "phase": 0, "booted": true, "last_checkin": "2018-03-12T16:03:12Z", "last_status": { "backlog":0, "running":5 } },{ "pid": 19833, "index": 1, "phase": 0, "booted": true, "last_checkin": "2018-03-12T16:03:12Z", "last_status": { "backlog":0, "running":5 } }] }
```
Single:
```
{ "backlog": 0, "running": 2 }
```
Alternatively if we could somehow enable another process to get these stats from Puma via pumactl by default without requiring any additional in app config, that would also work.
2018-03-12 12:41:39 -04:00
|
|
|
assert_equal '{ "backlog": 0, "running": 0 }', Puma.stats
|
2012-06-21 12:01:18 -04:00
|
|
|
|
2016-02-06 22:00:29 -05:00
|
|
|
cli.launcher.stop
|
2012-06-21 12:01:18 -04:00
|
|
|
t.join
|
|
|
|
end
|
|
|
|
|
2016-11-22 19:27:30 -05:00
|
|
|
unless Puma.jruby? || Puma.windows?
|
2016-02-18 14:35:14 -05:00
|
|
|
def test_control_clustered
|
|
|
|
url = "unix://#{@tmp_path}"
|
|
|
|
|
|
|
|
cli = Puma::CLI.new ["-b", "unix://#{@tmp_path2}",
|
|
|
|
"-t", "2:2",
|
|
|
|
"-w", "2",
|
|
|
|
"--control", url,
|
|
|
|
"--control-token", "",
|
2017-04-11 17:08:18 -04:00
|
|
|
"test/rackup/lobster.ru"], @events
|
2016-02-18 14:35:14 -05:00
|
|
|
|
|
|
|
t = Thread.new { cli.run }
|
|
|
|
t.abort_on_exception = true
|
|
|
|
|
|
|
|
wait_booted
|
|
|
|
|
2016-09-05 14:28:52 -04:00
|
|
|
sleep 2
|
|
|
|
|
2016-02-18 14:35:14 -05:00
|
|
|
s = UNIXSocket.new @tmp_path
|
|
|
|
s << "GET /stats HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read
|
|
|
|
|
2016-09-05 14:28:52 -04:00
|
|
|
require 'json'
|
|
|
|
status = JSON.parse(body.split("\n").last)
|
|
|
|
|
|
|
|
assert_equal 2, status["workers"]
|
2016-02-18 14:35:14 -05:00
|
|
|
|
|
|
|
# wait until the first status ping has come through
|
|
|
|
sleep 6
|
|
|
|
s = UNIXSocket.new @tmp_path
|
|
|
|
s << "GET /stats HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read
|
|
|
|
assert_match(/\{ "workers": 2, "phase": 0, "booted_workers": 2, "old_workers": 0, "worker_status": \[\{ "pid": \d+, "index": 0, "phase": 0, "booted": true, "last_checkin": "[^"]+", "last_status": \{ "backlog":0, "running":2 \} \},\{ "pid": \d+, "index": 1, "phase": 0, "booted": true, "last_checkin": "[^"]+", "last_status": \{ "backlog":0, "running":2 \} \}\] \}/, body.split("\r\n").last)
|
|
|
|
|
|
|
|
cli.launcher.stop
|
|
|
|
t.join
|
|
|
|
end
|
|
|
|
|
2011-12-06 17:56:38 -05:00
|
|
|
def test_control
|
2011-12-05 14:15:44 -05:00
|
|
|
url = "unix://#{@tmp_path}"
|
|
|
|
|
2011-12-07 13:46:36 -05:00
|
|
|
cli = Puma::CLI.new ["-b", "unix://#{@tmp_path2}",
|
|
|
|
"--control", url,
|
|
|
|
"--control-token", "",
|
2017-04-11 17:08:18 -04:00
|
|
|
"test/rackup/lobster.ru"], @events
|
2011-12-05 14:15:44 -05:00
|
|
|
|
|
|
|
t = Thread.new { cli.run }
|
2016-01-14 10:41:55 -05:00
|
|
|
t.abort_on_exception = true
|
2011-12-05 14:15:44 -05:00
|
|
|
|
2013-07-05 19:54:15 -04:00
|
|
|
wait_booted
|
2011-12-05 14:15:44 -05:00
|
|
|
|
|
|
|
s = UNIXSocket.new @tmp_path
|
|
|
|
s << "GET /stats HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read
|
|
|
|
|
|
|
|
assert_equal '{ "backlog": 0, "running": 0 }', body.split("\r\n").last
|
|
|
|
|
2016-02-06 22:00:29 -05:00
|
|
|
cli.launcher.stop
|
2011-12-05 14:15:44 -05:00
|
|
|
t.join
|
|
|
|
end
|
|
|
|
|
2011-12-06 17:56:38 -05:00
|
|
|
def test_control_stop
|
2011-12-05 14:15:44 -05:00
|
|
|
url = "unix://#{@tmp_path}"
|
|
|
|
|
2011-12-07 13:46:36 -05:00
|
|
|
cli = Puma::CLI.new ["-b", "unix://#{@tmp_path2}",
|
|
|
|
"--control", url,
|
|
|
|
"--control-token", "",
|
2017-04-11 17:08:18 -04:00
|
|
|
"test/rackup/lobster.ru"], @events
|
2011-12-05 14:15:44 -05:00
|
|
|
|
|
|
|
t = Thread.new { cli.run }
|
2016-01-14 10:41:55 -05:00
|
|
|
t.abort_on_exception = true
|
2011-12-05 14:15:44 -05:00
|
|
|
|
2013-07-05 19:54:15 -04:00
|
|
|
wait_booted
|
2011-12-05 14:15:44 -05:00
|
|
|
|
|
|
|
s = UNIXSocket.new @tmp_path
|
|
|
|
s << "GET /stop HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read
|
|
|
|
|
|
|
|
assert_equal '{ "status": "ok" }', body.split("\r\n").last
|
|
|
|
|
|
|
|
t.join
|
|
|
|
end
|
|
|
|
|
2017-08-03 17:46:49 -04:00
|
|
|
def test_control_gc_stats
|
|
|
|
url = "unix://#{@tmp_path}"
|
|
|
|
|
|
|
|
cli = Puma::CLI.new ["-b", "unix://#{@tmp_path2}",
|
|
|
|
"--control", url,
|
|
|
|
"--control-token", "",
|
|
|
|
"test/rackup/lobster.ru"], @events
|
|
|
|
|
|
|
|
t = Thread.new { cli.run }
|
|
|
|
t.abort_on_exception = true
|
|
|
|
|
|
|
|
wait_booted
|
|
|
|
|
|
|
|
s = UNIXSocket.new @tmp_path
|
|
|
|
s << "GET /gc-stats HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read
|
|
|
|
s.close
|
|
|
|
|
|
|
|
lines = body.split("\r\n")
|
|
|
|
json_line = lines.detect { |l| l[0] == "{" }
|
|
|
|
pairs = json_line.scan(/\"[^\"]+\": [^,]+/)
|
|
|
|
gc_stats = {}
|
|
|
|
pairs.each do |p|
|
|
|
|
p =~ /\"([^\"]+)\": ([^,]+)/ || raise("Can't parse #{p.inspect}!")
|
|
|
|
gc_stats[$1] = $2
|
|
|
|
end
|
|
|
|
gc_count_before = gc_stats["count"].to_i
|
|
|
|
|
|
|
|
s = UNIXSocket.new @tmp_path
|
|
|
|
s << "GET /gc HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read # Ignored
|
|
|
|
s.close
|
|
|
|
|
|
|
|
s = UNIXSocket.new @tmp_path
|
|
|
|
s << "GET /gc-stats HTTP/1.0\r\n\r\n"
|
|
|
|
body = s.read
|
|
|
|
s.close
|
|
|
|
lines = body.split("\r\n")
|
|
|
|
json_line = lines.detect { |l| l[0] == "{" }
|
|
|
|
pairs = json_line.scan(/\"[^\"]+\": [^,]+/)
|
|
|
|
gc_stats = {}
|
|
|
|
pairs.each do |p|
|
|
|
|
p =~ /\"([^\"]+)\": ([^,]+)/ || raise("Can't parse #{p.inspect}!")
|
|
|
|
gc_stats[$1] = $2
|
|
|
|
end
|
|
|
|
gc_count_after = gc_stats["count"].to_i
|
|
|
|
|
|
|
|
# Hitting the /gc route should increment the count by 1
|
|
|
|
assert_equal gc_count_before + 1, gc_count_after
|
|
|
|
|
|
|
|
cli.launcher.stop
|
|
|
|
t.join
|
|
|
|
end
|
|
|
|
|
2011-12-06 17:56:38 -05:00
|
|
|
def test_tmp_control
|
2011-12-05 14:32:18 -05:00
|
|
|
url = "tcp://127.0.0.1:8232"
|
2011-12-06 17:56:38 -05:00
|
|
|
cli = Puma::CLI.new ["--state", @tmp_path, "--control", "auto"]
|
2016-02-06 22:00:29 -05:00
|
|
|
cli.launcher.write_state
|
2011-12-05 14:32:18 -05:00
|
|
|
|
2012-01-08 15:46:10 -05:00
|
|
|
data = YAML.load File.read(@tmp_path)
|
2011-12-05 14:32:18 -05:00
|
|
|
|
|
|
|
assert_equal Process.pid, data["pid"]
|
|
|
|
|
2016-02-06 22:00:29 -05:00
|
|
|
url = data["control_url"]
|
2011-12-05 14:32:18 -05:00
|
|
|
|
|
|
|
m = %r!unix://(.*)!.match(url)
|
|
|
|
|
|
|
|
assert m, "'#{url}' is not a URL"
|
|
|
|
end
|
2012-04-30 19:44:03 -04:00
|
|
|
|
2015-12-10 03:01:47 -05:00
|
|
|
def test_state_file_callback_filtering
|
2016-02-04 10:49:01 -05:00
|
|
|
cli = Puma::CLI.new [ "--config", "test/config/state_file_testing_config.rb",
|
2015-12-10 03:01:47 -05:00
|
|
|
"--state", @tmp_path ]
|
2016-02-06 22:00:29 -05:00
|
|
|
cli.launcher.write_state
|
2015-12-10 03:01:47 -05:00
|
|
|
|
2016-11-22 10:05:49 -05:00
|
|
|
data = YAML.load_file(@tmp_path)
|
2015-12-10 03:01:47 -05:00
|
|
|
|
|
|
|
keys_not_stripped = data.keys & Puma::CLI::KEYS_NOT_TO_PERSIST_IN_STATE
|
|
|
|
assert_empty keys_not_stripped
|
|
|
|
end
|
|
|
|
|
2016-01-28 00:08:04 -05:00
|
|
|
end # JRUBY or Windows
|
|
|
|
|
|
|
|
def test_state
|
|
|
|
url = "tcp://127.0.0.1:8232"
|
|
|
|
cli = Puma::CLI.new ["--state", @tmp_path, "--control", url]
|
2016-02-06 22:00:29 -05:00
|
|
|
cli.launcher.write_state
|
2016-01-28 00:08:04 -05:00
|
|
|
|
|
|
|
data = YAML.load File.read(@tmp_path)
|
|
|
|
|
|
|
|
assert_equal Process.pid, data["pid"]
|
2016-02-06 22:00:29 -05:00
|
|
|
assert_equal url, data["control_url"]
|
2016-01-28 00:08:04 -05:00
|
|
|
end
|
|
|
|
|
2012-04-30 19:44:03 -04:00
|
|
|
def test_load_path
|
2018-03-12 12:41:03 -04:00
|
|
|
Puma::CLI.new ["--include", 'foo/bar']
|
2012-04-30 19:44:03 -04:00
|
|
|
|
|
|
|
assert_equal 'foo/bar', $LOAD_PATH[0]
|
|
|
|
$LOAD_PATH.shift
|
|
|
|
|
2018-03-12 12:41:03 -04:00
|
|
|
Puma::CLI.new ["--include", 'foo/bar:baz/qux']
|
2012-04-30 19:44:03 -04:00
|
|
|
|
|
|
|
assert_equal 'foo/bar', $LOAD_PATH[0]
|
|
|
|
$LOAD_PATH.shift
|
|
|
|
assert_equal 'baz/qux', $LOAD_PATH[0]
|
|
|
|
$LOAD_PATH.shift
|
|
|
|
end
|
2012-07-05 16:38:06 -04:00
|
|
|
|
|
|
|
def test_environment
|
2016-02-06 22:00:29 -05:00
|
|
|
ENV.delete 'RACK_ENV'
|
|
|
|
|
|
|
|
Puma::CLI.new ["--environment", @environment]
|
2012-07-05 16:38:06 -04:00
|
|
|
|
2015-03-13 19:08:07 -04:00
|
|
|
assert_equal ENV['RACK_ENV'], @environment
|
2012-07-05 16:38:06 -04:00
|
|
|
end
|
2011-11-22 00:15:40 -05:00
|
|
|
end
|