> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getsendbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Message Logs

> Track email delivery status, opens, clicks, and other events in real-time

Message Logs enables you to monitor and track all email events in real-time, including delivery status, bounces, complaints, opens, and clicks.

<video autoPlay muted loop playsInline className="w-full rounded-xl" src="https://mintcdn.com/nosubs/W2E8XF1wdp7HKe4u/assets/message-logs.mp4?fit=max&auto=format&n=W2E8XF1wdp7HKe4u&q=85&s=b2f8baebf59275e90ef2da8f0d24870f" data-path="assets/message-logs.mp4" />

1. Click the **Enable Message Logs** button on the Message Logs page
2. Click **AWS API** button and copy the configuration set name from the code example
3. Include the configuration set name in your AWS SES API calls

```javascript Example theme={null}
await client.sendEmail({
  FromEmailAddress: "<from-email-address>",
  Destination: { ToAddresses: ["<recipient-email-address>"] },
  ConfigurationSetName: "<log-configuration-set-name>", // Copy this from AWS API button
  Content: {
    /* ... */
  },
});
```

<Note>
  Emails sent **without** the configuration set name will not be tracked.
</Note>

## Delivery Summary

The Message Logs page displays a summary of your email delivery and engagement metrics at a glance.

* **Delivered**: Percentage of emails successfully delivered to recipients' mail servers
* **Bounced**: Percentage of emails that bounced (hard or soft bounces)
* **Open Rate**: Percentage of delivered emails that were opened by recipients
* **Click Rate**: Percentage of delivered emails where recipients clicked on links

## Monitor Another Configuration Set

If you want to monitor another configuration set, you should **configure your configuration set destination** with an SNS topic created by Sendbase.
The SNS topic name starts with `sendbase-log-<id>`.

## Tracked Events

| Event Type             | Description                                                      |
| ---------------------- | ---------------------------------------------------------------- |
| **SEND**               | Email was successfully sent from SES                             |
| **DELIVERY**           | Email was successfully delivered to the recipient's mail server  |
| **BOUNCE**             | Email bounced (hard or soft bounce)                              |
| **COMPLAINT**          | Recipient marked the email as spam                               |
| **REJECT**             | SES rejected the email (invalid recipient, configuration issues) |
| **OPEN**               | Recipient opened the email                                       |
| **CLICK**              | Recipient clicked a link in the email                            |
| **RENDERING\_FAILURE** | Email template failed to render                                  |
| **DELIVERY\_DELAY**    | Temporary delivery delay occurred                                |

<Info>
  When a **Bounce** or **Complaint** event is received, the contact is
  automatically unsubscribed if they exist in the project's contact list.
</Info>

## Data Retention

Email logs are automatically deleted after **7 days** to manage storage costs and comply with data retention best practices. An automated cleanup job runs every hour to remove expired logs.

If you need longer retention:

* Set up your own custom CloudWatch or S3-based logging solution
* Contact support for retention options