---
name: ap22-mod_log_firstbyte
version: 1.01_1
origin: www/mod_log_firstbyte
comment: Log the time between request and the first byte of the response served
arch: freebsd:9:x86:64
www: http://code.google.com/p/mod-log-firstbyte/
maintainer: apache@FreeBSD.org
prefix: /usr/local
licenselogic: single
flatsize: 9455
desc: |
  Ever tried logging Apache page serve times using '%25D'? You'll have discovered
  that they aren't a good index of your server's performance, because they depend
  more on the client's connection speed, computer and browsing habits than on the
  speed of your server.

  mod_log_firstbyte is a module for Apache 2.0 which allows you to log the time
  between each request being read and the first byte of the response served.
  Unlike the total serve time, this index of performance tells you how long Apache
  actually spent loading the file off the disk or executing your script: it's
  independent of client connection speed. It makes a great performance benchmark
  for your server!

  WWW: http://code.google.com/p/mod-log-firstbyte/
deps:
  apache22: {origin: www/apache22, version: 2.2.25}
  expat: {origin: textproc/expat2, version: 2.1.0}
  perl: {origin: lang/perl5.14, version: 5.14.4}
  pcre: {origin: devel/pcre, version: 8.33}
  gettext: {origin: devel/gettext, version: 0.18.3}
  apr: {origin: devel/apr1, version: 1.4.8.1.5.2}
  gdbm: {origin: databases/gdbm, version: 1.10}
  db42: {origin: databases/db42, version: 4.2.52_5}
  libiconv: {origin: converters/libiconv, version: 1.14_1}
categories:
- www
shlibs_provided:
- mod_log_firstbyte.so
message: "Compile and install the module using apxs2, e.g.\r\n\r\napxs2 -c mod_log_firstbyte.c\r\napxs2
  -i -a mod_log_firstbyte.la\r\n\r\nThis will add a line to your configuration file
  to load the module:\r\n\r\nLoadModule log_firstbyte_module /path/to/mod_log_firstbyte.so\r\n\r\nThe
  module adds a new option to your log format string: '%25F'. This is the request-to-first-byte
  time, in microseconds. Edit your configuration files to include a new LogFormat
  directive. I usually use:\r\n\r\nLogFormat \"%25h %25l %25u %25t \\\"%25r\\\" %25>s
  %25b \\\"%25{Referer}i\\\" \\\"%25{User-Agent}i\\\" %25D %25F\" combined-with-firstbyte\r\n\r\nFinally,
  change the CustomLog directive:\r\n\r\nCustomLog /var/log/apache2/access.log combined-with-firstbyte\r\n"
