Webhooks Integration

Our server monitoring makes it easy for you to connect your event data with multiple applications using Webhooks. Webhooks work on an event based output mechanism. Specific events generated in our system triggers the webhook, which inturn invokes a signal to the Hook URL via an HTTP request. Any trigger event in our system will post the event data to the Hook URL specified by you. It allows you to streamline and manage your critical alarms, incidents or messages in any third-party application. Additionally, with our On-Premise Poller support for Webhook integration, you can post event information to any internal application.

Integrate with third party application using Webhooks

Webhook integration requires you to obtain a Hook URL of the desired third party service. Once, you’ve the Hook URL, follow the steps below to tightly integrate events data with any third party application using Webhooks:

  1. Login to your account.
  2. Navigate to Admin > Third-Party Integration.
  3. Click the Add third-party integration button. Pick Webhooks from the list.
  4. Fill up the Webhooks Integration form to complete the integration process.
    • Integration Name: Provide a name for your integration.
    • Hook URL: The full URL (with http/https protocol) that we can sends data to.
    • Accessibility: Determines whether the Hook URL can be invoked from global systems server or from within the network using On-Premise Poller.
      • Global: Invokes the Hook URL from monitoring central server to perform the integration.
      • Internal: Requires On-Premise Poller to perform the integration. Once setup, the central server will notify the On-Premise Poller to invoke the Hook URL to complete the integration.
    • HTTP method: Specify the method to be used for connecting with the URL– GET, POST, PUT, DELETE or PATCH. Select the radio buttons to configure the form submission method and appropriate body type for the POST, PUT, DELETE, or PATCH HTTP Method.
      • Post as JSON: Enter the content to be submitted in the JSON request body. The Content-Type header is set automatically.
      • Send Incident Parameters: Write specific code in the URL itself and pass the variables using Incident Parameters. The request parameters must be provided as Param name=value pair for the HTTP methods. Learn more about incident parameters.
      • Send Custom Parameters: You can define your own custom parameters and POST the request in JSON format.
    • HTTP request headers: Sometimes you might want to customize the default HTTP request header information. In such cases, the additional header name and header value can be added here.
    • User agent: Set customized user agent (web browser) for sending your request and the HTTP headers. You can choose from the available user agents.
    • Timeout: Enter the time in seconds to determine how long the servers should wait before considering the URL as non-responsive. Enter a time in seconds that is not the usual response time of your website. Specify a value between 1-45 seconds.
    • Integration level: Choose the desired integration level to either push specific events from a monitor or all alarms from your account to the relevant webhook.
      Select Monitors and choose the desired monitor to send out events from the selected monitor alone to your preferred third party service.
      Select All Monitors to send out all incidents to your desired third party service.
    • Basic/NTLM authentication (Optional): Provide the Username and Password for URLs requiring Form-based authentication.
  5. Click Save to complete the setup process.
    Once the setup process is completed, the Webhooks integration will be listed in the Third Party Integration dashboard. You can setup multiple such webhooks in your account.

Suspend/Activate/Delete Webhooks Integration
Follow the steps below to suspend an active Webhook integration:

  1. Log in to your account.
  2. Navigate to Admin > Third Party Integration.
    All the integrations will be listed here in the Third Party Integration dashboard.
  3. Click the active Webhook integration that you want to suspend.
  4. Click the Suspend button listed on the top right corner of the integration window.
    If you wish to reactivate a suspended Webhook integration, follow the same steps listed above; then click the Activate button listed on the top right corner of your integration window. Once reactivated, our server starts to push event data to the intended application.
    To delete a Webhooks integration, follow the same steps listed above; then click the Delete button listed on the top right corner of your integration window. Once deleted, the Webhooks integration will be terminated permanently.

Please make sure that the webhook-action is not on the same server that we are checking. This will create a loop because the software will check the server, server is offline and our software sends the hook to the server that’s not working… You get the point just don’t do it.

Geef een reactie

Het e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *