Skip to main content

Alert Signatures

Counts IDS alerts, keyed by the signature (rule) ID that raised them.

PropertyValue
GUID{A0FA9464-B496-4A20-A9AB-4D2D09AFF902}
LayerAlerts
InputAlerts
Key typeSignature ID string
ImplementationNative C++ — CPICGAlertSigs (trisul_probe/src/sysplugs/alertmeters/PICGAlertSigs.cpp) defines the group; 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 signature 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, for example the Suricata via EVE UnixSocket app.
  • Alerts that Lua scripts or plugins raise inside the packet pipeline do not pass through this pipeline and are not counted here.
  • The bucket size is 5 minutes, not 1 minute.

Keys​

The key depends on the alert source. It is at most 63 characters.

KeyMeaning
sid-2001219Snort or Suricata alert from the Unix socket, signature ID 2001219. The generator ID is not part of the key.
2001219The same rule from the Suricata EVE app, which passes signature_id as is
9000001A custom rule, for example a MITRE rule

The label is the alert message, for example ET SCAN Potential SSH Scan. Trisul sets it from the alert message (Unix socket) or from SigIDLabel (Lua).

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 signature ID.
1uniqsVT_GAUGEUniques2020Reserved cardinality slot. Not populated.
2uniqsVT_GAUGEUniques2020Reserved cardinality slot. Not populated.