LogRater analyses performance behaviour of your applications and services.
Feed logs from your web and application servers to generate performance reports.
LogRater can be run stand-alone from the command line, or can be included as jar in any Java project.
LogRater is sponsored by Rabobank.
Create an executable jar:
./gradlew customFatJar
Execute as (use correct version number):
java -jar build/libs/lograter-exec-X.Y.Z-SNAPSHOT.jar
You can also download a pre-build jar here: https://github.com/stokpop/lograter/releases
Get logs from your production servers and find out which requests have the highest hits per second. For each request see the average response time and the percentiles.
For each type of request, see how many concurrent requests there are.
The following web logs are supported:
- apache
- nginx
- iis
Use the log pattern to define your log line structure. LogRater needs at least:
- a timestamp
- the endpoint called (url for example)
- the duration of that call
- optionally the http status code
In apache access log these are defined by these directives:
%t
%r
%d
(milliseconds) or%D
(microseconds) or%T
(seconds)%s
You can directly copy the log pattern definition from the http.conf file. If the original log pattern is unknown or non-existend, you can create
a log pattern yourself and make use of "placeholders" such as "%{name}X
" for the parts that are not needed.
Take this line for example:
2020-01-29T16:45:45.29+0100 [RTR/1] OUT afterburner-cpu.stokpop.nl - [2020-01-29T15:45:44.813+0000] \"GET /delay?duration=200 HTTP/1.1\" 200 0 85 \"-\" \"curl/7.64.1\" response_time:0.477786246 x_b3_parentspanid:\"-\" b3:\"woiertu\"";
To parse a line like this, you can use this log pattern:
%{one}X - %{[yyyy-MM-dd'T'HH:mm:ss.SSSZ]}t "%r" %s %{two}X response_time:%T %{three}X
LogRater will use the literals to parse the line (first is "-
" so all before that character sequence is "read" into %{one}X
).
Notice the second timestamp in the log line is used for parsing actual parsing.
The %r
is used to get the url (%r is actually the triplet <http command, url, and http version>).
The %s
is for the http status code to detect errors.
And %T
is for the response time in seconds.
Notice that information in %{one}X
, %{two}X
and %{three}X
is not used and is basically discarded.
The default pattern for %t
is [dd/MMM/yyyy:HH:mm:ss Z]
. In this example an override is provided
to match the log file timestamp format.
Run as follows:
java -jar lograter-exec-X.Y.Z.jar -o report-{ts}.html access -lp "%{one}X - %{[yyyy-MM-dd'T'HH:mm:ss.SSSZ]}t \"%r\" %c %{two}X response_time:%T %{three}X" -gh -gr -gp -gt -sd -fffi "GET" Afterburner-CPU.log
where only lines that contain "GET
" are included via "-fffi
" and a report with graphs is created.
If logs are available for outgoing requests, you can find out how the same for these outgoing requests.
If you run load tests on a performance test environment, compare the reports to the reports of production to check if the load test covers the same requests and behaves the same in response times as production.
For automatic tests also automate the analysis of the rest results.
Use mappers to map technical requests (urls) to human readable names. Also use mappers to group urls that are the same actually the same request. For instance because the url contains a unique id that needs to be filtered.
LogRater can make similar analysis for both JMeter logs and Performance Center result zip files.
For logback style Java application logging, LogRater can parse application logs to find common errors and stacktraces. It also gives an indication of 'logging' pressure under load: how many lines per minute are logged.
When you have sar files from Linux servers, LogRater can determine the average CPU usage and show CPU graphs. For instance during a load test.
For most LogRater analysis you can specify a start and end time to zoom into the period that is of interest. For example a very busy period on production or a period that is (part of) a load test.
Show graphs per request type to easily identify issues or unexpected behaviour. The following graphs are available:
- response times over time
- load over time
- histogram of response times
- percentiles of response times
Both available as png and as interactive javascript/html graphs with popups.
When session identifiers are available in the logs, LogRater can determine session duration times and also common paths that users follow through the application.
For custom logs you can easily extend LogRater to parse these logs as well and produce similar reports and graphs.
To run from the command line, use the executable jar which contains all references. For instance to parse apache access logs:
java -jar lograter-exec.jar access access.log
To see all options:
java -jar lograter-exec.jar -h
Download the executable jar here: https://github.com/stokpop/lograter/releases
To use LogRater from maven or gradle, find the lograter jar in maven central.
LogRater version: 1.3.6
Usage: nl.stokpop.lograter.LogRater [options] [command] [command options]
Options:
-et, --endtime
The end time of filter: yyyyMMddTHHmmss
-o, --output.file
Write to this file. If not set writes to std out. Use {ts} to include a
timestamp in your filename.
-r, --report.dir
The directory for the reports (an html file with graphs in this
release). Use {ts} to include a timestamp in your directory. Defaults to
reports in current dir.
Default: reports
-st, --starttime
The start time of filter: yyyyMMddTHHmmss
-base-unit
What base unit to use in reports. Choose from: milliseconds,
microseconds. Default is milliseconds.
Default: milliseconds
Possible Values: [microseconds, milliseconds]
-clear-db
Clear the database.
Default: false
-debug
Log debug statements and print stacktraces with errors.
Default: false
-runid
A run id to identify a test run with a report. Is displayed in reports.
Default: 38ebb3ca-0389-4d79-981b-158b645a54fd
-storage
The type of storage to use. Options: mem (in memory, default),
externalsort or database (in sqlite database)
Default: Memory
Possible Values: [Memory, Database, ExternalSort]
-storage.dir
Where to store files for externalsort or database (in sqlite database).
Defaults to working directory.
Default: .
-use-db
Only use database input, skip file parsing.
Default: false
Commands:
iis Parse a IIS log file.
Usage: iis [options] <List of files to parse, or a file prefix to
automatically load a set of files>
Options:
-ag, --aggregate-duration
Aggregate graph values per time period in seconds. Aggregation
kicks in for graphs with more than 10000 points. The graph name
will tell that aggregation took place.
Default: 5
--clickpath-end-of-session-snippet
Url's that contain this snippet are used as end of session marker
(default: logout)
Default: logout
--clickpath-report-step-duration
Report the average duration between clickpath steps in millis.
Default: false
--clickpath-short-code-length
Length of parts between slashes in clickpath urls, to shorten the
path.
Default: 3
-multi-hit, --count-multiple-hits-in-mapper
Will count all hits in the mapper file, otherwise only the first
hit will be counted.
Default: false
-fffe, --filefeederfilter-excludes
Regular expression to use in the file feeder. Matches will NOT be
included. Matches are made on complete logline.
-fffi, --filefeederfilter-includes
Regular expression to use in the file feeder. Matches will be
included. Matches are made on complete logline.
-gtps, --graph-with-tps
Use true TPS per second in graphs instead of moving avg. (TPS per
minute is default)
Default: false
-gh, --graphs-histo
Create histogram graphs
Default: false
-ghtml, --graphs-html
Output html google charts style graphs
Default: false
-gp, --graphs-percentile
Create percentile graphs
Default: false
-gr, --graphs-responsetimes
Create response times graphs
Default: false
-gt, --graphs-tps
Create TPS graphs
Default: false
-imm, --ignore-multi-and-no-matches
Ignore multi match and no match warnings. Do not display a list of
the no matches.
Default: false
-regexp, --include-mapper-regexp-column
Include the mapper regexp column in the iis and access log report.
Default: false
-lp, --log-pattern
The logback/httpd LogFormat pattern to use.
-mf, --mapper-file
Mapper file to use. Also used in clickpath analysis.
--max-unique-counters
Maximum number of unique counters before an overflow counter is
used that combines all further counters (named OVERFLOW_COUNTER).
Default: 512
-nompr, --nomappers
Exclude mappers in access logs.
Default: false
-ref, --referers
Include referers in iis and access logs.
Default: false
-rpu, --remove-params-from-url
Remove the parameters before parsing the access log urls (split at
question mark)
Default: false
-conc, --report-concurrent-transactions
Calculate and report concurrent calls based on log time and
duration. Adds a conc column in the report that shows the max
concurrent requests for that particular url or request mapper.
Default: false
-sd, --report-standard-dev
Calculate and report standard deviation of durations.
Default: false
-tps, --report-transactions-per-second
Calculate and report transactions per second (next to TPM).
Default: false
-ua, --useragents
Include agents in iis and access logs.
Default: false
-clickpath
Determine and report click paths (BETA). Set sessionfield for the
session id to use.
Default: false
-count-no-mapper-as-one
Will count all no-mappers as one line, default count all
no-mappers separately.
Default: false
-failure-aware
Be failure aware if possible. Report on failed hits in each
analysis line. If not set the module defaults are used.
-graphs-histo-simulator
If histo graphs are enabled, also merge a simulation of the
histogram based on stub delay generator.
Default: false
-group-by-fields
Group by the given comma separated fields as specified in the used
logformat. Url will be the mapped url.
Default: []
-group-by-http-method
Group by http method (POST, GET, ...) by adding it to the counter
name and adding a http method column in text report.
Default: false
-group-by-http-status
Group by http status code by adding it to the counter name and
adding a http status column in text report.
Default: false
-include-failed-hits-in-analysis
Include failed hits in analysis. When false the reported number of
failures and failure percentage are the same for each counter, but
the other calculated values such as min, max, tps, averaqe,
percentiles will not include failed hits. "Default behaviour can
differ for different modules. Most have true, performance center
analysis has false.
-report-percentiles
List of percentiles to report. These are comma separated double
values, for example: 99,99.9,99.995
Default: [99.0]
-report-stub-delays
Add stub delay column settings in report.
Default: false
-session-duration
Determine the average session duration. Set sessionfield for the
session id to use.
Default: false
-sessionfield
Name of the session field to use for clickpath and session
duration analysis, from logpattern.
-sessionfield-regexp
Regexp to use to get the sessionId from the sessionField. Use a
capture group () to specify the sessionId capture.
-urls
Include basic urls in iis and access logs.
Default: false
access Parse an access log file.
Usage: access [options] <List of files to parse, or a file prefix to
automatically load a set of files>
Options:
-ag, --aggregate-duration
Aggregate graph values per time period in seconds. Aggregation
kicks in for graphs with more than 10000 points. The graph name
will tell that aggregation took place.
Default: 5
--clickpath-end-of-session-snippet
Url's that contain this snippet are used as end of session marker
(default: logout)
Default: logout
--clickpath-report-step-duration
Report the average duration between clickpath steps in millis.
Default: false
--clickpath-short-code-length
Length of parts between slashes in clickpath urls, to shorten the
path.
Default: 3
-multi-hit, --count-multiple-hits-in-mapper
Will count all hits in the mapper file, otherwise only the first
hit will be counted.
Default: false
-fffe, --filefeederfilter-excludes
Regular expression to use in the file feeder. Matches will NOT be
included. Matches are made on complete logline.
-fffi, --filefeederfilter-includes
Regular expression to use in the file feeder. Matches will be
included. Matches are made on complete logline.
-gtps, --graph-with-tps
Use true TPS per second in graphs instead of moving avg. (TPS per
minute is default)
Default: false
-gh, --graphs-histo
Create histogram graphs
Default: false
-ghtml, --graphs-html
Output html google charts style graphs
Default: false
-gp, --graphs-percentile
Create percentile graphs
Default: false
-gr, --graphs-responsetimes
Create response times graphs
Default: false
-gt, --graphs-tps
Create TPS graphs
Default: false
-imm, --ignore-multi-and-no-matches
Ignore multi match and no match warnings. Do not display a list of
the no matches.
Default: false
-regexp, --include-mapper-regexp-column
Include the mapper regexp column in the iis and access log report.
Default: false
-lp, --log-pattern
The logback/httpd LogFormat pattern to use.
-mf, --mapper-file
Mapper file to use. Also used in clickpath analysis.
--max-unique-counters
Maximum number of unique counters before an overflow counter is
used that combines all further counters (named OVERFLOW_COUNTER).
Default: 512
-nompr, --nomappers
Exclude mappers in access logs.
Default: false
-ref, --referers
Include referers in iis and access logs.
Default: false
-rpu, --remove-params-from-url
Remove the parameters before parsing the access log urls (split at
question mark)
Default: false
-conc, --report-concurrent-transactions
Calculate and report concurrent calls based on log time and
duration. Adds a conc column in the report that shows the max
concurrent requests for that particular url or request mapper.
Default: false
-sd, --report-standard-dev
Calculate and report standard deviation of durations.
Default: false
-tps, --report-transactions-per-second
Calculate and report transactions per second (next to TPM).
Default: false
-ua, --useragents
Include agents in iis and access logs.
Default: false
-clickpath
Determine and report click paths (BETA). Set sessionfield for the
session id to use.
Default: false
-count-no-mapper-as-one
Will count all no-mappers as one line, default count all
no-mappers separately.
Default: false
-failure-aware
Be failure aware if possible. Report on failed hits in each
analysis line. If not set the module defaults are used.
-graphs-histo-simulator
If histo graphs are enabled, also merge a simulation of the
histogram based on stub delay generator.
Default: false
-group-by-fields
Group by the given comma separated fields as specified in the used
logformat. Url will be the mapped url.
Default: []
-group-by-http-method
Group by http method (POST, GET, ...) by adding it to the counter
name and adding a http method column in text report.
Default: false
-group-by-http-status
Group by http status code by adding it to the counter name and
adding a http status column in text report.
Default: false
-include-failed-hits-in-analysis
Include failed hits in analysis. When false the reported number of
failures and failure percentage are the same for each counter, but
the other calculated values such as min, max, tps, averaqe,
percentiles will not include failed hits. "Default behaviour can
differ for different modules. Most have true, performance center
analysis has false.
-log-type
Type of log file: apache (default) or nginx. Use apache logformat
(e.g. %t, %D, etc...) or use nginx style log format (e.g. with
$request, $status, ...
Default: apache
Possible Values: [apache, nginx]
-report-percentiles
List of percentiles to report. These are comma separated double
values, for example: 99,99.9,99.995
Default: [99.0]
-report-stub-delays
Add stub delay column settings in report.
Default: false
-session-duration
Determine the average session duration. Set sessionfield for the
session id to use.
Default: false
-sessionfield
Name of the session field to use for clickpath and session
duration analysis, from logpattern.
-sessionfield-regexp
Regexp to use to get the sessionId from the sessionField. Use a
capture group () to specify the sessionId capture.
-urls
Include basic urls in iis and access logs.
Default: false
pc Parse a performance center results database.
Usage: pc [options] <List of files to parse, or a file prefix to
automatically load a set of files>
Options:
-ag, --aggregate-duration
Aggregate graph values per time period in seconds. Aggregation
kicks in for graphs with more than 10000 points. The graph name
will tell that aggregation took place.
Default: 5
--clickpath-end-of-session-snippet
Url's that contain this snippet are used as end of session marker
(default: logout)
Default: logout
--clickpath-report-step-duration
Report the average duration between clickpath steps in millis.
Default: false
--clickpath-short-code-length
Length of parts between slashes in clickpath urls, to shorten the
path.
Default: 3
-fffe, --filefeederfilter-excludes
Regular expression to use in the file feeder. Matches will NOT be
included. Matches are made on complete logline.
-fffi, --filefeederfilter-includes
Regular expression to use in the file feeder. Matches will be
included. Matches are made on complete logline.
-gtps, --graph-with-tps
Use true TPS per second in graphs instead of moving avg. (TPS per
minute is default)
Default: false
-gh, --graphs-histo
Create histogram graphs
Default: false
-ghtml, --graphs-html
Output html google charts style graphs
Default: false
-gp, --graphs-percentile
Create percentile graphs
Default: false
-gr, --graphs-responsetimes
Create response times graphs
Default: false
-gt, --graphs-tps
Create TPS graphs
Default: false
-lp, --log-pattern
The logback/httpd LogFormat pattern to use.
-mf, --mapper-file
Mapper file to use. Also used in clickpath analysis.
--max-unique-counters
Maximum number of unique counters before an overflow counter is
used that combines all further counters (named OVERFLOW_COUNTER).
Default: 512
-conc, --report-concurrent-transactions
Calculate and report concurrent calls based on log time and
duration. Adds a conc column in the report that shows the max
concurrent requests for that particular url or request mapper.
Default: false
-sd, --report-standard-dev
Calculate and report standard deviation of durations.
Default: false
-tps, --report-transactions-per-second
Calculate and report transactions per second (next to TPM).
Default: false
-clickpath
Determine and report click paths (BETA). Set sessionfield for the
session id to use.
Default: false
-failure-aware
Be failure aware if possible. Report on failed hits in each
analysis line. If not set the module defaults are used.
-graphs-histo-simulator
If histo graphs are enabled, also merge a simulation of the
histogram based on stub delay generator.
Default: false
-include-failed-hits-in-analysis
Include failed hits in analysis. When false the reported number of
failures and failure percentage are the same for each counter, but
the other calculated values such as min, max, tps, averaqe,
percentiles will not include failed hits. "Default behaviour can
differ for different modules. Most have true, performance center
analysis has false.
-report-percentiles
List of percentiles to report. These are comma separated double
values, for example: 99,99.9,99.995
Default: [99.0]
-report-stub-delays
Add stub delay column settings in report.
Default: false
-session-duration
Determine the average session duration. Set sessionfield for the
session id to use.
Default: false
-sessionfield
Name of the session field to use for clickpath and session
duration analysis, from logpattern.
-sessionfield-regexp
Regexp to use to get the sessionId from the sessionField. Use a
capture group () to specify the sessionId capture.
application Parse an (Java logback) application log file.
Usage: application [options] <List of files to parse, or a file prefix
to automatically load a set of files>
Options:
-ag, --aggregate-duration
Aggregate graph values per time period in seconds. Aggregation
kicks in for graphs with more than 10000 points. The graph name
will tell that aggregation took place.
Default: 5
--clickpath-end-of-session-snippet
Url's that contain this snippet are used as end of session marker
(default: logout)
Default: logout
--clickpath-report-step-duration
Report the average duration between clickpath steps in millis.
Default: false
--clickpath-short-code-length
Length of parts between slashes in clickpath urls, to shorten the
path.
Default: 3
-fffe, --filefeederfilter-excludes
Regular expression to use in the file feeder. Matches will NOT be
included. Matches are made on complete logline.
-fffi, --filefeederfilter-includes
Regular expression to use in the file feeder. Matches will be
included. Matches are made on complete logline.
-gtps, --graph-with-tps
Use true TPS per second in graphs instead of moving avg. (TPS per
minute is default)
Default: false
-gh, --graphs-histo
Create histogram graphs
Default: false
-ghtml, --graphs-html
Output html google charts style graphs
Default: false
-gp, --graphs-percentile
Create percentile graphs
Default: false
-gr, --graphs-responsetimes
Create response times graphs
Default: false
-gt, --graphs-tps
Create TPS graphs
Default: false
-lp, --log-pattern
The logback/httpd LogFormat pattern to use.
-mf, --mapper-file
Mapper file to use. Also used in clickpath analysis.
--max-unique-counters
Maximum number of unique counters before an overflow counter is
used that combines all further counters (named OVERFLOW_COUNTER).
Default: 512
-conc, --report-concurrent-transactions
Calculate and report concurrent calls based on log time and
duration. Adds a conc column in the report that shows the max
concurrent requests for that particular url or request mapper.
Default: false
-sd, --report-standard-dev
Calculate and report standard deviation of durations.
Default: false
-tps, --report-transactions-per-second
Calculate and report transactions per second (next to TPM).
Default: false
-clickpath
Determine and report click paths (BETA). Set sessionfield for the
session id to use.
Default: false
-failure-aware
Be failure aware if possible. Report on failed hits in each
analysis line. If not set the module defaults are used.
-graphs-histo-simulator
If histo graphs are enabled, also merge a simulation of the
histogram based on stub delay generator.
Default: false
-include-failed-hits-in-analysis
Include failed hits in analysis. When false the reported number of
failures and failure percentage are the same for each counter, but
the other calculated values such as min, max, tps, averaqe,
percentiles will not include failed hits. "Default behaviour can
differ for different modules. Most have true, performance center
analysis has false.
-report-percentiles
List of percentiles to report. These are comma separated double
values, for example: 99,99.9,99.995
Default: [99.0]
-report-stub-delays
Add stub delay column settings in report.
Default: false
-session-duration
Determine the average session duration. Set sessionfield for the
session id to use.
Default: false
-sessionfield
Name of the session field to use for clickpath and session
duration analysis, from logpattern.
-sessionfield-regexp
Regexp to use to get the sessionId from the sessionField. Use a
capture group () to specify the sessionId capture.
alloc Parse WebSphere application server logs with large allocation
traces.
Usage: alloc [options] List of files to parse. Normally the
native_stderr.log of Websphere Application Server.
Options:
--csv-file
Csv file to write output to. Defaults to
large-allocations-log-{ts}.csv in current dir.
Default: large-allocations-log-{ts}.csv
gc Parse WebSphere verbose garbage collection log files.
Usage: gc [options] List of gc verbose files to parse. Websphere
Application Server 7 or 8 style supported. OpenJ9 gc verbose might
work too.
Options:
-et-analysis, --endtime-analysis
The end time of analysis period: yyyyMMddTHHmmss
-et-memory-fit, --endtime-memory-fit
The end time of memory fit period: yyyyMMddTHHmmss
--report-file
Text file to write output to. Defaults to
verbose-gc-report-{ts}.txt in current dir.
Default: verbose-gc-report-{ts}.txt
-st-analysis, --starttime-analysis
The start time of analysis period: yyyyMMddTHHmmss
-st-memory-fit, --starttime-memory-fit
The start time of memory fit period: yyyyMMddTHHmmss
accessToCsv Transform an access log to a csv file.
Usage: accessToCsv [options] <List of files to parse, or a file prefix
to automatically load a set of files>
Options:
-ag, --aggregate-duration
Aggregate graph values per time period in seconds. Aggregation
kicks in for graphs with more than 10000 points. The graph name
will tell that aggregation took place.
Default: 5
--clickpath-end-of-session-snippet
Url's that contain this snippet are used as end of session marker
(default: logout)
Default: logout
--clickpath-report-step-duration
Report the average duration between clickpath steps in millis.
Default: false
--clickpath-short-code-length
Length of parts between slashes in clickpath urls, to shorten the
path.
Default: 3
--csv-file
Csv file to write output to. Defaults to access-log-{ts}.csv in
current dir.
Default: access-log-{ts}.csv
-fffe, --filefeederfilter-excludes
Regular expression to use in the file feeder. Matches will NOT be
included. Matches are made on complete logline.
-fffi, --filefeederfilter-includes
Regular expression to use in the file feeder. Matches will be
included. Matches are made on complete logline.
-gtps, --graph-with-tps
Use true TPS per second in graphs instead of moving avg. (TPS per
minute is default)
Default: false
-gh, --graphs-histo
Create histogram graphs
Default: false
-ghtml, --graphs-html
Output html google charts style graphs
Default: false
-gp, --graphs-percentile
Create percentile graphs
Default: false
-gr, --graphs-responsetimes
Create response times graphs
Default: false
-gt, --graphs-tps
Create TPS graphs
Default: false
-lp, --log-pattern
The logback/httpd LogFormat pattern to use.
-mf, --mapper-file
Mapper file to use. Also used in clickpath analysis.
--max-unique-counters
Maximum number of unique counters before an overflow counter is
used that combines all further counters (named OVERFLOW_COUNTER).
Default: 512
-conc, --report-concurrent-transactions
Calculate and report concurrent calls based on log time and
duration. Adds a conc column in the report that shows the max
concurrent requests for that particular url or request mapper.
Default: false
-sd, --report-standard-dev
Calculate and report standard deviation of durations.
Default: false
-tps, --report-transactions-per-second
Calculate and report transactions per second (next to TPM).
Default: false
-clickpath
Determine and report click paths (BETA). Set sessionfield for the
session id to use.
Default: false
-failure-aware
Be failure aware if possible. Report on failed hits in each
analysis line. If not set the module defaults are used.
-graphs-histo-simulator
If histo graphs are enabled, also merge a simulation of the
histogram based on stub delay generator.
Default: false
-include-failed-hits-in-analysis
Include failed hits in analysis. When false the reported number of
failures and failure percentage are the same for each counter, but
the other calculated values such as min, max, tps, averaqe,
percentiles will not include failed hits. "Default behaviour can
differ for different modules. Most have true, performance center
analysis has false.
-report-percentiles
List of percentiles to report. These are comma separated double
values, for example: 99,99.9,99.995
Default: [99.0]
-report-stub-delays
Add stub delay column settings in report.
Default: false
-session-duration
Determine the average session duration. Set sessionfield for the
session id to use.
Default: false
-sessionfield
Name of the session field to use for clickpath and session
duration analysis, from logpattern.
-sessionfield-regexp
Regexp to use to get the sessionId from the sessionField. Use a
capture group () to specify the sessionId capture.
jmeter Parse jtl file from a jMeter run.
Usage: jmeter [options] <List of files to parse, or a file prefix to
automatically load a set of files>
Options:
-ag, --aggregate-duration
Aggregate graph values per time period in seconds. Aggregation
kicks in for graphs with more than 10000 points. The graph name
will tell that aggregation took place.
Default: 5
--clickpath-end-of-session-snippet
Url's that contain this snippet are used as end of session marker
(default: logout)
Default: logout
--clickpath-report-step-duration
Report the average duration between clickpath steps in millis.
Default: false
--clickpath-short-code-length
Length of parts between slashes in clickpath urls, to shorten the
path.
Default: 3
-multi-hit, --count-multiple-hits-in-mapper
Will count all hits in the mapper file, otherwise only the first
hit will be counted.
Default: false
-fffe, --filefeederfilter-excludes
Regular expression to use in the file feeder. Matches will NOT be
included. Matches are made on complete logline.
-fffi, --filefeederfilter-includes
Regular expression to use in the file feeder. Matches will be
included. Matches are made on complete logline.
-gtps, --graph-with-tps
Use true TPS per second in graphs instead of moving avg. (TPS per
minute is default)
Default: false
-gh, --graphs-histo
Create histogram graphs
Default: false
-ghtml, --graphs-html
Output html google charts style graphs
Default: false
-gp, --graphs-percentile
Create percentile graphs
Default: false
-gr, --graphs-responsetimes
Create response times graphs
Default: false
-gt, --graphs-tps
Create TPS graphs
Default: false
-imm, --ignore-multi-and-no-matches
Ignore multi match and no match warnings. Do not display a list of
the no matches.
Default: false
-regexp, --include-mapper-regexp-column
Include the mapper regexp column in the iis and access log report.
Default: false
-lp, --log-pattern
The logback/httpd LogFormat pattern to use.
-mf, --mapper-file
Mapper file to use. Also used in clickpath analysis.
--max-unique-counters
Maximum number of unique counters before an overflow counter is
used that combines all further counters (named OVERFLOW_COUNTER).
Default: 512
-nompr, --nomappers
Exclude mappers in access logs.
Default: false
-ref, --referers
Include referers in iis and access logs.
Default: false
-rpu, --remove-params-from-url
Remove the parameters before parsing the access log urls (split at
question mark)
Default: false
-conc, --report-concurrent-transactions
Calculate and report concurrent calls based on log time and
duration. Adds a conc column in the report that shows the max
concurrent requests for that particular url or request mapper.
Default: false
-sd, --report-standard-dev
Calculate and report standard deviation of durations.
Default: false
-tps, --report-transactions-per-second
Calculate and report transactions per second (next to TPM).
Default: false
-ua, --useragents
Include agents in iis and access logs.
Default: false
-clickpath
Determine and report click paths (BETA). Set sessionfield for the
session id to use.
Default: false
-count-no-mapper-as-one
Will count all no-mappers as one line, default count all
no-mappers separately.
Default: false
-failure-aware
Be failure aware if possible. Report on failed hits in each
analysis line. If not set the module defaults are used.
-graphs-histo-simulator
If histo graphs are enabled, also merge a simulation of the
histogram based on stub delay generator.
Default: false
-group-by-fields
Group by the given comma separated fields as specified in the used
logformat. Url will be the mapped url.
Default: []
-group-by-http-method
Group by http method (POST, GET, ...) by adding it to the counter
name and adding a http method column in text report.
Default: false
-group-by-http-status
Group by http status code by adding it to the counter name and
adding a http status column in text report.
Default: false
-include-failed-hits-in-analysis
Include failed hits in analysis. When false the reported number of
failures and failure percentage are the same for each counter, but
the other calculated values such as min, max, tps, averaqe,
percentiles will not include failed hits. "Default behaviour can
differ for different modules. Most have true, performance center
analysis has false.
-report-percentiles
List of percentiles to report. These are comma separated double
values, for example: 99,99.9,99.995
Default: [99.0]
-report-stub-delays
Add stub delay column settings in report.
Default: false
-session-duration
Determine the average session duration. Set sessionfield for the
session id to use.
Default: false
-sessionfield
Name of the session field to use for clickpath and session
duration analysis, from logpattern.
-sessionfield-regexp
Regexp to use to get the sessionId from the sessionField. Use a
capture group () to specify the sessionId capture.
-urls
Include basic urls in iis and access logs.
Default: false