The pmtastats Accounting Statistics Application
PowerMTA comes with an accounting file parsing application, pmtastats , that
calculates delivery throughput and general traffic statistics both on a global basis and/or
on a per campaign or mailing basis.
$ pmta --help
Usage: pmtastats [global options] [statistic [options] ...] file ...
One or more statistics can be specified, each with its own options. Use with
one or more files, in either binary, CSV or XML format. '-' can be used for
reading from standard input.
examples:
pmtastats vmta-summary vmta-time-breakdown acct*
pmtastats bounce-categories --bounceCat all acct*
pmtastats --vmta vmta1 top-rates delivery-times acct*
pmtastats --output html vmta-time-breakdown acct* > report.html
global options:
--help
display this help and exit
--version
display version information and exit
--quiet
do not display progress information
--output <format>
selects the output format (text, html; default: text)
--envId <id>
--from <originator>
--toDomain <domain>
--jobId <id>
--vmta <vmta>
--header <name> <content>
filter input: use only records whose envelope ID, originator,
recipient domain, job ID, VirtualMTA, or the given header
starts with the given string, respectively
(default: no filtering)
--last DdHhMmSs
filter input: use only records written in the last D days, H hours,
M minutes and S seconds. Each part of the time specification can
be omitted, such as in "3h15m" for 3 hours, 15 minutes.
(default: no filtering)
--byEnvId
--byJobId
--byFrom
--byVmta
calculates delivery throughput and general traffic statistics both on a global basis and/or
on a per campaign or mailing basis.
$ pmta --help
Usage: pmtastats [global options] [statistic [options] ...] file ...
One or more statistics can be specified, each with its own options. Use with
one or more files, in either binary, CSV or XML format. '-' can be used for
reading from standard input.
examples:
pmtastats vmta-summary vmta-time-breakdown acct*
pmtastats bounce-categories --bounceCat all acct*
pmtastats --vmta vmta1 top-rates delivery-times acct*
pmtastats --output html vmta-time-breakdown acct* > report.html
global options:
display this help and exit
--version
display version information and exit
--quiet
do not display progress information
--output <format>
selects the output format (text, html; default: text)
--envId <id>
--from <originator>
--toDomain <domain>
--jobId <id>
--vmta <vmta>
--header <name> <content>
filter input: use only records whose envelope ID, originator,
recipient domain, job ID, VirtualMTA, or the given header
starts with the given string, respectively
(default: no filtering)
--last DdHhMmSs
filter input: use only records written in the last D days, H hours,
M minutes and S seconds. Each part of the time specification can
be omitted, such as in "3h15m" for 3 hours, 15 minutes.
(default: no filtering)
--byEnvId
--byJobId
--byFrom
--byVmta
--byHeader <header>
statistics split by envelope ID, job ID, originator, VirtualMTA, or a
given header, respectively.
Only one of these can be used.
For --byHeader, specify the header.
(default: statistics not split)
--splitLimit <num>
set the maximum number of statistics a statistic can be split into
(default: 5000)
--topDomains <num>
display top <num> domains (passed on to all statistics)
"bounce-categories" statistic
Shows most frequent bounce categories.
Options:
--topCategories <num>
display top <num> bounce categories (default: 10)
--bounceCat <option>
selects categories for detailed display. Possible options are:
<num> - top <num> categories
<category> - category name
'all' - all available categories
(default: spam-related)
--byDsn <num>
display bounce category detail for the top <num> DSN codes (default: 10)
--byDomain <num>
display bounce category detail for the top <num> domains (default: 10)
--byDsnAndDomain <num>
display bounce category detail for the top <num> DSN code / domain
combinations (default: 10)
"delivery-times" statistic
Shows times and recipients / time from queueing to delivery.
Options:
(none)
"message-counts" statistic
Total counts of recipents and volumne for messages and bounces.
Options:
(none)
"top-bounce" statistic
Top bounce domains, aggregated by DSN code (reason).
Options:
--topDomains <num>
display bounce statistic for top <num> domains (default: 10)
--topStatusCodes <num>
display bounce statistics for top <num> status codes (default: 10)
"top-domains" statistic
Domains with the most recipients, bounces, and delivery times.
Options:
--topDomains <num>
display top <num> domains (default: 10)
--noDeliveryTimes
omits list of domains with the highest average delivery times
(default: includes it)
"top-rates" statistic
Data transfer and recipient rates over time.
Options:
(none)
"vmta-summary" statistic
High-level Virtual MTA traffic summary.
Options:
--byDate
split records by date (default: no splitting done)
"vmta-time-breakdown" statistic
Dailiy and hourly recipients and bounces for each Virtual MTA.
Options:
--noHourly
do not include hourly breakdown (default: include it)
"vmta-top-bounce" statistic
Bounces for individual Virtual MTAs.
Options:
--topBounced <num>
show top <num> domains by bounces (default: 20)
--byDate
split records by date (default: no splitting done)
shortcut options:
--all
create all available statistics with default options
--acctstats
create statistics similar to what acctstats did
Comments
Post a Comment