Events in Qntrl | Qntrl | Bridge | Online Help | Configure Events in Qntrl

Events

In either scenario, whether your bridge is successfully connected and operational, or experiencing unforeseen disruptions impacting regular operations, it is essential to stay well-informed and respond promptly. The Events module in Bridge plays a vital role in assisting you during such times.

The Events module helps you watch specific occurrences, allowing you to take necessary actions when they occur, ensuring smooth operations. Some situations are already defined as events, and you can configure alerts and webhooks for prompt actions. A configured event oversees all the bridges within the Qntrl account, triggering pre-defined actions when the event occurs for any of the bridges.

For example, for an event like Bridge Down, you can configure an email alert. When a downtime event happens, email alerts are sent to the designated point of contacts (PoCs) or directly responsible individuals (DRIs), prompting them to take necessary actions.
Notes
Events are optional and additional configuration, that is, if no events are configured, the bridge will continue to operate as expected without any changes to its functionality.     

Qntrl provides four predefined events. You cannot delete them, but you can activate or deactivate each one and configure it with an action.

Available events  

  • Bridge Registered: Triggers its action after you install and register a Bridge agent, confirming that the setup completed successfully.

  • Bridge Up: Triggers its action when an inactive Bridge agent comes online and is ready for use.

  • Bridge Down: Triggers its action when a bridge goes into downtime or stops operating.

  • Bridge Deleted: Triggers its action when a user deletes a bridge through the interface.

Available actions  

Configure any event with one of the following actions:

  • Alert: Sends an email notification when the event occurs. Use an existing email template or create a new one.

  • Webhook: Sends an API request when the event occurs. Use an existing webhook or create a new one.

  • Outbound REST: Calls a REST endpoint when the event occurs and passes the event details to it, so an external system can receive and act on what happened. A REST endpoint is a web address that accepts requests from other applications.


Configure an Event

Associate an action with an event so Qntrl responds automatically when the event occurs.     

  1. Click the settings gear icon in the left pane.

  1. Navigate to Advanced >> Bridge, and choose Events.

  1. Select an event:

    • Bridge Registered

    • Bridge Up

    • Bridge Down

    • Bridge Deleted

 

  1. In Action Type, select the action you want: Alert, Webhook, or Outbound REST.
  2. Configure the action you selected:
    • For Alert:
      • In the 'Alert' field, pick an existing configured alert from the dropdown.
      • Alternatively, to create a new alert, click Create New. In the New Email window and provide the following details:
          1. Name: Enter a name for the email.
          2. Email template: Select an email template from the dropdown list.
          3. Notify to: choose the designated person from the dropdown list.
          4. Add Cc and Bcc fields if required.
          5. Click Save, and a new email template will be created.
      1. For Webhook:
        • To use a pre-configured webhook, choose from the dropdown and select the existing webhook name.
        • Alternatively, to create a new webhook, click Create New 
          • Configure the webhook. For more information, see Webhooks.
          • Click Add.
      • For Outbound REST:
        • Select an existing outbound REST configuration from the dropdown.
        • For an outbound REST used with events, configure the event key when you create the outbound REST web service. In the request configuration, under Query Parameters, add a key named event_details with the value {{event_details}}. This binding delivers the event details to your endpoint when the event occurs, such as which bridge went down and what happened. For more information, see Configuring Outbound REST.

     

  3. Click Save.      

      


Edit Events

  To modify a configured Event:

  1. Navigate  to(settings) >> Advanced >> Bridge >> select Events.

  1. On the loaded list of events, click on the event name you want to edit.

  1. You can now make changes to the Name and the configured Action.

  1. After making the desired modifications, click on Save.