Collect L7 records

You can collect L7 records to store on your Explore appliance or third-party recordstore. You can then query for these stored records to see details about individual messages or transactions that occurred over L7 protocols. These types of records require triggers.

Before you begin

In the following example, you will learn how to collect records for any device that sends or receives an HTTP response. First, we will write a trigger to collect information from the built-in HTTP record type. Then, we will assign the trigger to a web server. Finally, we will verify that the records are being sent to the recordstore.
  1. Log into the Web UI on your Discover appliance.
  2. Click the System Settings icon , and then click Triggers.
  3. Click Create.
  4. In the Create Trigger pane, complete your information, similar to the following example:

    Name: HTTP Responses

    Description: This trigger collects HTTP responses.

    Enable debug log: Select the checkbox to enable debugging.


  5. In the right pane, type the following example code:
    debug ("committing HTTP responses")

    This code generates records for the HTTP record type when the HTTP_RESPONSE event occurs and corresponds to the built-in record format for HTTP.

  6. Click Save and Close. Next, assign this trigger to a web server.
  7. Click Assets from the top menu and then click Devices in the left pane.
  8. Search for an active web server that you want to collect records for. For this example, we will select a web server called web-sea-example.
  9. Select the checkbox next to the web server (such as web-sea-example).
  10. Click Assign Trigger from the menu above the table.
  11. From the list, select the checkbox next to the trigger we previously created named HTTP Responses, and then click Assign Triggers.
    Records that meet your criteria are now sent to your connected Explore appliance. Wait a few minutes for records to be collected, and then verify that your records are being collected in the next step.
  12. Click Records from the top menu to start a query. If you do not see any HTTP records, wait a few minutes and try again. If no records appear after five minutes, review your configuration or contact ExtraHop Support.
Published 2022-06-21