about summary refs log tree commit homepage
path: root/examples/public-inbox.psgi
diff options
context:
space:
mode:
Diffstat (limited to 'examples/public-inbox.psgi')
-rw-r--r--examples/public-inbox.psgi10
1 files changed, 10 insertions, 0 deletions
diff --git a/examples/public-inbox.psgi b/examples/public-inbox.psgi
index 0d11c19f..f5749122 100644
--- a/examples/public-inbox.psgi
+++ b/examples/public-inbox.psgi
@@ -3,6 +3,8 @@
 # License: AGPLv3 or later (https://www.gnu.org/licenses/agpl-3.0.txt)
 # Note: this is part of our test suite, update t/plack.t if this changes
 # Usage: plackup [OPTIONS] /path/to/this/file
+# A startup command for development which monitors changes:
+#        plackup -I lib -o 127.0.0.1 -R lib -r examples/public-inbox.psgi
 use strict;
 use warnings;
 use PublicInbox::WWW;
@@ -22,6 +24,7 @@ builder {
         };
         $@ and warn
 "Plack::Middleware::Deflater missing, bandwidth will be wasted\n";
+
         # Enable to ensure redirects and Atom feed URLs are generated
         # properly when running behind a reverse proxy server which
         # sets X-Forwarded-For and X-Forwarded-Proto request headers.
@@ -31,6 +34,13 @@ builder {
 "Plack::Middleware::ReverseProxy missing,\n",
 "URL generation for redirects may be wrong if behind a reverse proxy\n";
 
+        # Optional: Log timing information for requests to track performance.
+        # Logging to STDOUT is recommended since public-inbox-httpd knows
+        # how to reopen it via SIGUSR1 after log rotation.
+        # enable 'AccessLog::Timed',
+        #        logger => sub { syswrite(STDOUT, $_[0]) },
+        #        format => '%t "%r" %>s %b %D';
+
         enable 'Head';
         sub { $www->call(@_) };
 }