AWS Simple Notification Service (SNS)

This Guide Integrates:

Note: Cloud-only feature. The self-hosted open source version of HyperDX does not support this integration.

Setup HyperDX SNS Integration

Create Amazon SNS Topic

1. Sign in to the Amazon SNS console (opens in a new tab)
2. On the navigation panel, choose Topics and click Create topic
3. Select Standard topic type and put HyperDX in the 'Name' field

Subscribe the HyperDX HTTP endpoint to the Amazon SNS topic

1. In the AWS Management Console, locate and select the 'HyperDX' topic that you created in the previous step
2. Under the 'Subscriptions' tab, click on the 'Create subscription' button
3. From the 'Protocol' dropdown menu, select HTTPS as the desired protocol for the subscription
4. In the 'Endpoint' field, enter the following URL:

https://in-binary.hyperdx.io?hdx_platform=aws-sns&hdx_token=<YOUR_API_KEY_HERE>

5. In the 'Delivery policy (HTTP/S)' section, uncheck the Use the default delivery policy option
6. In the 'Content-Type' field, enter application/json to specify the content type of the delivered messages
7. Click the 'Create subscription' button to create the subscription for the HyperDX topic

Confirm Subscription

1. Open your web browser and navigate to to HyperDX (opens in a new tab)
2. Ensure that you can view the log line sent from AWS in the HyperDX interface
3. Locate the '>' icon on the left side of the log entry and click on it to expand the log details
4. Within the 'Parsed Properties', identify the SubscribeURL field. Copy the entire URL associated with it
5. Open a new tab in your web browser and paste the copied SubscribeURL into the browser's address bar
6. Press the "Enter" key to navigate to the pasted URL. This action will complete the subscription process
7. Within the SNS console, navigate to the HyperDX topic that you subscribed to
8. Verify that the subscription status displays as 'Confirmed'

Test HyperDX SNS Topic (Optional)

1. Open a web browser and go to the HyperDX SNS Topic page in the AWS Management Console
2. Locate and click the 'Publish Message' button located at the top right corner of the page
3. In the 'Subject' and 'Body' fields, enter random text that you want to include in the message
4. Click the 'Publish Message' button to send the message to the HyperDX SNS Topic
5. Wait for the log line to appear in the Hyperdx (opens in a new tab) log monitoring interface. This may take a few minutes depending on the system's processing time

Steps to Forward Amazon Simple Email Service (SES) Events to HyperDX via SNS

Create Configuration Set

1. Open a web browser and navigate to the SES Configuration Sets page in the AWS Management Console
2. Click on the 'Create set' button to create a new configuration set
3. Once the configuration set is created, click on 'Event destinations' and then 'Add destination'
4. Select the specific SES events that you want to forward to HyperDX and click 'next'
5. In the 'Destination options' section, choose 'Amazon SNS' as the destination type
6. In the 'Name' field, enter 'HyperDX' to identify the SNS destination for these events
7. Select the 'HyperDX' SNS topic from the available options and click 'next'
8. Click 'Add destination' to add the SNS destination to the configuration set

Add Configuration Set to Verified Identities

1. Go to the SES Verified Identities page in the AWS Management Console
2. Choose the specific identity that you want to configure for forwarding events
3. Under the 'Configuration set' tab, click 'Edit' to modify the configuration settings
4. Assign the configuration set you created in the previous step to the selected identity

Read more about AWS SNS here: https://docs.aws.amazon.com/sns/latest/dg/welcome.html (opens in a new tab)