Skip to main content

Site24x7 integration

You can use an APEX AIOps Incident Management custom integration to ingest events from Site24x7.

Before you begin

Before you set up your Site24x7 integration:

  • Make sure you are signed in to your Incident Management instance.

  • Make sure you are signed in to Site24x7.

  • Make sure you have a valid Incident Management API key.

Create a custom integration in Incident Management

  1. Within Incident Management, navigate to Integrations > Ingestion Services > Create your own Integration.

  2. Click Add New Integration.

  3. Under APEX AIOps Incident Management Endpoint, enter a unique name for your new integration (required).

    Note

    The name of the integration can be anything you choose. Incident Management will automatically generate an API endpoint URL independent of what you enter for this field.

  4. Under API Description, enter a description for the integration (optional).

  5. Under Data Type, select Events.

  6. Click Save.

  7. Keep the web page for this integration open in your browser while you complete the following steps in Site24x7.

Create a webhook in Site24x7

  1. Open Site24x7. Within the left-hand navigation, go to Admin > Third-Party Integrations.

  2. Click Add Third-Party Integration.

  3. Click Webhooks.

  4. Enter a unique name for the integration, such as "Incident Management."

  5. For Hook URL, copy and paste the endpoint URL for your Incident Management integration.

    The endpoint URL is provided for you in Incident Management on the page for your custom integration, under Configuration Information > APEX AIOps Incident Management Endpoint.

  6. Set HTTP Method to POST.

  7. Make sure Post as JSON and Send Incident Parameters are both enabled. Optionally, you may also enable "Send Custom Parameters."

  8. Set Accessibility to Global.

  9. For HTTP Request Headers, create a new HTTP request header with the following parameters:

    • Header Name = apiKey

    • Header Value = Your Incident Management API key.

  10. Set Integration Level to All Monitors.

  11. For Trigger Alerts for Monitor Status Change, make sure that Down, Trouble, and Critical are all enabled.

  12. Click Save and Test. This will send a test payload to your Incident Management integration.

Configure the custom integration in Incident Management

  1. Go to your Incident Management instance.

  2. Open the page for your custom integration by going to Integrations > Ingestion Services > Create your own Integration > your-integration-name.

  3. In the Map Your Data section, you can view cached payloads of incoming events sent from Site24x7. Confirm that the test payload you sent is there.

  4. Map your payload fields to the corresponding Incident Management fields. An example mapping is provided for you below as a reference, but you should tailor the mapping according to your business needs.

    For a complete list of mapping types, save options, and instructions on how to use them, read Use mapping types in custom integrations.

    Table 1. Example mapping

    Site24x7 fields

    Incident Management field

    MONITORURL

    source

    INCIDENT_REASON

    description

    MONITOR_ID

    check

    STATUS

    severity

    MONITOR_ID

    tags.source_id

    MONITORTYPE

    type



  5. Go to the top of the page and click Save.

In this section: