AlertSite UXM Integration

AlertSite UXM  enables you to monitor your internal, partner or public APIs, effortlessly. AlertSite monitors both REST and SOAP APIs for availability, performance and functional correctness. OpsGenie is an alert and notification management solution that is complementary to AlertSite UXM's monitoring/alerting mechanism.

What OpsGenie offer to AlertSite UXM users? 

OpsGenie has a webhook integration with AlertSite UXM. Using the integration, AlertSite UXM sends incidents to OpsGenie API, with detailed information. OpsGenie acts as a dispatcher for AlertSite UXM alerts, determining the right people to notify based on on-call schedules, using email, text messages (SMS), phone calls and iPhone & Android push notifications, and escalating alerts until the alert is acknowledged or closed.


Functionality of the integration

  • When an availability or performance alert is created in AlertSite UXM, an alert is created in OpsGenie automatically through the integration.
  • When the status of the alert is sent to OpsGenie as "0", related alert is also closed in OpsGenie.

Configuring OpsGenie side of the integration

  1. Please create an OpsGenie account if you haven't done already.
  2. Go to OpsGenie AlertSite UXM Integration page,
  3. Specify who should be notified for AlertSite UXM alerts using the "Teams" and "Recipients" fields. Auto-complete suggestions will be provided as you type. 
  4. Copy the API key by clicking on the copy button or selecting.
  5. Click on "Save Integration".

Configuration in AlertSite UXM

  1. After logging in to AlertSite UXM , click on the Alert Recipients menu located under Alerts in the Menu bar
  2. Click on the "New Recipient" button
  3. Fill in the Name field (Optional)
  4. Paste the URL you copied from the OpsGenie AlertSite integration Configuration page into the Recipient field.
  5. Select the "POST request to web server" from the Mode dropdown
  6. Submit the form
  7. Click on the newly added alert recipient from the Alert Recipients list on the left side of the screen
  8. Click on the "Edit Recipient" button under the Alert Recipient Details panel
  9. Select the "Availability Alerts" tab
  10. Click on the "Alert whenever an error clears check" if you want AlertSite to close your alerts
  11. Submit the form

All done! You can now manage your AlertSite monitors at OpsGenie and leverage OpsGenie's full alerting functionality.

Sample payload sent from AlertSite UXM

Create Alert payload:

source=AlertSite&custid=C120095&company=no%20comp%20name&device_id=327587&device_name=http://google.com×tamp=2016-06-30%2011:15:35&status=7&errcount=1&status_text=HTTP%20error%20from%20web%20server&location=Manchester,%20UK&location_num=5060&device_typecode=a&device_type=Web%20Site%20API&transaction=0&http_status=HTTP/1.1%20502%20Bad%20Gateway&

For more information about the fields check AlertSite's documentation

This payload is parsed by OpsGenie as:

{
   "source":"AlertSite",
   "custid":"C120001",
   "company":"no comp name",
   "device_name":"http://google.com",
   "device_id":"327587",
   "timestamp":"2016-06-30 11:51:24",
   "status":"7",
   "errcount":"1",
   "status_text":"HTTP error from web server",
   "location":"Manchester UK",
   "location_num":"0",
   "device_typecode":"0",
   "device_type":"Web Site API",
   "transaction":"0",
   "http_status":"HTTP/1.0 502 Bad gateway"
}

Sample alert