SERVER-STATUS(1) User Contributed Perl Documentation SERVER-STATUS(1)NAMEserver-status - a script to show the status of the local server
SYNOPSIS
% server-status--scoreboardserver-status--counter server-status/access-counter
Total Accesses: 123
BusyWorkers: 2
IdleWorkers: 3
--
pid status remote_addr host method uri protocol ss
20060 A 127.0.0.1 localhost:10001 GET / HTTP/1.1 1
20061 .
20062 A 127.0.0.1 localhost:10001 GET /server-status HTTP/1.1 0
20063 .
20064 .
# JSON format
% server-status--json --counter ~/server-status/access-counter
{"BusyWorkers":"2",
"stats":[
{"protocol":null,"remote_addr":null,"pid":"78639",
"status":".","method":null,"uri":null,"host":null,"ss":null},
{"protocol":"HTTP/1.1","remote_addr":"127.0.0.1","pid":"78640",
"status":"A","method":"GET","uri":"/","host":"localhost:10226","ss":0},
...
],"IdleWorkers":"3"}
DESCRIPTION
This is a simple command-line script that examines the local server
status files to report on the status of a locally-running server,
without incurring any network overhead nor using a worker.
OPTIONS
scoreboard
Required - same as the "scoreboard" option in the middleware.
counter_file
Optional - same as the "counter_file" option in the middleware.
json
Optional - when provided, returns the data in JSON format.
Defaults to false.
skip_ps_command
Optional - when provided, skip executes `ps command`. Please read
perldoc Plack::Middleware::ServerStatus::Lite for details
help|h
Display help
CAVEATS
This script mirrors the middleware's behaviour when the
"skip_ps_command" option is set, because currently we do not know the
server's parent pid (the process where the middleware was originally
loaded, before worker processes are forked off). Therefore, data will
be incomplete if not every worker has yet serviced a request before
this script is run.
AUTHOR
Karen Etheridge <ether {at} cpan.org> Masahiro Nagano <kazeburo {at}
cpan.org>
SEE ALSO
Plack::Middleware::ServerStatus::Lite
LICENSE
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.20.2 2015-08-31 SERVER-STATUS(1)
