Help Docs

Publish messages to a SNS topic

Using Site24x7's IT Automation framework you can now publish real-time notification messages to SNS topic(s) in response to various alert events occurring in your monitored AWS environment.

Required Permissions

Please make sure the following write level permission is present in the policy attached to the Site24x7 IAM user or to the created IAM Role.

  • "sns:Publish"

Constraints

  • The supported message structure is "string". JSON message format is currently not supported
  • The publish size constraints applicable within SNS is applicable here as well (262144 character limit)
  • The SNS topic must be active and currently monitored by Site24x7.

Create an action profile

  • login to the Site24x7 console, Select Admin > IT Automation Templates 
  • Click on the drop down list and select "Publish to SNS Topic" as type
  • Provide an appropriate label in the Display Name field for identification purpose
  • Click on the drop down and select the SNS topic(s), to which you want to publish the message
  • In the Subject field, type in an appropriated subject for the message
  • In the Message field, type in the message you want to send. You may key $ to find all available tags and customize your message. Learn more about incident and custom parameters.
  • Max Allowed Action Execution Time: The maximum number of seconds Site24x7 has to wait before the request times out. You can enter a value within the range 1- 90 seconds.
  • Send the Automation Result via Email: You can choose to receive an email regarding the automation result, by setting the toggle button to Yes. Share automation results via an email to your User Alert Group configured in the Notification Profile. This email will contain parameters including the automation name, type of automation, incident reason, destination hosts, and more.
  • Save the profile.

Simulate the Automation

Once you've created the profile, navigate back to the IT Automation summary page and click on the play button to execute a test run.

Map the Automation

To execute the automation, map the action profile to an desired alert event. You can either map the profile at a predefined monitor level event type (Up/Down/trouble) or to an custom attribute level event like (CPU usage > 90%)

Monitor level mapping

Navigate to the Edit monitor page, ("AWS resource monitor page" > > Edit) of an monitored AWS resource or any other service and map the action profile with any of the following monitor status changes.

  • Execute on Down
  • Execute on Up
  • Execute on Trouble
  • Execute on any Status ChangeAttribute level mapping

Attribute level mapping

You can also associate the action profile to metric data points like CPU usage, response time, errors, latency and more. Navigate to the Edit threshold profile page for any monitored AWS resource (Edit Monitor page of the resource > click on the Pencil icon adjacent to the Threshold and Availability field) and map the profile to any desired attribute by clicking on the  "Select Automation to Execute" field.

Use case

Publish custom messages to SNS topic(s): With this automation you can automatically fire off custom messages/notifications to your already created SNS topics and in turn their configured endpoints when a monitored resource state changes or when the value of a metric relative to a threshold changes.

Was this document helpful?

Shortlink has been copied!