CLI zmmsgtrace

1. Zimbra Tech Center
2. Certified
3. CLI zmmsgtrace

CLI zmmsgtrace

 - This article is a Work in Progress, and may be unfinished or missing sections.

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

If you get command not found, then it's because zmmsgtrace is in /opt/zimbra/libexec/ and not in /opt/zimbra/bin . Just run the following as the zimbra user to following the examples below instead RFE 99042:

~/libexec/zmmsgtrace

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

• ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities > zmmsgtrace

Related Articles

• Finding messages