InsightIDR

Create and Manage Custom Alerts

With InsightIDR, you also have the option of creating custom alerts when built-in alerts might not necessarily suit your needs.

Create a Custom Alert

  1. To create a custom alert, select the Lightning Bolt icon from the top right of InsightIDR.
  2. You will see two tabs of alert types: built in, and custom. Select the Custom Alerts & Tags tab.
  1. Identify the event that will generate an alert
  2. Build a query that will select that event from a log set. Learn how to Build a Query.
  3. Copy that query into the Pattern field on the custom alert page, using only the information inside of the parentheses in where()

For instance, if the LEQL query was

  • where(direction = "OUTBOUND" AND connection_status = "ACCEPT" AND destination_address = "xx.xxx.x.xxx")
  • You would use "OUTBOUND" AND connection_status = "ACCEPT" AND destination_address = "xx.xxx.x.xxx" as your pattern
    1. Choose one or more log sets.
    2. For Match, select "Once" if you want to receive alerts on every single occurrence, or define a threshold.
  • For example, if you define an alert to match 100x/hour, that specifies that the pattern must match at least 100 times in the last 60 minutes, and will trigger a single alert when alert counter reaches this limit.
    1. For Report, select how often you receive a report about the alert. Use this feature to avoid receiving multiple reports about the same alert, or "alert flooding."

Manage Alerts

After you create an alert, it will appear in the Custom Tags and Alerts table.

  1. Click on the Pencil icon to edit the alert.
  2. If applicable, select the check box to enable the alert.
  3. Click the trashcan icon to delete the alert.