Help Monitoring
Activity
This page explains the activity log, which lists every email a domain sent in the last 30 days and what happened to it. It covers how the events reach the log inside your own AWS account, how to search, filter and export the log, and how to read a kept copy of a message.
What the activity log shows
Open a domain's Activity to see every email the domain sent in the last 30 days, latest first. It shows the domain chosen in the header. Each row shows:
- Sent (UTC): when Amazon SES accepted the email.
- To: the recipients.
- Subject.
- Status: the furthest the email got, based on the event that tells the most about it.
The statuses, from the least informative to the most:
| Status | Meaning |
|---|---|
| Accepted | Accepted by Amazon SES, with no news since |
| Delayed | Delivery is delayed |
| Delivered | Delivered to the recipient's mail server |
| Opened | Opened by the recipient |
| Clicked | A link was clicked |
| Rejected | Rejected by Amazon SES |
| Bounced | Bounced |
| Complaint | Marked as spam by the recipient |
Opened and Clicked only appear for a domain that tracks opens and clicks (see below).
The log shows 50 emails at a time. Click Load more for the next 50. Click a column heading to sort the emails loaded so far by that column. Click it again to reverse the order.
Any member of the team can open the activity log.
How events get to the log
The log is stored in your AWS account. Nothing about individual emails is copied to SendForever:
- Each domain's configuration set has an event destination named
sendforever-events. - Amazon SES sends each email's events to the Amazon Data Firehose stream
sendforever-events, which the SendForever stack created. - Firehose writes them to the S3 bucket the stack created, under
events/, about once a minute. - When you open the page, SendForever asks Amazon Athena (the
sendforeverworkgroup, theeventstable of thesendforeverdatabase) for the rows it shows.
For every email, the log records send, delivery, bounce, complaint, reject and delivery delay events. For a domain that tracks them, it also records opens and clicks. The activity log, the webhook, alerts and campaigns add a few cents at most to your AWS bill, and mostly stay within AWS's free tier.
The page shows the emails that went through the configuration set the domain sends through. A domain you add gets its own configuration set, with recording on from the start. Emails your app sends through another configuration set are not shown.
Start recording
If the configuration set the domain sends through does not record to the log yet, the page shows Emails from example.com are not being recorded yet, naming the configuration set.
Team owners and admins can click Start recording. SendForever then adds the sendforever-events destination to that configuration set. It includes opens and clicks only if the configuration set already tracks them. Emails sent from then on appear about a minute after they go out. Emails sent before are not recorded.
Opens and clicks
To see when an email was opened and which link was clicked, turn on Track opens and clicks on the domain's Settings > Configuration tab. Amazon SES then adds a tracking pixel to every email the domain sends and rewrites every link in it. The switch is available once the domain sends through its own configuration set. See Domains.
Search and filter
- Status: choose a status from the menu (Any status by default). Delivered also matches emails that were opened or clicked after delivery, and Opened also matches clicked ones. Every other status matches only itself.
- Find emails to an address: type a full address, such as [email protected], and click Find. Partial addresses are not accepted.
- Subject contains: type part of a subject and click Find. The match ignores case.
When nothing matches, the page says No emails match these filters and offers Clear filters.
On the Suppressions page, click an address to open the activity log filtered to the emails the domain sent to it.
In a campaign's report, See each email opens the activity log with only that campaign's emails. Beside the filters, it shows Campaign: and the campaign's name. The log covers the days the campaign went out, even if that was more than 30 days ago, as long as the bucket still keeps their events (90 days). The other filters and Export CSV work on the campaign's emails as on any others. To see every email of the last 30 days again, click the x beside the campaign's name, or Clear filters. See Campaigns.
Email details
Click a row to open the email's details:
- The subject and when it was sent, in UTC.
- From, To, Cc and Reply-To, as the email was sent.
- A timeline of every event Amazon SES reported, with its time and detail: the receiving server's response for a delivery, the bounce type and diagnostic, the complaint feedback type, the delay type, the reject reason, or the link that was clicked.
- For a bounce or a complaint, Check [email protected] on the suppression list. It opens the suppression list the email went through: the isolated domain's own list if the email named its tenant, or else the account's list.
- The headers the email was sent with. If they were longer than 10 KB, Amazon SES kept only the first part.
- The Message ID Amazon SES assigned.
Kept copies of messages
If a domain keeps copies of what it sends, you can read any of its emails as delivered. To turn this on, use the Copies of sent emails setting (the Keep copies switch) on the domain's Settings > Configuration tab. Amazon SES then writes every email the domain sends to a Mail Manager archive named sendforever-messages in your account, which keeps it for three months. The archive is billed to your AWS account per GB archived and per GB stored.
In an email's details, click Show message. The page shows the HTML version in a sandboxed frame, or the text version if there is no HTML. Download the original (.eml) downloads the message file. The link works for a few minutes. A message over 512 KB is not shown on the page. You only get its download link.
If the archive does not have the email, the page says so. Either its domain was not keeping copies when it went out, or the email is older than three months. If you turn copies off, the copies already kept stay until their three months are up.
Export
Click Export CSV under the list to download up to 10,000 emails of the domain that match the current filters. Athena writes the file to your own bucket, and your browser downloads it from there. Nothing passes through SendForever. The file has one row per email with its message ID, sent time, subject, sender, recipients, domain and status.
How fresh the log is
Firehose delivers events about once a minute, so an email shows in the log about a minute after it goes out. SendForever reads the list from the log and caches it for up to 15 minutes for the whole team. The time of the read shows at the top right as Updated 14:05 UTC. Click Update now beside it to read the log again and see newer emails. This works at most once a minute for the whole team. Within that minute, everyone gets the read that was already made.
How long events are kept
The page covers the last 30 days. The events themselves stay in your S3 bucket for 90 days. After that, the bucket's lifecycle rule deletes them. Kept copies of messages last three months.
What the log needs
- A connected AWS account. Without one, the page asks you to connect it. See Your AWS account.
- A domain. Without one, the page leads owners and admins to add one.
Common questions
Why is my email not in the activity log?
Check these in order: a minute has passed since it went out, the header shows the domain that sent it, no filter hides it, it was sent in the last 30 days, and it went through the domain's configuration set. If the page says the domain's emails are not being recorded yet, click Start recording. Emails sent before recording started are not in the log.
Why do I see no opens or clicks?
The domain does not track them. Turn on Track opens and clicks on the domain's Configuration tab. Only emails sent after that carry the tracking pixel and rewritten links.
Can I see the content of an email?
Only if its domain was keeping copies when it went out, and only for three months. Turn on Keep copies on the domain's Configuration tab, then use Show message in the email's details.
Where is my data stored?
In your AWS account. The events are in the S3 bucket the SendForever stack created, and kept copies are in a Mail Manager archive. SendForever reads them when you open the page and caches the answer only briefly.
The page says "Unable to read the activity log". What do I do?
The message after it is the answer AWS gave. Click Try again. If loading a later page fails, the rows on screen stay, and the error shows beside Load more, which you can click again.
Why does the status say Accepted and not Delivered?
Amazon SES accepted the email but has reported no delivery, bounce or other event since. The status changes once SES reports one.
Can members start recording?
No. Members see the activity log and the notice that recording is off, but only owners and admins can click Start recording.
How do I see another domain's emails?
The log always shows the domain chosen in the header. Choose the other domain there, or use View activity in the actions menu of that domain's Settings page.
Still stuck?