Configure AWS events transform script

Integrate Amazon Web Services (AWS) with Event Management, using event transform script to process alarms as events.

Before you begin

Role required: evt_mgmt_integration

About this task

When an AWS alarm arrives, Event Management:
  • Extracts information from the original AWS alarm to populate required event fields.
  • Captures the content in the additional_info field.
These event rules are provided with the base system:
Event rule Description
AWS host binding Bind AWS alarms on either the host or VM to host (Hardware) CI.
AWS vm binding

By default, this event rule is disabled.

Bind AWS alarms on either the host or VM to the “Virtual Machine Instance” CI

To enable this rule, first disable the "AWS host binding” rule.

AWS LB binding Bind AWS alarms on the Load Balancer (LB) to “Cloud Load Balance” CI
AWS RDS binding Bind AWS alarms on the Amazon Relational Database Service (RDS) to “Cloud Database”

Procedure

  1. On the AWS console, select SNS and create a new SNS topic if one does not exist.
  2. Under the topic, create a new subscription.
    1. Take the Topic ARN from the topic that you created.
      The Amazon Resource Name (ARN) is necessary for binding an Event Management alert to a CI.
    2. Set the Protocol to https.
    3. Set the Endpoint to: https://<username>:<password>@<instancename>.service-now.com/api/global/em/inbound_event?source=AWS.
    Note: The http://<user>:<password>@<instance>/evt_mgmt_proc.doURL that was used in earlier versions is now deprecated. While backward compatibility is maintained, ServiceNow recommends to replace it with the new URL.
  3. Wait until the subscription goes from Pending to Confirmed and the subscription ARN is populated.
  4. Create alarms in AWS to send to Event Management. Link them to the SNS topic that you created.
  5. In your ServiceNow instance, select the relevant event rule to manage the incoming values from AWS.