Amazon SNS

Integrate Amazon Simple Notification Service (SNS) with Cloudaware using SNS Outbound Message integration to publish alerts to SNS topics and route notifications to subscribed endpoints across cloud and on-prem environments.

info

• Audience: Cloudaware administrators
• Outcome: The SNS Outbound Message integration is configured, and Cloudaware messages are published to the selected Amazon SNS topic

Capabilities

The integration enables:

• Publishing Cloudaware alerts and other messages to an Amazon SNS topic
• Fan-out notifications to email, SMS, HTTP/S endpoints, queues, and other subscribers configured for the topic
• Scalable communication across cloud and on-premises systems through SNS subscribers

Prerequisites

Before you begin, make sure you have:

• Access to a Cloudaware account.
• A user with access to the Admin Console and permissions to manage cloud accounts, organizations, and integrations (Cloudaware Administrator).
• AWS account with an existing SNS topic.
• Topic ARN available for the SNS topic that will receive messages.
• IAM role assumed by Cloudaware in the target AWS account has an identity-based policy attached that allows the sns:Publish action.

Identify or Create a Field for the Message Content

The SNS message is populated from a field on the AWS EC2 Instance object. This can be any existing field that already contains the content you want to publish, or a custom field you create specifically for this purpose.

See the Salesforce documentation on Custom field creation and Formula field creation.

Here is the example custom formula field "NR Observability Lost Event Payload"(newRelicObservabilityLostEventPayload__c):

INSTANCE|<instance_id>|LAST_SEEN|<new_relic_host_last_timestamp>

tip

Once you have the field, note its API name — you'll need it in the next step.

Configure Outbound Message URL in Cloudaware

Create Outbound Message URL for Amazon SNS:

1. In Cloudaware, go to Admin.
2. Find SNS Outbound Message, then click OPEN WIZARD.
3. In the wizard, provide the following details:
   • AWS Account: the AWS account that owns the SNS topic.
   • AWS Region: the AWS region where the SNS topic is located (for example, us-east-1).
   • Topic ARN: the Amazon Resource Name (ARN) of your SNS topic Cloudaware will use to publish messages.
   • Subject Field: Optional; the API name of the field whose value will be used as the SNS message subject (for email notifications).
   • Message Field: the API name of the field containing the SNS message content (the formula field created earlier).
4. Click SAVE.
5. Copy the generated URL — this is the webhook endpoint used to publish messages from Cloudaware to your SNS topic.

Create an Outbound Message

Create a Salesforce outbound message that sends the selected record fields to the SNS Outbound Message URL generated by Cloudaware.

1. In Cloudaware, go to Setup (under the gear icon).
2. In the Quick Find bar, search for Process Automation.
3. Under Workflow Actions, select Outbound Messages → click New Outbound Message.
4. From the drop-down list, select the object (in this example, AWS EC2 Instance). Click Next.
5. Configure the outbound message:
   • Name: a descriptive name, e.g., SNS: EC2 New Relic Observability Lost.
   • Endpoint URL: the saved URL from the previous step.
   • Selected Fields: move fields from Available Fields to Selected Fields using the arrow buttons (in this example, the custom formula field newRelicObservabilityLostEventPayload__c and the default record field Id are used).

note

Make sure all fields referenced in the message — including the formula field created — are added to the Selected Fields section.

Set Up a Record-Triggered Flow

Create a record-triggered flow to publish the SNS message when the source record meets your criteria:

1. Proceed in the Salesforce UI (Cloudaware Setup).
2. In the Quick Find bar, search for Flows.
3. Under Process Automation, select Flows, then click New Flow.
4. Select Record-Triggered Flow. Click Create.
5. Select the target object (in this example, AWS EC2 Instance).
6. Configure the trigger:
   • Trigger: A record is updated
   • Condition: New Relic Host: State equals Down
   • When to Run the Flow: Only when a record is updated to meet the condition requirements
7. In the Optimize the Flow for section, select Actions and Related Records.
8. Enable the Asynchronous Path toggle.
9. In the asynchronous branch, add an element:
   • Element: Action
   • Action Type: Outbound Messages
   • Outbound Message: Select the outbound message created earlier
10. Save and activate the flow.

Flows can be debugged in Salesforce. See the Salesforce documentation for details: Test or Troubleshoot Flows with the Flow Builder Debugger

After the message-sending criteria are met, the message will be published to a SNS topic and delivered to the topic's subscribers. Cloudaware will also discover and ingest supported AWS SNS objects.

View AWS SNS Data in CMDB

To browse discovered AWS SNS resources:

1. In Cloudaware, open CMDB Navigator.
2. Search for AWS SNS Topics or AWS SNS Subscriptions to open the CMDB list view with records.

Supported Objects

Cloudaware ingests the following Amazon SNS objects:

Amazon SNS Object	CMDB Object API Name
AWS SNS Subscription	CA10__CaAwsSubscription__c
AWS SNS Topic	CA10__CaAwsTopic__c

Troubleshooting

If SNS messages are not published:

• Confirm the sns:Publish permission IAM role assumed by Cloudaware.
• Confirm that the AWS account, region, and topic ARN are correct.
• Verify that the SNS Outbound Message URL was copied correctly into the Salesforce outbound message and that the outbound message includes all fields used by the message content formula.
• Make sure the record-triggered flow is active, and the source record meets the trigger conditions.

Still stuck? Contact Cloudaware Support at support@cloudaware.com with the integration name and a brief description of the issue.

Related

• AWS Setup Guide