AWS SNS Data Ingestion

Coralogix can subscribe to AWS SNS. Consolidating SNS logs with your other logs provide for infrastructure and application logs analysis in context of SNS-represented events. This improves your root-cause and impact analysis capabilities. Using Coralogix visualizations you can use these messages to gain insights into trends and to unlock additional value embedded in them. Adding alerts to the mix enhances your proactive management capabilities.

Coralogix allows for an easy SNS messages collection. The steps below walk you through the integration process.

Generate your token

  1. Open in Coralogix: Settings -> Context Data Plugins
  2. Click on the AwsSns tab.
  3. Click on the “+ADD NEW KEY”  button.
  4. Enter integration name in the pop-up window (it can be any name).
  5. The token will show up on the list.

Create SNS subscription

  1. Login into your AWS account and create a subscription to the topic you would like to send messages from. You can read more about SNS subscriptions here

“Cluster url” is a variable. Please match this part with a row entry within the table. Copy the table row entry located under the column that matches the top-level domain of your Coralogix account (.com, .in, etc.). Replace the variable part of the URL with this entry.

Complete the form and hit save.

 EUINUSA
Cluster URLcoralogix.comapp.coralogix.incoralogix.us
Team URL.coralogix.com.app.coralogix.in.app.coralogix.us
Topic ARN  Protocol  Endpoint
This is the ARN of the topic you created. HTTPS https://integrations.Cluster URL/v1/awssns/v1/events/<token>

 

If you like to specify application and subsystem names  you can add  them right after the token in the payload URL as shown below.

https://integrations.coralogix.com/v1/awssns/v1/events/11111111-1111-1111-1111-111111111111?appName=MyApp&subSystem=MySubsystem

Make sure the URL end point corresponds with the top level domain of your account URL (.com, .in, .us). See table above.

Example log:

{
  "source_system": "awssns",
  "awssns": {
    "MessageId": "ab11a2b6-2b53-53b3-af61-fa1b95c7a52a",
    "TopicArn": "arn:aws:sns:eu-central-1:1234567890:coralogix-integration",
    "Subject": "Backend error",
    "Message": {
      "customeAlert": "Too many connections!"
    },
    "Timestamp": "2021-02-22T14:14:44.582Z",
    "SignatureVersion": "1",
    "Signature": "ioQos7NF5tDSLvUBKOBJjsi8VyMA4RWksfNV4K++mr5sOqv/4jUGSo8RRpCgE+du2NX07oq5j5tOHV/E02YDklOSZTzPHiR9fSNdV3wip4kZIEh+/CJfQIuHpLkJpFysw/Gkwxd4LDhDax+Fi1YmiFd2FaYKwgk9c2MJEarnUtAr5j7Nj/H32K4qU3F8Er+8efJ+nh+3EEAM9JnMPHCd7ryMtxoOQGv73pyROkMI+F28cx5v7lOxHQb0AqlO8uzCSksa2HByRgeTVS2akHO6tIBMJ5LoqaoBCwWmjhT8XWYODyMGGcdXiIFZdRA/mKrjZfcsCwqaVKjSnDpFZC1Rgw==",
    "SigningCertURL": "https://sns.eu-central-1.amazonaws.com/SimpleNotificationService-010a507c1833636cd94bdb98bd911111.pem",
    "UnsubscribeURL": "https://sns.eu-central-1.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:eu-central-1:1234567890:coralogix-integration:12345678990"
  }
}