Skip to main content

Alert Priorities

Counts IDS alerts, keyed by alert priority.

PropertyValue
GUID{9EFAFDD0-6CBB-4C04-8B13-2C8E0A9D3F85}
LayerAlerts
InputAlerts
Key typesn- + priority number
ImplementationNative C++ — CPICGAlertPrio (trisul_probe/src/sysplugs/alertmeters/PICGAlertPrio.cpp) defines the group and labels; CFilterGAU::CreateAuxCommands (trisul_probe/src/alertpipe/FilterGAU.cpp) updates it
Bucket / Topper300 s / 300 s
Enabled by defaultYes

What it measures​

  • Each alert that enters the IDS alert pipeline adds 1 to its priority key. The pipeline takes alerts from two sources:
    • Snort or Suricata alerts read from the IDS Unix socket. See Setup IDS alerts.
    • Alerts returned by Lua input filter scripts through step_alert. The Suricata via EVE UnixSocket app passes the EVE severity as the priority.
  • A Lua alert that does not set Priority is counted as priority 1.
  • Alerts that Lua scripts or plugins raise inside the packet pipeline are not counted here.
  • The bucket size is 5 minutes, not 1 minute.

Keys​

The key is sn- followed by the priority number. Lower numbers are more severe.

KeyMeaning
sn-1Priority 1. Label 1 (High)
sn-2Priority 2. Label 2 (Medium)
sn-3Priority 3. Label 3 (Low)
sn-4Priority 4. No preloaded label

Labels are preloaded for sn-1 to sn-3 only.

Special keys​

KeyMeaning
SYS:GROUP_TOTALSSum of every update to this group in the interval, that is, the total number of IDS alerts.

Meter list​

IDNameTypeUnitsTopBottomDescription
0Total AlertsVT_COUNTERCount200+1 for each alert with this priority.
1uniqsVT_GAUGEUniques2020Reserved cardinality slot. Not populated.
2uniqsVT_GAUGEUniques2020Reserved cardinality slot. Not populated.