Help Center

LogSearch

Use LogSearch to find out what happened to your email. Search for messages based on subject line, sender, recipient, response code, and more. 

 

 

Basic Search

Simply type the term you are looking for in the search box provided at the top of the page. All indexed fields will be searched for that term. An email address can be entered. For example: xxxx@example.com.

 
Advanced Search

Each time a message is processed by the MailChannels Cloud, information about the message delivery is stored in a structured manner, which allows you to conduct precise searches based on specific search fields. For example, you can search for messages delivered on a particular date or messages containing a particular word in the subject line.

To constrain your search using a specific field value, type the name of the field, a colon (:), and then the value that you're looking for. The value may be enclosed in double quotes if you wish to specify a unique phrase that contains spaces. For example, sender:xxxx@example.com or subject:"spam is harmful".

To combine multiple field searches, simply separate them with spaces.  For example, the search expression "sender:xxxx@example.com subject: yyyy" (without the quotes) will search for messages where the sender is "xxxx@example.com" and the subject line contains the string "yyyy". Separating search parameters with spaces causes the fields to be joined using a logical "AND".

The search combinations described in the following table illustrate how you might use the search feature.

Search Query Description
hotmail Searches for messages containing "hotmail" in any of the search fields, including the from address, the recipient addresses, and the subject line.
subject:"hot vacation" Searches for messages containing the exact phrase "hot vacation" (case insensitive) within the message subject.
sender:hotmail AND rcpt:example Searches for messages where the sender includes the term "hotmail" and one of the recipient addresses includes the term "example". For example, this search would match messages from test@hotmail.com sent to the recipient bob@example.com.
sender_id:testuser Searches for messages where the sender_id field contains the term "testuser". For example, if a message was went and the X-AuthUser header contained "testuser", this search would locate that message.

The fields listed in the following table are available to search.

Field Description Examples
date The date the message was processed in YYYY-MM-DD format. date:2013-11-25
delivered Indicates whether the message was delivered. "Y" instructs the system to search for messages that were delivered, and "N" for undelivered messages. delivered:Y
lastcmd Last SMTP command received from the SMTP client. You can specify CONN (connect), MAIL, RCPT, or DATA. lastcmd:RCPT
payload Message size in bytes. Note that you can only search for exact message sizes at this time. payload:342
qid Queue ID. Searches based on the queue id string returned by the receiving mail server. qid:2bde24f22
rcpt Recipient email address. You can specify the entire address, or just part of it.

rcpt:example

rcpt:xxxx@example.com

rcpt_bad Recipient email addresses that were invalid (and therefore rejected). rcpt_bad:non-existent@example.com
rspcode Last response code generated by the receiving server. Use this field to search based on specific numeric SMTP response codes.

rspcode:550

rspcode:250

rspmsg Last response message. Use this field to search through SMTP responses.

rspmsg:spam

rspmsg:rejected

sender Envelope sender address. Use this field to search based on the sender email address as specified in the envelope of the message (during the SMTP session rather than within the message headers). sender:bob@example.com
sender_id

MailChannels sender identity. sender_id is used to track sender reputation within our system and may represent IP addresses, user names, and other types of information.

sender_id:useraccount1234

sender_id:192.168.3.2

sender_id:example.com

subject Message subject. subject:viagra
time Message delivery time in North American time format (colon separated). The time value must be surrounded with quotes.

time:"9:23"

time:"23:44"

 

Control Characters

The control characters listed in the following table must be specially encoded when entered in to the search box by prefixing them with a backslash character ("\").

Escape Symbol Example
& (ampersand) subject:"bar\&baz"
" (double quote) subject:"my favorite \"quoted string\""
: (colon) subject:"This is important\: foo"

 

Compound Terms

You can combine two or more terms using the AND and OR keywords. For example, subject:xxxx AND from:xxxx@example.com. Keywords must be upper case.

The following examples show how other search terms can be combined:

  • sender:xxxx@example.com AND rcpt_bad:y
  • sender_id:xxxx%40example.com AND spam_disposition:bulk AND delivered:N

Special Fields

There is one special field: to_date. If you specify the to_date field, no log entries newer than the date will be returned.

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Article is closed for comments.