Use Log Search 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.
Each time a message is processed by MailChannels Outbound Filtering, 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.
Comments
Article is closed for comments.