The New Value alert is triggered by the first occurrence of a new value within a time interval. All values are tested against a list that is being dynamically created while the alert is active. The alert is set by a specific query to identify a subset of logs (if needed), and is defined with a key of choice to track for new values within the desired interval.
In many use cases, this alert enables you to automatically detect a possible abnormal behavior within your system.
A few use cases examples for this alert type include:
Security: An alert may be triggered by a new domain connection. As Coralogix Cloud Security logs all security information across all network traffic, a new domain connection will result with the field ‘security.highest_registered_domain’ having a new value. This can point to a possible attack (Command & Control activity, Data ex-filtration, etc).
Monitoring: An alert may be triggered by a new application error code. Many applications send an ‘error_code’ field. A new value for this field indicates a new issue with the application.
Create New Value Alerts
STEP 1. Create an Alert.
There are 2 ways to creating an alert:
1- Through the explore screen.
The advantage of creating an alert through the explore screen is that you can create your query, adjust the filters you want to alert on (application/subsystem, severity, fields..). Once you hit create Alert all the filters and query will be added automatically.
2- Alert Menu > Alert Management tab.
With the Alert Management Tab you are creating the alert from scratch.
Click NEW ALERT on the top-right area of the UI.
STEP 2. Define the Alert Details.
Alert Severity. Choose from one of four options: Info, Warning, Error, Critical.( this severity has nothing to do with the log severities).
Labels. Define a new label or choose from an existing one.
Set as Security Alert. Check this option to create an alert related to Coralogix Security solutions Or any alert you consider to be security. Maybe visitors from certain areas of the world can be a security concern.
STEP 3. Select New Value Alert Type.
Step 4. [Optional] Choose to add a query, and adjust the application, subsystem, and severity of the logs you want to be considered for by the alert to trigger.
Step 5. Define Conditions.
Key to track: this is a key from your logs that you want to track for new values(country, city name).
Notify on new value in the last: The duration you want keep tracking this key. You can track a key up to 3 months for new values.
Notify Every: This is used to tune the alert if the alert is noisy and triggers more often.
Note: When an alert is triggered, it won’t be triggered againuntil one of two things happens: either the Notify Every period passes or it is resolved. In the latter case, the Notify Every parameter is reset.
STEP 6. Define Notification Groups.
By default, a single notification, aggregating all values matching an alert query and conditions, will be sent to your Coralogix Insights screen.
+ ADD WEBHOOK. Define additional alert recipient(s) and notification channels.
Notify Every. Sets the alert cadence. After an alert is triggered and a notification is sent, the alert will continue to work, but notifications will be suppressed for the duration of the suppression period.
Notify when resolved. Activate to receive an automatic update once an alert has ceased.
Step 7. Set Schedule.
The schedule is a good option if you have 2 Teams in 2 different Time zones handling or collaborating on the same tasks. You can chose the days when Team “A” should be alerted and the same thing for Team “B”.
Step 8. Define Notification Content.
By default the alert content will contain the whole log with all fields. With the notification content, you can specify the fields you want to receive and focus on.
A new/updated alert will become active after the configured alert time window or 7 days (the shorter of the two). This is in order for Coralogix to train on the set of different values, capture a baseline as well as try to prevent false notifications.
The alert can track up to 50K unique values in the defined time window. When the captured values list gets to 50K, the alert will not be triggered until values are cleared from the list. A value will be cleared from the list when its age in the list is equal to the alert time window. The first detection of this value after it was deleted will trigger an alert.
The first 255 Characters will be taken as the value (i.e if you have 2 values that have the same first 255 chars, they will be considered as the same value).
There is a 5 min “silence” period after the alert was triggered. During this time, new values will be added to the list but the alert will not be triggered.
Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.
Feel free to reach out to us via our in-app chat or by sending us an email at [email protected].