Difference between revisions of "CLI zmmsgtrace"

m (ZCS 7 and 8)
(High Fidelity Document Preview For 8.5+)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Article Infobox|{{admin}}|{{ZCS 8.0}}|{{ZCS 7.0}}|{{ZCS 6.0}}|{{ZCS 5.0}}|{{ZCS 4.5}}}}
+
{{BC|Certified}}
 +
__FORCETOC__
 +
<div class="col-md-12 ibox-content">
 +
=CLI zmmsgtrace=
 +
{{KB|{{ZC}}|{{ZCS 8.0}}|{{ZCS 7.0}}|}}
 +
{{WIP}}
  
 
==zmmsgtrace==
 
==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.
 
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 7 and 8=
+
=ZCS 8 and 7=
  
 
zmmsgtrace is available for versions 7.1.1 and above, and all releases of 8.x.
 
zmmsgtrace is available for versions 7.1.1 and above, and all releases of 8.x.
Line 64: Line 69:
 
===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 [https://bugzilla.zimbra.com/show_bug.cgi?id=99042 RFE 99042]:
 +
 +
~/libexec/zmmsgtrace
 
Show a trace of all messages in '/var/log/zimbra.log':
 
Show a trace of all messages in '/var/log/zimbra.log':
  
Line 143: Line 151:
 
[[Category:Command Line Interface]]
 
[[Category:Command Line Interface]]
 
[[Category:ZCS 6.0]]
 
[[Category:ZCS 6.0]]
[[Category:ZCS 5.0]]
 
[[Category:ZCS 4.5]]
 

Latest revision as of 16:08, 11 July 2015

CLI zmmsgtrace

   KB 1496        Last updated on 2015-07-11  




0.00
(0 votes)


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

Related Articles


Verified Against: ZCS 6.0, 5.0, 4.5 Date Created: 5/3/2006
Article ID: https://wiki.zimbra.com/index.php?title=CLI_zmmsgtrace Date Modified: 2015-07-11



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search