mod_http_debug

This module returns some info about HTTP requests as Prosody sees them from an endpoint like http://xmpp.example.net:5281/debug. This can be used to validate reverse-proxy configuration and similar use cases.

Example

$ curl -sSf  https://xmpp.example.net:5281/debug | json_pp
{
   "body" : "",
   "headers" : {
      "accept" : "*/*",
      "host" : "xmpp.example.net:5281",
      "user_agent" : "curl/7.74.0"
   },
   "httpversion" : "1.1",
   "id" : "jmFROQKoduU3",
   "ip" : "127.0.0.1",
   "method" : "GET",
   "path" : "/debug",
   "secure" : true,
   "url" : {
      "path" : "/debug"
   }
}

Configuration

HTTP Methods handled can be configured via the http_debug_methods setting. By default, the most common methods are already enabled.

http_debug_methods = { "GET"; "HEAD"; "DELETE"; "OPTIONS"; "PATCH"; "POST"; "PUT" };

Installation

With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server=https://modules.prosody.im/rocks/ mod_http_debug

For earlier versions see the documentation for installing 3rd party modules

Latest changes