ntopng/scripts/lua/modules/alert_definitions/other/alert_threshold_cross.lua
2022-01-03 09:42:33 +01:00

76 lines
2.8 KiB
Lua

--
-- (C) 2019-22 - ntop.org
--
-- ##############################################
local other_alert_keys = require "other_alert_keys"
local json = require("dkjson")
local alert_creators = require "alert_creators"
local format_utils = require "format_utils"
-- Import the classes library.
local classes = require "classes"
-- Make sure to import the Superclass!
local alert = require "alert"
local alert_entities = require "alert_entities"
local alert_entities = require "alert_entities"
-- ##############################################
local alert_threshold_cross = classes.class(alert)
-- ##############################################
alert_threshold_cross.meta = {
alert_key = other_alert_keys.alert_threshold_cross,
i18n_title = "alerts_dashboard.threashold_cross",
icon = "fas fa-fw fa-arrow-circle-up",
entities = {},
entities = {
alert_entities.interface,
alert_entities.network,
alert_entities.host_pool,
}
}
-- ##############################################
-- @brief Prepare an alert table used to generate the alert
-- @param metric Same as `alert_subtype`
-- @param value A number indicating the measure which crossed the threshold
-- @param operator A string indicating the operator used when evaluating the threshold, one of "gt", ">", "<"
-- @param threshold A number indicating the threshold compared with `value` using operator
-- @return A table with the alert built
function alert_threshold_cross:init(metric, value, operator, threshold)
-- Call the parent constructor
self.super:init()
self.alert_type_params = alert_creators.createThresholdCross(metric, value, operator, threshold)
end
-- #######################################################
-- @brief Format an alert into a human-readable string
-- @param ifid The integer interface id of the generated alert
-- @param alert The alert description table, including alert data such as the generating entity, timestamp, granularity, type
-- @param alert_type_params Table `alert_type_params` as built in the `:init` method
-- @return A human-readable string
function alert_threshold_cross.format(ifid, alert, alert_type_params)
local alert_consts = require("alert_consts")
local entity = alert_consts.formatAlertEntity(ifid, alert_consts.alertEntityRaw(alert["entity_id"]), alert["name"])
local engine_label = alert_consts.alertEngineLabel(alert_consts.alertEngine(alert_consts.sec2granularity(alert["granularity"])))
return i18n("alert_messages.threshold_crossed", {
granularity = engine_label,
metric = alert_type_params.metric,
entity = entity,
value = format_utils.formatValue(format_utils.round(alert_type_params.value, 2)),
op = "&".. (alert_type_params.operator or "gt") ..";",
threshold = format_utils.formatValue(alert_type_params.threshold),
})
end
-- #######################################################
return alert_threshold_cross