CLI zmmsgtrace

From Zimbra :: Wiki

Jump to: navigation, search
Admin Article

Article Information

This article applies to the following ZCS versions.
  ZCS 8.0 Article  ZCS 8.0
  ZCS 7.0 Article  ZCS 7.0
  ZCS 6.0 Article  ZCS 6.0


Contents

zmmsgtrace

This command is used to trace an email that was sent or received. So if you want to track a particular user's emails for the day, you can use this. It can filter emails by the sender's ID, recipient's ID, time, source host and/or destination host.

ZCS 8 and 7

zmmsgtrace is available for versions 7.1.1 and above, and all releases of 8.x.

Syntax

zmmsgtrace [options] [<mail-syslog-file>...]

Description

Long Name Short Name Description
--help Shows the help for the usage options for this tool.
--id -i Message ID. Case sensitive regex.
--sender -s Sender address. Case insensitive regex.
--recipient -r Recipient address. Case insensitive regex.
--srchost -F Source host, using hostname or IP. Case insensitive regex.
--desthost -D Destination host, using hostname or IP. Case insensitive regex.
--time -t Start, end times in YYYYMM[DD[HH[MM[SS]]]] format
--year File year if no YYYY in file
--nosort Do not sort @ARGV files by mtime
--debug Verbose output useful for debugging
--man Display the entire man page. Contains useful examples.

Examples

Show a trace of all messages in '/var/log/zimbra.log':

$ zmmsgtrace

Show a trace of all messages in '/var/log/zimbra.log' by sender matching the word 'phil':

$ zmmsgtrace -s phil

Show a trace of messages sent by 'phil.pearl' between '20130917' and '20130921' in '/var/log/zimbra.log.1.gz' and '/var/log/zimbra.log':

# note: a '.' (period) in a regex matches any character
$ cd /var/log
$ zmmsgtrace zimbra.log.1.gz zimbra.log \
            -sender 'phil\.pearl' -srchost localhost -time 20130917,20130921

Find any email sent by an email address starting with 'p' to anyone at 'example.com' in all files matching /var/log/zimbra*:

# note: this regex can match more than desired!
$ zmmsgtrace -s '^p' -r '@example.com' /var/log/zimbra*
# this regex is more specific - recipient ending in "@example.com"
$ zmmsgtrace -s '^p' -r '@example\.com$' /var/log/zimbra*

ZCS 6.0

  • 6.0 does not have the CLI zmmsgtrace


ZCS 5.0

Syntax

zmmsgtrace {-i|-s|-r|-F} <message_id>

Description

Long Name Short Name Description
--help -h Shows the help for the usage options for this tool.
-i Message ID.
-s Sender address.
-r Recipient address.
-F From Times in YYYYMMDD (hhmmss) format.
-D dest_ip/host
-t start, end times in YYYYMMDD (hhmmss) format


ZCS 4.5

Related Articles


Verified Against: ZCS 6.0, 5.0, 4.5 Date Created: 5/3/2006
Article ID: http://wiki.zimbra.com/index.php?title=CLI_zmmsgtrace Date Modified: 03/27/2014
Personal tools