File Query [5007] Class
Applicable Profiles: Cloud Date/Time OSINT Host Container Linux Users Data Classification

Discovery Category

File Query events report information about files that are present on the system.
Name Caption Group Requirement Type Description
activity_id Activity ID classification Required Integer The normalized identifier of the activity that triggered the event.
0Unknown
The event activity is unknown.
1Query
The discovered results are via a query request.
99Other
The event activity is not mapped. See the activity_name attribute, which contains a data source specific value.
This is an enum attribute; its string sibling is activity_name.
activity_name Activity classification Optional String The event activity name, as defined by the activity_id.
This is the string sibling of enum attribute activity_id.
actor Actor primary Optional Actor The actor object describes details about the user/role/process that was the source of the activity.
api API Details context Optional API Describes details about a typical API (Application Programming Interface) call.
category_name Category classification Optional String The event category name, as defined by category_uid value: Discovery.
This is the string sibling of enum attribute category_uid.
category_uid Category ID classification Required Integer The category unique identifier of the event.
5Discovery
Discovery events report the existence and state of devices, files, configurations, processes, registry keys, and other objects.
This is an enum attribute; its string sibling is category_name.
class_name Class classification Optional String The event class name, as defined by class_uid value: File Query.
This is the string sibling of enum attribute class_uid.
class_uid Class ID classification Required Integer The unique identifier of a class. A class describes the attributes available in an event.
5007File Query
File Query events report information about files that are present on the system.
This is an enum attribute; its string sibling is class_name.
cloud Cloud primary Required Cloud Describes details about the Cloud environment where the event was originally created or logged.
count Count occurrence Optional Integer The number of times that events in the same logical group occurred during the event Start Time to End Time period.
device Device O primary Recommended Device An addressable device, computer system or host.
duration Duration Milliseconds occurrence Optional Long The event duration or aggregate time, the amount of time the event covers from start_time to end_time in milliseconds.
end_time End Time occurrence Optional Timestamp The end time of a time period, or the time of the most recent event included in the aggregate event.
end_time_dt End Time occurrence Optional Datetime The end time of a time period, or the time of the most recent event included in the aggregate event.
enrichments Enrichments context Optional Enrichment Array 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"}}]
file File O primary Required File The file that is the target of the query.
message Message primary Recommended String The description of the event/finding, as defined by the source.
metadata Metadata context Required Metadata The metadata associated with the event or a finding.
observables Observables primary Recommended Observable Array The observables associated with the event or a finding.
osint OSINT primary Required OSINT Array The OSINT (Open Source Intelligence) object contains details related to an indicator such as the indicator itself, related indicators, geolocation, registrar information, subdomains, analyst commentary, and other contextual information. This information can be used to further enrich a detection or finding by providing decisioning support to other analysts and engineers.
query_info Query Info primary Recommended Query Information The search details associated with the query request.
query_result Query Result primary Recommended String The result of the query.
This is the string sibling of enum attribute query_result_id.
query_result_id Query Result ID primary Required Integer The normalized identifier of the query result.
0Unknown
The query result is unknown.
1Exists
The target was found.
2Partial
The target was partially found.
3Does not exist
The target was not found.
4Error
The discovery attempt failed.
5Unsupported
Discovery of the target was not supported.
99Other
The query result is not mapped. See the query_result attribute, which contains a data source specific value.
This is an enum attribute; its string sibling is query_result.
raw_data Raw Data context Optional String The raw event/finding data as received from the source.
severity Severity classification Optional String The event/finding severity, normalized to the caption of the severity_id value. In the case of 'Other', it is defined by the source.
This is the string sibling of enum attribute severity_id.
severity_id Severity ID classification Required Integer

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.
0Unknown
The event/finding severity is unknown.
1Informational
Informational message. No action required.
2Low
The user decides if action is needed.
3Medium
Action is required but the situation is not serious at this time.
4High
Action is required immediately.
5Critical
Action is required immediately and the scope is broad.
6Fatal
An error occurred but it is too late to take remedial action.
99Other
The event/finding severity is not mapped. See the severity attribute, which contains a data source specific value.
This is an enum attribute; its string sibling is severity.
start_time Start Time occurrence Optional Timestamp The start time of a time period, or the time of the least recent event included in the aggregate event.
start_time_dt Start Time occurrence Optional Datetime The start time of a time period, or the time of the least recent event included in the aggregate event.
status Status primary Recommended String The event status, normalized to the caption of the status_id value. In the case of 'Other', it is defined by the event source.
This is the string sibling of enum attribute status_id.
status_code Status Code primary Recommended String 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 Status Detail primary Recommended String The status detail contains additional information about the event/finding outcome.
status_id Status ID primary Recommended Integer The normalized identifier of the event status.
0Unknown
The status is unknown.
1Success
2Failure
99Other
The event status is not mapped. See the status attribute, which contains a data source specific value.
This is an enum attribute; its string sibling is status.
time Event Time occurrence Required Timestamp The normalized event occurrence time or the finding creation time.
time_dt Event Time occurrence Optional Datetime The normalized event occurrence time or the finding creation time.
timezone_offset Timezone Offset occurrence Recommended Integer The number of minutes that the reported event time is ahead or behind UTC, in the range -1,080 to +1,080.
type_name Type Name classification Optional String The event/finding type name, as defined by the type_uid.
This is the string sibling of enum attribute type_uid.
type_uid Type ID classification Required Long 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.
500700File Query: Unknown
500701File Query: Query
The discovered results are via a query request.
500799File Query: Other
This is an enum attribute; its string sibling is type_name.
unmapped Unmapped Data context Optional Object The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.