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 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.

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.

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.

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

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. If there is no Predicted: Good log entry for the message in your inbox, that means that SpamSieve was never given a chance to analyze it. You may want to check the setup of your mail program, as described in the Why is SpamSieve not catching my spam? section. If spam messages are being predicted as good and you don’t understand why, please see the Sending in an Error Report section.

Predicted: Spam

This means that SpamSieve examined an incoming message and thought it was spam. The Info tab will show why. If there is no Predicted: Good log entry for the message in the Junk mailbox, that means it was moved to Junk by something other than SpamSieve. Please see the Why do good messages keep going to the Junk or Spam mailbox? section. If good messages are being predicted as spam and you don’t understand why, please see the Sending in an Error Report section.

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.

• If the icon is green, that means that when you trained SpamSieve it had not seen the message before, so it is not a SpamSieve mistake. See also:
  • Why are Apple Mail inbox messages not being processed?
  • Why are other Apple Mail mailboxes not being processed?
  • Why do good messages move to the wrong inbox when trained in Apple Mail?
• If the icon is orange or red that means that SpamSieve had incorrectly classified the message.

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.

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.