The Request Log Parser is invoked as follows:
reqlogparser [--flags] request.log [request2.log...]
where
request.log is a relative or absolute path to the
MDEX Engine request log file to analyze. Multiple log files may be analyzed in
a single run by specifying filenames in space-separated list form.
The Request Log Parser will write resulting parsed entries to standard output. To save results to a file, simply redirect standard output to a file.
If a filename is "-", then the request log is read from stdin. The "-" can be used in combination with other filenames but only one filename may be "-".
Per-file progress messages and a post-analysis summary message will be
written to standard error unless the
--silent flag is specified.
The Request Log Parser supports the following flags:
--filter <parameter_list>: strip the specified query parameters and their values out of log entries. Parameters must be specified as a comma-separated list (e.g., "nbins,offset").--input <number>: specifies the number of entries to process. If not specified, the Request Log Parser will process all entries in the specified input files.--keep-content-length: if specified, will retain any “Content-Length” HTTP headers in MDEX Engine 6.x entries. These entries are removed by default.--keep-ir: if specified, will retain any irversion parameters found in entries. The irversion is an optional parameter sometimes specified by queries to indicate a particular version of the Endeca IAP. But this parameter often makes log entries less portable across versions, so by default the Request Log Parser removes it.--noerrors: removes entries with HTTP status codes 4xx (client errors) or 5xx (server errors). Equivalent to using both the --no-client-errors and --no-server-errors flags (both described below).--no-client-errors: removes entries with HTTP status codes 4xx (client errors).--no-server-errors: removes entries with HTTP status codes 5xx (server errors).--output <number>: specifies the number of valid entries to output. If not specified, the Request Log Parser will output all entries that have been processed.--query-types <types>: specifies which types of log entries to output. If not specified, the Request Log Parser will only output/graph,/search,/bin,/abin, and/wsqueries (equivalent to--query-typesgsbaw). Types include the following:g: /graph
Navigation and search requests
s: /search
Dimension search request
b: /bin
Record request
a: /abin
Aggregate record request
w: /ws
Web Services queries
t: /admin?op=stats
Admin stats request
p: /admin?op=ping
Admin ping query
u: /admin?op=update
Admin update request
r: /admin?op=reload-services
Admin service reload request
d: /admin?op=updateaspell
Admin aspell-update request
--show-unrecognized: causes the parser to write all unrecognized queries to standard error. Primarily useful for debugging.--silent: causes the parser to suppress display of per-file progress messages and post-parsing activity summary.--web-services: causes the parser to display a breakdown of Web Services query subtypes (e.g., rad_query for /ws/rad_query entries) in the post-parsing activity summary report. This breakdown is in alphabetical order and shows the number of queries of each Web Services subtype parsed.
