Menu
Amazon Simple Email Service
Developer Guide

Step 5: Visualize Data in Kibana

Now that you have published some Amazon SES email sending events to Amazon Elasticsearch Service (Amazon ES) by sending emails with your configuration set and message tags, you can visualize the events using Kibana, a web interface for Elasticsearch.

This section shows how to find your email sending events in Kibana, graph your email sending events by event type, and find the email addresses that bounced. These exercises are useful because monitoring your bounces and complaints is an important part of maintaining your mailing list.

For Kibana documentation and tutorials, see the Kibana User Guide.

Viewing Your Email Sending Events

The following procedure shows how to go to the Kibana user interface from the Amazon ES console. It then shows how to view the email sending events associated with the index you defined when you set up your Amazon Kinesis Firehose delivery stream in Step 2: Create a Kinesis Firehose Delivery Stream.

To view your raw email sending events in Kibana

  1. Sign in to the AWS Management Console and open the Amazon Elasticsearch Service console at https://console.aws.amazon.com/es/.

  2. Under My Elasticsearch domains, choose the domain you created in Step 1: Create an Amazon ES Cluster.

  3. Choose the Kibana link.

    You will be directed to the Kibana web interface.

  4. On the Configure an index pattern page, clear the Index contains time-based events check box.

  5. Under Index name or pattern, verify that holiday-sale, the index you created in Step 1: Create an Amazon ES Cluster, is present. If it is not present, type holiday-sale* into the field, and then choose Create.

    Note

    If the Create button does not appear, try adding an asterisk to the end of the index pattern.

  6. Choose the Discover tab on the top menu.

  7. In the search box below the Discover tab, put the cursor after the asterisk (*), and then press Enter.

    Kibana will display a list of all of your email sending events.

Graphing Your Email Sending Events by Type

For insight into the overall health of your email campaign, you can visually compare the number of problematic outcomes (bounces, complaints, and rejected emails) you have received across your campaign. The following procedure shows how to set up a vertical bar chart that displays the count of each type of email sending event.

To graph your email sending events by type

  1. Choose the Visualize tab on the top menu.

  2. Choose Vertical bar chart.

  3. Choose From a new search. If prompted for an index pattern, choose holiday-sale*.

  4. On the metrics pane, next to Y-Axis, ensure that the metric is set to Count.

  5. In the Buckets pane, choose X-Axis.

  6. For Aggregation, choose Terms. Terms refers to the fields in your JSON documents in your index.

  7. For Field, under String, choose eventType. Leave the rest of the fields at their default values.

  8. Next to Options, choose the play button. Your bar chart comparing the event types will display on the screen.

  9. To save your visualization, choose the save icon from the group of icons to the right of the search bar.

  10. Type a title such as All Event Types, and then choose Save.

Finding Recipient Addresses That Bounced

Now that you have a visualization of the health of your overall email campaign, you can go back to the raw data and find out which recipient addresses bounced, as described in the following procedure.

To view the email addresses that bounced

  1. Go to the Discover tab on the top menu.

    You will see a list of your raw event records.

    Note

    If the main window reports that there are zero search results, enter * in the search bar, and then press Enter.

  2. In the left pane, under Available Fields, hover over eventType, and then choose the add button that appears next to it.

  3. In the main window, hover over the eventType column heading, and then choose the arrow to sort the event types by name.

    The bounce events will move to the top of the list.

    Note

    There might be a short delay before the events are resorted.

  4. In the left pane, under Available Fields, hover over bounce.bouncedRecipients, and then choose the add button that appears next to it.

    In the main window, you will see the recipient address and bounce reason for each bounce event.