status.txt 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
  1. =============
  2. Server Status
  3. =============
  4. ------------------
  5. Module: mod_status
  6. ------------------
  7. :Author: Jan Kneschke
  8. :Date: $Date: 2004/11/03 22:26:05 $
  9. :Revision: $Revision: 1.2 $
  10. :abstract:
  11. mod_status displays the server's status and configuration
  12. .. meta::
  13. :keywords: lighttpd, server status
  14. .. contents:: Table of Contents
  15. Description
  16. ===========
  17. The server status module generates the status overview of the webserver. The
  18. information covers:
  19. - uptime
  20. - average throughput
  21. - current throughput
  22. - active connections and their state
  23. We need to load the module first. ::
  24. server.modules = ( ..., "mod_ssi", ... )
  25. By default the status page is disabled to hide internal information from
  26. unauthorized users. ::
  27. status.status-url = "/server-status"
  28. If you want to open the status page just for users from the local network
  29. cover it in a conditional. ::
  30. $HTTP["remoteip"] == "10.0.0.0/8" {
  31. status.status-url = "/server-status"
  32. }
  33. Or require authorization: ::
  34. auth.require = ( "/server-status" =>
  35. ( "realm" ... ) )
  36. Please note that when using the server.max-worker directive, the status of the
  37. children are not combined yet, so you're going to see different stats with each
  38. request.
  39. Output Format
  40. -------------
  41. By default a nice looking HTML page is generated. If you append ?auto to the
  42. status-url you can get a text version which is simpler to parse. ::
  43. Total Accesses: 1234
  44. Total kBytes: 1043
  45. Uptime: 1234
  46. BusyServers: 123
  47. Total Accesses is the number of handled requests, kBytes the overall outgoing
  48. traffic, Uptime the uptime in seconds and BusyServers the number of currently
  49. active connections.
  50. The naming is kept compatible to Apache even if we have another concept and
  51. don't start new servers for each connection.
  52. Options
  53. =======
  54. status.status-url
  55. relative URL which is used to retrieve the status-page
  56. Default: unset
  57. Example: status.status-url = "/server-status"
  58. status.enable-sort
  59. add JavaScript which allows client-side sorting for the connection overview
  60. Default: enable
  61. status.config-url
  62. relative URL for the config page which displays the loaded modules
  63. Default: unset
  64. Example: status.config-url = "/server-config"
  65. status.statistics-url
  66. relative URL for a plain-text page containing the internal statistics
  67. Default: unset
  68. Example: status.statistics-url = "/server-statistics"