EventDetailDto

EventDetailDto
EventDetailDto

Comprehensive event detail including process lineage, parameters, and configuration context

JSON Example
{
    "id": "string",
    "ingestTime": "string",
    "eventTime": "string",
    "agentId": "string",
    "hostname": "string",
    "securityGroupId": 0,
    "securityGroupName": "string",
    "eventClass": "string",
    "eventCategory": "string",
    "syscallOrAction": "string",
    "resolvedPath": "string",
    "outcome": "string",
    "severity": 0,
    "description": "string",
    "enforcementMode": "string",
    "matchedRuleId": 0,
    "matchedRuleName": "string",
    "isAlert": false,
    "sequenceNumber": 0,
    "pid": 0,
    "ppid": 0,
    "uid": 0,
    "gid": 0,
    "argv": [
        "string"
    ],
    "binaryHash": "string",
    "processLineage": "string",
    "net5Tuple": {
        "srcIp": "string",
        "srcPort": 0,
        "dstIp": "string",
        "dstPort": 0,
        "protocol": "string"
    },
    "configObject": "string",
    "configAction": "string",
    "oldValue": "string",
    "newValue": "string",
    "policyVersion": 0,
    "signatureId": 0,
    "reportedRule": {
        "id": "string",
        "guid": "string",
        "version": 0,
        "rank": "string"
    },
    "userName": "string"
}
string As uuid As uuid
id
Required  

Unique canonical event identifier (UUID)

string As date-time As date-time
ingestTime
Required  

Timestamp when the appliance ingested the event

string As date-time As date-time
eventTime
Required  

Timestamp reported by the agent when the event occurred

string
agentId
Optional

External string-serialized 64-bit agent identifier

string
hostname
Optional

Hostname of the reporting agent

integer As int64 As int64
securityGroupId
Optional

Assigned security group ID

string
securityGroupName
Optional

Assigned security group name

eventClass
Required  

High-level architectural class of the security event

  • EXEC: A rule matched a process launch (stored with category PROCESS_EXECUTION)
  • FILE: A rule matched a file read, write, delete or rename (stored with category FILE)
  • NET: A rule matched a network connect (stored with category NETWORK)
  • CONFIG: No behaviour is documented for this value. No producing site in the current server code
  • BEHAVIORAL: A rule matched an SSH MFA, CLI MFA or send-signal operation (stored with category SYSTEM_CALL)
  • TAMPER: Tamper attempts. The current Agent event ingestion does not assign this class to any event
Enumeration: EXEC, FILE, NET, CONFIG, BEHAVIORAL, TAMPER
eventCategory
Optional

Operational subcategory classification of the security event

  • NETWORK: A network connect; stored with event class NET
  • FILE: A file read, write, delete or rename; stored with event class FILE
  • PROCESS_EXECUTION: A process launch; stored with event class EXEC
  • SYSTEM_CALL: An SSH MFA, CLI MFA or send-signal operation; stored with event class BEHAVIORAL
Enumeration: NETWORK, FILE, PROCESS_EXECUTION, SYSTEM_CALL
string
syscallOrAction
Optional

Operation name recorded for the event; events stored by the rule-match ingestion carry RuleMatch, Connect, or one of RULE_OP_FILE_READ, RULE_OP_FILE_WRITE, RULE_OP_FILE_DELETE, RULE_OP_FILE_RENAME, RULE_OP_SSH_MFA, RULE_OP_CLI_MFA, RULE_OP_SEND_SIGNAL; other sources may store other text; null when none was stored

string
resolvedPath
Optional

Resolved filesystem path if applicable

outcome
Required  

Final disposition or verdict outcome of the event. The server also stores, returns and accepts as a filter CHALLENGED (the matched rule requires an MFA challenge), which this list omits; the filter also accepts CHALLENGE_FAILED, which no current server code produces

  • ALLOWED: An Allow rule matched (Agent verdict ALLOW) and the operation proceeded
  • DETECTED_OBSERVE: An Audit rule matched (Agent verdict AUDIT): the operation was logged and allowed to proceed
  • PREVENTED: A Block rule matched (Agent verdict BLOCK) and the operation was blocked
  • TERMINATED: No behaviour is documented for this value. No producing site in the current server code
  • ERROR: No behaviour is documented for this value. No producing site in the current server code
Enumeration: ALLOWED, DETECTED_OBSERVE, PREVENTED, TERMINATED, ERROR
integer As int32 As int32
severity
Optional
Constraints: minimum: 1 maximum: 100

Security severity score (1-100)

string
description
Optional

Human-readable event description

enforcementMode
Required  

The enforcement mode of the agent's Security Group when the console received the event, a snapshot like securityGroupId (UI label: Group mode when received). The Agent event has no mode field, so it can differ from the mode in force at login around a mode change. It is the Group's mode, not derived from the verdict: a Block verdict in a MONITOR Group is stored with MONITOR

  • MONITOR: The Group was in MONITOR mode when the event was accepted
  • ENFORCE: The Group was in ENFORCE mode when the event was accepted
Enumeration: MONITOR, ENFORCE
integer As int64 As int64
matchedRuleId
Optional

ID of the matched rule if generated by a rule evaluation

string
matchedRuleName
Optional

Name of the matched Rule. The Rule's current name while the Rule exists; after it is deleted, the name recorded when the event was ingested. Null when the event has no matched Rule or no name was recorded

boolean
isAlert
Required  

Reserved and always false, because the Console does not mark the events behind an alert; use the Alerts page to see them. The Events page neither shows nor filters on it

integer As int64 As int64
sequenceNumber
Optional

Monotonically increasing sequence number from the agent

integer As int32 As int32
pid
Optional

Process identifier

integer As int32 As int32
ppid
Optional

Parent process identifier

integer As int32 As int32
uid
Optional

User identifier

integer As int32 As int32
gid
Optional

Group identifier

array of string
argv
Optional

Process argument vector

string
binaryHash
Optional

SHA-256 binary hash in hexadecimal representation

string
processLineage
Optional

Process execution lineage

net5Tuple
Optional

Network 5-tuple context

string
configObject
Optional

Target configuration object

string
configAction
Optional

Configuration action of a CONFIG-class event, as free text; no current event writer fills it, so it is null for events stored by the ingestion service

string
oldValue
Optional

Previous configuration value

string
newValue
Optional

New configuration value

integer As int64 As int64
policyVersion
Optional

Applied policy version on the agent

integer As int32 As int32
signatureId
Optional

Signature version or rule signature ID

object
reportedRule
Optional

Original Agent-reported rule metadata retained at ingestion; not a verified Console rule or policy link

string
userName
Optional

Canonical user the event concerns, as reported by the Agent (RuleMatchEvent.UserName, at most 256 characters); null when the Agent did not report one or the event predates the field