Skip to content

Scan events report the start, completion, and results of a scan job. The scan event includes the number of items that were scanned and the number of detections that were resolved.

  • Category: Application Activity
  • Extends: base_event
  • UID: 6007

activity_id

  • Type: integer_t
  • Requirement: required
  • Values:
    • 0 - Unknown: The event activity is unknown.
    • 1 - Started: The scan was started.
    • 2 - Completed: The scan was completed.
    • 3 - Cancelled: The scan was cancelled.
    • 4 - Duration Violation: The allocated scan time was insufficient to complete the requested scan.
    • 5 - Pause Violation: The scan was paused, either by the user or by program constraints (e.g. scans that are suspended during certain time intervals), and not resumed within the allotted time.
    • 6 - Error: The scan could not be completed due to an internal error.
    • 7 - Paused: The scan was paused.
    • 8 - Resumed: The scan was resumed from the pause point.
    • 9 - Restarted: The scan restarted from the beginning of the file enumeration.
    • 10 - Delayed: The user delayed the scan.
    • 99 - Other: The event activity is not mapped. See the activity_name attribute, which contains a data source specific value.

The normalized identifier of the activity that triggered the event.

category_uid

  • Type: integer_t
  • Requirement: required
  • Values:
    • 6 - Application Activity: Application Activity events report detailed information about the behavior of applications and services.

The category unique identifier of the event.

class_uid

  • Type: integer_t
  • Requirement: required
  • Values:
    • 6007 - Scan Activity: Scan events report the start, completion, and results of a scan job. The scan event includes the number of items that were scanned and the number of detections that were resolved.

The unique identifier of a class. A Class describes the attributes available in an event.

severity_id

  • Type: integer_t
  • Requirement: required
  • Values:
    • 0 - Unknown: The event/finding severity is unknown.
    • 1 - Informational: Informational message. No action required.
    • 2 - Low: The user decides if action is needed.
    • 3 - Medium: Action is required but the situation is not serious at this time.
    • 4 - High: Action is required immediately.
    • 5 - Critical: Action is required immediately and the scope is broad.
    • 6 - Fatal: An error occurred but it is too late to take remedial action.
    • 99 - Other: The event/finding severity is not mapped. See the severity attribute, which contains a data source specific value.

The normalized identifier of the event/finding severity.The normalized severity is a measurement the effort and expense required to manage and resolve an event or incident. Smaller numerical values represent lower impact events, and larger numerical values represent higher impact events.

type_uid

  • Type: long_t
  • Requirement: required
  • Values:
    • 600700 - Scan Activity: Unknown
    • 600701 - Scan Activity: Started: The scan was started.
    • 600702 - Scan Activity: Completed: The scan was completed.
    • 600703 - Scan Activity: Cancelled: The scan was cancelled.
    • 600704 - Scan Activity: Duration Violation: The allocated scan time was insufficient to complete the requested scan.
    • 600705 - Scan Activity: Pause Violation: The scan was paused, either by the user or by program constraints (e.g. scans that are suspended during certain time intervals), and not resumed within the allotted time.
    • 600706 - Scan Activity: Error: The scan could not be completed due to an internal error.
    • 600707 - Scan Activity: Paused: The scan was paused.
    • 600708 - Scan Activity: Resumed: The scan was resumed from the pause point.
    • 600709 - Scan Activity: Restarted: The scan restarted from the beginning of the file enumeration.
    • 600710 - Scan Activity: Delayed: The user delayed the scan.
    • 600799 - Scan Activity: Other

The event/finding type ID. It identifies the event’s semantics and structure. The value is calculated by the logging system as: class_uid * 100 + activity_id.

activity_name

  • Type: string_t
  • Requirement: optional

The event activity name, as defined by the activity_id.

category_name

  • Type: string_t
  • Requirement: optional

The event category name, as defined by category_uid value: Application Activity.

class_name

  • Type: string_t
  • Requirement: optional

The event class name, as defined by class_uid value: Scan Activity.

severity

  • Type: string_t
  • Requirement: optional

The event/finding severity, normalized to the caption of the severity_id value. In the case of ‘Other’, it is defined by the source.

type_name

  • Type: string_t
  • Requirement: optional

The event/finding type name, as defined by the type_uid.

metadata

The metadata associated with the event or a finding.

api cloud

  • Type: api
  • Requirement: optional

Describes details about a typical API (Application Programming Interface) call.

enrichments

The additional information from an external data source, which is associated with the event or a finding. For example add location information for the IP address in the DNS answers:[{"name": "answers.ip", "value": "92.24.47.250", "type": "location", "data": {"city": "Socotra", "continent": "Asia", "coordinates": [-25.4153, 17.0743], "country": "YE", "desc": "Yemen"}}]

raw_data

  • Type: string_t
  • Requirement: optional

The raw event/finding data as received from the source.

unmapped

  • Type: object
  • Requirement: optional

The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.

time

  • Type: timestamp_t
  • Requirement: required

The normalized event occurrence time or the finding creation time.

duration

  • Type: integer_t
  • Requirement: recommended

The duration of the scan

end_time

  • Type: timestamp_t
  • Requirement: recommended

The end time of the scan job.

start_time

  • Type: timestamp_t
  • Requirement: recommended

The start time of the scan job.

timezone_offset

  • Type: integer_t
  • Requirement: recommended

The number of minutes that the reported event time is ahead or behind UTC, in the range -1,080 to +1,080.

count

  • Type: integer_t
  • Requirement: optional

The number of times that events in the same logical group occurred during the event Start Time to End Time period.

end_time_dt datetime

  • Type: datetime_t
  • Requirement: optional

The end time of the scan job.

start_time_dt datetime

  • Type: datetime_t
  • Requirement: optional

The start time of the scan job.

time_dt datetime

  • Type: datetime_t
  • Requirement: optional

The normalized event occurrence time or the finding creation time.

cloud cloud

  • Type: cloud
  • Requirement: required

Describes details about the Cloud environment where the event was originally created or logged.

scan

  • Type: scan
  • Requirement: required

The Scan object describes characteristics of the scan job.

command_uid

  • Type: string_t
  • Requirement: recommended

The command identifier that is associated with this scan event. This ID uniquely identifies the proactive scan command, e.g., if remotely initiated.

device host

  • Type: device
  • Requirement: recommended

An addressable device, computer system or host.

message

  • Type: string_t
  • Requirement: recommended

The description of the event/finding, as defined by the source.

num_detections

  • Type: integer_t
  • Requirement: recommended

The number of detections.

num_files

  • Type: integer_t
  • Requirement: recommended

The number of files scanned.

num_folders

  • Type: integer_t
  • Requirement: recommended

The number of folders scanned.

num_network_items

  • Type: integer_t
  • Requirement: recommended

The number of network items scanned.

num_processes

  • Type: integer_t
  • Requirement: recommended

The number of processes scanned.

num_registry_items

  • Type: integer_t
  • Requirement: recommended

The number of registry items scanned.

num_resolutions

  • Type: integer_t
  • Requirement: recommended

The number of items that were resolved.

num_skipped_items

  • Type: integer_t
  • Requirement: recommended

The number of skipped items.

num_trusted_items

  • Type: integer_t
  • Requirement: recommended

The number of trusted items.

policy

  • Type: policy
  • Requirement: recommended

The policy associated with this Scan event; required if the scan was initiated by a policy.

schedule_uid

  • Type: string_t
  • Requirement: recommended

The unique identifier of the schedule associated with a scan job.

status_id

  • Type: integer_t
  • Requirement: recommended
  • Values:
    • 0 - Unknown: The status is unknown.
    • 1 - Success
    • 2 - Failure
    • 99 - Other: The event status is not mapped. See the status attribute, which contains a data source specific value.

The normalized identifier of the event status.

total

  • Type: integer_t
  • Requirement: recommended

The total number of items that were scanned; zero if no items were scanned.

actor host

  • Type: actor
  • Requirement: optional

The actor object describes details about the user/role/process that was the source of the activity.

observables

The observables associated with the event or a finding.

status

  • Type: string_t
  • Requirement: optional

The event status, normalized to the caption of the status_id value. In the case of ‘Other’, it is defined by the event source.

status_code

  • Type: string_t
  • Requirement: optional

The event status code, as reported by the event source.

For example, in a Windows Failed Authentication event, this would be the value of ‘Failure Code’, e.g. 0x18.

status_detail

  • Type: string_t
  • Requirement: optional

The status details contains additional information about the event/finding outcome.