pom:target:http
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
pom:target:http [2012/10/12 08:57] – external edit 127.0.0.1 | pom:target:http [2020/05/26 21:59] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== target_http ====== | ====== target_http ====== | ||
This target will dump part of the HTTP traffic into usable files. It uses the Mime-Type provided by the server and a database in flat file format to match the right files to dump.\\ | This target will dump part of the HTTP traffic into usable files. It uses the Mime-Type provided by the server and a database in flat file format to match the right files to dump.\\ | ||
- | It has the following parameters : | ||
- | * prefix | ||
- | Prefix of the files including the path. For example, a prefix of '/ | ||
- | Default : /tmp/ | ||
- | * decompress | + | Parameters: |
- | Enable gzip/ | + | ^ Name ^ Default value ^ Description ^ |
- | Default | + | |prefix|/ |
+ | |decompress|yes|Enable gzip/ | ||
+ | |mime_types_db|${DATAROOT}/ | ||
+ | |log_file| |Path to the log file. When non empty, target_http will log the requests in this file according in the format described in the parmarameter log_format.| | ||
+ | |log_format|%v %a %u %t " | ||
+ | |ds_log_path| |Path to the datastore. When non empty, target_http will log the requests in the provided datastore according in the format described in the parmarameter ds_log_format. The syntax is < | ||
+ | |ds_log_format|%v %a %u %t %r %s %b|Format of the dataset where logging information will be saved. The table below describe the supported fields. Extra characters will be ignored.| | ||
+ | |dump_img|no|Enable dumping of the image files.| | ||
+ | |dump_vid|no|Enable dumping of the video files.| | ||
+ | |dump_snd|no|Enable dumping of the sound files.| | ||
+ | |dump_txt|no|Enable dumping of the text files.| | ||
+ | |dump_bin|no|Enable dumping of the binary files.| | ||
+ | |dump_doc|no|Enable dumping of the document files.| | ||
- | * mime_types_db | ||
- | Path to the database of mime types. See [[https:// | ||
- | Default : ${DATAROOT}/ | ||
- | |||
- | * log_file | ||
- | Path to the log file. When non empty, target_http will log the requests in this file according in the format described in the parmarameter log_format.\\ | ||
- | Default : empty | ||
- | |||
- | * log_format | ||
- | Format of log lines in the log file. Very similar to the format of apache2' | ||
+ | Expansions for the parameter log_format : | ||
^ Format String ^ Description ^ | ^ Format String ^ Description ^ | ||
- | |%% |The percent sign | | + | |%%|The percent sign.| |
- | |%a |Client IP address | | + | |%a|Client IP address.| |
- | |%A |Server IP address | | + | |%A|Server IP address.| |
- | |%b |Size of response in bytes, excluding HTTP headers | | + | |%b|Size of response in bytes, excluding HTTP headers.| |
- | |%B |Size of response in bytes, excluding HTTP headers in CLF format, i.e. a ' | + | |%B|Size of response in bytes, excluding HTTP headers in CLF format, i.e. a ' |
- | |%D |Time taken to serve the request, in microseconds | | + | |%D|Time taken to serve the request, in microseconds.| |
- | |%f |Name of the file saved on the disk | | + | |%f|Name of the file saved on the disk.| |
- | |%H |Request protocol | | + | |%H|Request protocol.| |
- | |%{Foobar}i |The contents of Foobar: header line(s) in the request sent to the server | | + | |%{Foobar}i|The contents of Foobar: header line(s) in the request sent to the server.| |
- | |%m |Request method | | + | |%m|Request method.| |
- | |%{Foobar}o |The contents of Foobar: header line(s) in the reply | | + | |%{Foobar}o|The contents of Foobar: header line(s) in the reply.| |
- | |%p |Port of the server | | + | |%p|Port of the server.| |
- | |%P |Password of the user querying the server | | + | |%P|Password of the user querying the server.| |
- | |%r |First line of request | | + | |%r|First line of request.| |
- | |%s |Status value | | + | |%s|Status value.| |
- | |%t |Time the request was received | | + | |%t|Time the request was received.| |
- | |%T |Time taken to serve the request in seconds | | + | |%T|Time taken to serve the request in seconds.| |
- | |%u |Username provided when doing the request | | + | |%u|Username provided when doing the request.| |
- | |%U |URL path requested | | + | |%U|URL path requested.| |
- | |%v |Server name (same as %{Host}i) | | + | |%v|Server name (same as %{Host}i).| |
- | + | ||
- | Default : %v %a %u %t " | + | |
- | + | ||
- | * ds_log_path | + | |
- | Path to the datastore. When non empty, target_http will log the requests in the provided datastore according in the format described in the parmarameter ds_log_format. The syntax is < | + | |
- | Default : empty | + | |
- | + | ||
- | * ds_log_format | + | |
- | Format of the dataset where logging information will be saved. The table below describe the supported fields. Extra characters will be ignored.\\ | + | |
- | Default : %v %a %u %t %r %s %b | + | |
+ | Expansions for the parameter ds_log_format : | ||
^ Format String ^ Name used in the dataset ^ Description ^ | ^ Format String ^ Name used in the dataset ^ Description ^ | ||
- | |%a |client_addr |Client IP address | | + | |%a|client_addr|Client IP address.| |
- | |%A |server_addr |Server IP address | | + | |%A|server_addr|Server IP address.| |
- | |%b |response_size |Size of response in bytes, excluding HTTP headers | | + | |%b|response_size|Size of response in bytes, excluding HTTP headers.| |
- | |%D |serv_time_ms |Time taken to serve the request, in microseconds | | + | |%D|serv_time_ms|Time taken to serve the request, in microseconds.| |
- | |%f |filename |Name of the file saved on the disk | | + | |%f|filename|Name of the file saved on the disk.| |
- | |%H |request_proto |Request protocol | | + | |%H|request_proto|Request protocol.| |
- | |%{Foobar}i |hdr_req_< | + | |%{Foobar}i|hdr_req_< |
- | |%m |request_method |Request method | | + | |%m|request_method|Request method.| |
- | |%{Foobar}o |hdr_resp_< | + | |%{Foobar}o|hdr_resp_< |
- | |%p |server_port |Port of the server | | + | |%p|server_port|Port of the server.| |
- | |%P |password |Password of the user querying the server | | + | |%P|password|Password of the user querying the server.| |
- | |%r |request_first_line |First line of request | | + | |%r|request_first_line|First line of request.| |
- | |%s |status |Status value | | + | |%s|status|Status value.| |
- | |%t |request_recvd_time |Time the request was received | | + | |%t|request_recvd_time|Time the request was received.| |
- | |%T |request_elapsed_time |Time taken to serve the request in seconds | | + | |%T|request_elapsed_time|Time taken to serve the request in seconds.| |
- | |%u |username |Username provided when doing the request | | + | |%u|username|Username provided when doing the request.| |
- | |%U |url |URL path requested | | + | |%U|url|URL path requested.| |
- | |%v |server_name |Server name (same as %{Host}i) | | + | |%v|server_name|Server name (same as %{Host}i).| |
- | + | ||
- | * dump_img | + | |
- | Enable dumping of the image files.\\ | + | |
- | Default : no | + | |
- | + | ||
- | * dump_vid | + | |
- | Enable dumping of the video files.\\ | + | |
- | Default : no | + | |
- | + | ||
- | * dump_snd | + | |
- | Enable dumping of the sound files.\\ | + | |
- | Default : no | + | |
- | + | ||
- | * dump_txt | + | |
- | Enable dumping of the text files.\\ | + | |
- | Default : no | + | |
- | + | ||
- | * dump_bin | + | |
- | Enable dumping of the binary files.\\ | + | |
- | Default : no | + | |
- | * dump_doc | ||
- | Enable dumping of the document files.\\ | ||
- | Default : no |
pom/target/http.1350032228.txt.gz · Last modified: 2020/05/26 21:59 (external edit)