Create an application through the Trigger API

An application is a user-defined container that you can associate with multiple devices and protocols for a unified view of built-in metrics. The ExtraHop Trigger API enables you to create more complex applications than you can through the ExtraHop Web UI. For example, you can write a trigger to apply additional filters for collecting metrics, to create custom application metrics, or to collect metrics from non-L7 traffic.

In the following example, we will show you how to create an application for your web servers that will only collect metrics when the processing time on HTTP responses exceeds 500 milliseconds.

Before you begin

Important:Applications cannot be deleted. The application ID is permanent and cannot be changed.
  1. Log into the ExtraHop Discover or Command appliance.
  2. Click the System Settings icon and then click Triggers.
  3. Click New to open the Trigger Configuration window.
  4. Complete the information in the fields for Name, Author, and Description.
  5. In the Events field, type HTTP and then select HTTP_RESPONSE.
  6. Click the Editor tab.
  7. In the Trigger Script textbox, type the following code:
    if (HTTP.processingTime > 500){
        Application("myAppID").commit();
    }

    where "myAppID" is the permanent application ID. The value of "myAppID" is also applied as the display name, which can be modified later in the Web UI.

  8. Click Save and Close.

Next steps

Published 2017-10-17 22:07