prosody-modules: mod_http_debug/README.md annotate

annotate mod_http_debug/README.md @ 5585:5b316088bef5

mod_rest: Use logger of HTTP request in trunk In Prosody trunk rev c975dafa4303 each HTTP request gained its own log sink, to make it easy to log things related to each request and group those messages. Especially where async is used, spreading the request and response apart as mod_rest does with iq stanzas, this grouped logging should help find related messages.

author	Kim Alvefur <zash@zash.se>
date	Fri, 07 Jul 2023 00:10:37 +0200
parents	91564b57e595
children

rev	line source
5489 a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	1 ---
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	2 summary: HTTP module returning info about requests for debugging
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	3 ---
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	4
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	5 This module returns some info about HTTP requests as Prosody sees them
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	6 from an endpoint like `http://xmpp.example.net:5281/debug`. This can be
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	7 used to validate [reverse-proxy configuration][doc:http] and similar use
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	8 cases.
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	9
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	10 # Example
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	11
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	12 ```
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	13 $ curl -sSf https://xmpp.example.net:5281/debug \| json_pp
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	14 {
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	15 "body" : "",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	16 "headers" : {
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	17 "accept" : "/",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	18 "host" : "xmpp.example.net:5281",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	19 "user_agent" : "curl/7.74.0"
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	20 },
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	21 "httpversion" : "1.1",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	22 "id" : "jmFROQKoduU3",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	23 "ip" : "127.0.0.1",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	24 "method" : "GET",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	25 "path" : "/debug",
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	26 "secure" : true,
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	27 "url" : {
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	28 "path" : "/debug"
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	29 }
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	30 }
a7188eb4ded4 mod_http_debug: Add a brief README Kim Alvefur <zash@zash.se> parents: diff changeset	31 ```
5490 91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	32
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	33 # Configuration
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	34
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	35 HTTP Methods handled can be configured via the `http_debug_methods`
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	36 setting. By default, the most common methods are already enabled.
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	37
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	38 ```lua
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	39 http_debug_methods = { "GET"; "HEAD"; "DELETE"; "OPTIONS"; "PATCH"; "POST"; "PUT" };
91564b57e595 mod_http_debug: Handle more HTTP methods Kim Alvefur <zash@zash.se> parents: 5489 diff changeset	40 ```

Mercurial > prosody-modules

annotate mod_http_debug/README.md @ 5585:5b316088bef5