Creating Alerts

Security Requirements and Controls

Alerts are constructed using queries and associated with one or more actions that will be triggered when then query runs. When creating an alert, the type of alert must be selected and this will adjust which configuration operations are available, which is summarized in this table:

Configuration Standard Alert Filter Alert
General Parameters Standard alert option in General Filter Alert option in General
Query Yes, supporting aggregates and joins Yes, aggregates and joins are not supported
Actions Yes Yes
Throttling Supported, see Setting Alert Throttle Period  
Action Retries Yes, for a single action; when multiple actions are configured, no retry is performed if at least one action is successfully invoked. Yes, for a single action; when multiple actions are configured, no retry is performed if at least one action is successfully invoked.

To create a new alert:

  1. Go to the Repositories and Views page.

  2. Select a Repository or View.

  3. Click the Automation tab on the top bar of the User Interface and select Alerts from the menu on the left: the full list of available alerts appears. They can have labels attached to them which are displayed next to the alert name. This can be a useful way to tag the alerts with meaningful data and to help when trying to locate them with a certain tag.

    Creating Alert from Tab

    Figure 173. Creating Alert from Tab

  4. Click + New Alert

  5. The New alert form is displayed, click Import from on the top right if you wish to import the alert from:

    • Template, browse for or drag and drop a template based on an existing alert

    • Package, invoke alert templates that are part of a LogScale package

  6. Fill in the form with the information required.

    Creating an Alert

    Figure 174. Creating an Alert

    • General

      • Select the Alert type:

        • A Standard alert is triggered by the results of a query and supports aggregate query results

        • A Filter alert is triggered by a single event.

        For more information on the differences between alert types, see Alerts

      • You may change the Name and enter a Description that can be used to describe more specifically what causes the alert to be triggered.

      • You can categorize alerts using Labels. Existing labels are presented as a list of checkboxes, or you can enter a new label and create and select it. These can be used within the UI to filter alerts. See Managing Alerts for more information.

      • New alerts are automatically enabled. To change this, click the Alert enabled checkbox. Disabled alerts do not execute the corresponding query or trigger actions.

      • You can use the Run on behalf of field to run the alert on behalf of another user i.e. using their permissions; click this field to get a list of available names to pick from, or directly enter the name of the user you want to run the alert as. You can see and edit this field if you have ChangeTriggersToRunAsOtherUsers, ManageOrganizations, or root system permissions.

    • Query — Type the query that generates the alert and specify the desired time window. The minimum time window allowed for the query is 1 minute and the minimum allowed unit to express it is seconds.

      In the example query shown in Figure 174, “Creating an Alert” we're searching for events in which the web server recorded a log level equal to ERROR.

    • Actions — you may want to add an action for LogScale to take when the alert is triggered, if you have one that's suitable for this alert.

      See Actions for more information.

      An alert will not be executed until there is at least one configured action.

      To delete an existing action, click the - next to each action.

    • Throttling — enables how often an alert is triggered to be set. For more information on configuring throttling, see Setting Alert Throttle Period.

      Throttling is only available for Standard Alerts. From version 1.129, it is also available for Filter Alerts.

  7. When you're done setting the properties for the new alert, click Create alert.


    Once the alert is saved, the query window is automatically changed to the largest unit in the Relative Time Syntax that can represent it. For example 24h is changed to 1d and 60s is changed to 1m.