Contents  SpamSieve Manual  Translate  Technical Support

5.4.3   Log

From the Window menu, you can open the Log window, which keeps track of which messages SpamSieve has filtered, which messages you’ve trained it with, changes that you’ve made to the rules, any errors that have occurred, and more. The log is the first place to look to understand what SpamSieve is doing or to troubleshoot a problem. The Sending in an Error Report section describes how you can e-mail part of your log to spamsieve@c-command.com if you need help interpreting it. You can also Copy/Paste individual log entries from the list.

log trained spam

Log Table Columns

The following columns are shown:

Whether the log entry has been marked as flagged.
Type
An icon and a short description of what kind of log entry this is.
Subject
The message’s subject, or a short summary for a non-message log entry.
From
The message’s sender, or information about the source of a non-message log entry.
Date
When SpamSieve performed whatever operation led to the log entry. In other words, this might show the date that SpamSieve classified a message (not the date when the message was sent or received).

Unlike with other windows in SpamSieve, the sorting in the Log window is not configurable. For performance reasons, it is always sorted by date, with newer log entries at the bottom. If a new log entry is recorded while you have a log entry selected, SpamSieve will continue showing the selected log entry. If no log entry is selected—you can deselect by Command-clicking—when a new log entry is recorded, SpamSieve will auto-scroll the window to the bottom so that you can always see the latest entries.

Log Detail Tabs

The Info tab shows basic information about the message and what SpamSieve did with it. The Summary and Help sections have advice from SpamSieve about what you might want to do if the message was not processed the way you expected.

log info predicted good

The Message tab shows a preview of the message’s contents. SpamSieve does not load remote images here, so you are protected from Web bugs. You can also use the Open in External Viewer command to open the message in your mail client.

log message

The Raw Source tab shows the message data that SpamSieve received from your mail client. You can export a message’s raw source by dragging the message from the list to the Finder.

log raw source

The Structure tab shows information about how SpamSieve interpreted the raw source.

log structure

Types of Log Entries

Predicted: Good

This means that SpamSieve examined an incoming message and thought it was good. The Info tab will show why:

log info predicted good

Predicted: Spam

This means that SpamSieve examined an incoming message and thought it was spam. The Info tab will show why:

log info predicted spam

Trained: Good/Spam (Manual)

These log entries represent messages that you had trained as good or spam, either as part of an initial training or when correcting mistakes.

Trained: Good/Spam (Auto)

These log entries represent messages that SpamSieve auto-trained. It’s normal for SpamSieve to auto-train a message as good if it thinks that the message isn’t spam. This will add the sender to the allowlist to ensure that future messages from that sender get through to your inbox. If you later train the message as spam, SpamSieve will disable (uncheck) the allowlist rule. Thus, auto-training should not ordinarily cause problems unless you receive a large flurry of messages from the same sender address, or if you forget to train the message as spam and then the address remains enabled on the allowlist. For more information, see the Auto-train as needed section.

Arrow Icons

An arrow icon after a Predicted log entry means that the same message has been processed multiple times:

If you have the Check inboxes for new messages not sent to Mail extension option enabled, SpamSieve will do an extra pass over the inbox in case Mail didn’t send it all the new messages to examine. This can result in SpamSieve processing the same message twice in the event that Mail was working properly, so it would be normal to see two log entries for the same message with these arrows. In other situations, or for messages not in the inbox, each message should only be processed once, so these arrows could indicate that something unexpected happened or that you manually told SpamSieve to reprocess a message.

Searching the Log

You can search the Log window by entering text to match a message’s metadata or a word that was used in classifying it. A multi-word query is treated as a phrase search. Searches support wildcards such as * (which matches any number of additional characters) and ? (which matches a single character). To search for a literal wildcard character, you can escape it, e.g. \? to search for a question mark.

You can search for a message’s identifier (as shown in the Info tab) to find all the log entries pertaining to that message.

Compacting the Log

To reduce the amount of disk space that the log uses, see the pruning options in Settings ‣ Storage.

     Contents  SpamSieve Manual  Translate  Technical Support