nano SIEM
Reference

OCSF field reference

Supported in:Self-hosted

OCSF 1.9 field paths for users, hosts, IPs, processes, files, HTTP, authentication, network, cloud and findings, plus the event class table.

Look up the OCSF 1.9 field paths you can query for events, entities, and findings.

The tables group standard OCSF 1.9.0 attributes by entity. For classes, class-dependent paths, and unmapped, start with OCSF schema.

The full schema, with every class, object, and attribute, is at schema.ocsf.io/1.9.0.

Find an entity anywhere

These are the paths nano itself uses to find an entity in any event. Use the OR form when you don't know the class.

EntityPaths
Useractor.user.name OR user.name
Hostdevice.hostname OR src_endpoint.hostname OR dst_endpoint.hostname
IPsrc_endpoint.ip OR dst_endpoint.ip
Hashfile.hashes.value OR process.file.hashes.value OR actor.process.file.hashes.value
Domainhttp_request.url.hostname OR query.hostname
Processprocess.name OR actor.process.name
Filefile.path OR file.name
URLhttp_request.url.url_string
Email addressactor.user.email_addr OR user.email_addr
src_endpoint.ip="203.0.113.51" OR dst_endpoint.ip="203.0.113.51" | stats count by metadata.log_source, class_name

Event identity

PathMeaning
timeEvent time (epoch milliseconds)
metadata.uidUnique event id
metadata.log_sourceLog source the event came from (lowercase)
metadata.product.name, metadata.product.vendor_nameProduct and vendor that produced the log
metadata.log_name, metadata.log_providerLog name and provider, where the source has them
metadata.versionOCSF schema version (1.9.0)
class_uid, class_nameEvent class
category_uid, category_nameClass category
activity_id, activity_nameActivity within the class
type_uidclass_uid * 100 + activity_id
severity_id, severityNormalized severity (0–6) and its label
status_id, status, status_detailOutcome: 1 Success, 2 Failure
messageReadable summary
raw_dataOriginal log line
unmapped.<key>Source fields with no OCSF home

Network endpoints

PathMeaning
src_endpoint.ip, src_endpoint.port, src_endpoint.hostname, src_endpoint.macSource
dst_endpoint.ip, dst_endpoint.port, dst_endpoint.hostname, dst_endpoint.macDestination (dst_, not dest_)
connection_info.protocol_name, connection_info.protocol_numTransport protocol (tcp, 6)
connection_info.direction, connection_info.direction_idConnection direction
traffic.bytes_in, traffic.bytes_outBytes destination→source and source→destination
traffic.packets_in, traffic.packets_outPackets in each direction
durationConnection duration

Hosts and devices

PathMeaning
device.hostnameHost the event happened on (endpoint classes: process, file, registry)
src_endpoint.hostname, dst_endpoint.hostnameHosts on each side of a network event

Users and authentication

PathMeaning
user.name, user.uid, user.domain, user.email_addrThe account the event is about (the logon account in Authentication; the target account in user/group management)
actor.user.name, actor.user.uid, actor.user.domain, actor.user.typeThe account that performed the action
auth_protocol, auth_protocol_idAuthentication protocol (Windows: 1 NTLM, 2 Kerberos)
logon_type, logon_type_idLogon type
is_mfa, is_remote, is_cleartextAuthentication flags
session.uidSession or logon id
class_uid=3002 status_id=2 | stats count, dc(src_endpoint.ip) as sources by user.name | where count > 20

Processes

PathMeaning
process.name, process.cmd_line, process.pid, process.uidProcess Activity (1007): the process the event is about
process.file.path, process.file.hashes.valueIts executable and hashes
actor.process.name, actor.process.cmd_line, actor.process.pid, actor.process.uidThe acting process. On Process Activity this is the parent.
actor.process.file.path, actor.process.file.hashes.valueThe acting process's executable and hashes
actor.process.parent_process.*Parent of the acting process, on network, file and DNS classes where the source provides it
class_uid=1007 actor.process.name="winword.exe" process.name="powershell.exe" | table time, device.hostname, process.cmd_line

Files, modules and registry

PathMeaning
file.path, file.name, file.type_idFile the event is about
file.hashes.value, file.hashes.algorithm_idFile hashes (a list; .value matches any)
module.file.path, module.file.nameLoaded module (Module Activity)
reg_key.pathRegistry key
reg_value.name, reg_value.path, reg_value.dataRegistry value

HTTP and URLs

PathMeaning
http_request.http_methodRequest method
http_request.url.url_string, http_request.url.hostname, http_request.url.path, http_request.url.schemeRequest URL (HTTP Activity)
http_request.url.categoriesURL categories, where the source provides them
http_request.user_agent, http_request.referrerUser agent and referrer
http_response.codeHTTP status code
http_response.status, http_response.length, http_response.content_typeResponse status text, size and content type
url.url_string, url.hostnameURL on network and other non-HTTP classes
class_uid=4002 http_response.code>=500 | stats count by http_request.url.hostname, http_response.code

DNS and email

PathMeaning
query.hostnameDNS query name
answers.rdataDNS answers (a list)
email.from, email.to, email.subject, email.message_uidEmail sender, recipients (a list), subject and message id

Cloud and API

PathMeaning
cloud.provider, cloud.regionCloud provider and region
cloud.account.uid, cloud.account.nameCloud account
api.service.name, api.operationService and operation called
resources.uid, resources.name, resources.typeResources acted on (a list)
metadata.log_source=aws_cloudtrail api.operation="DeleteTrail" | table time, cloud.account.uid, actor.user.name, src_endpoint.ip

Findings, risk and observables

PathMeaning
finding_info.uid, finding_info.titleFinding id and title
finding_info.analytic.name, finding_info.analytic.uidDetection rule that produced the finding
finding_info.attacks.technique.uid, finding_info.attacks.tactic.nameMITRE ATT&CK mapping
finding_info.related_events.uidEvents that matched
risk_score, risk_level, risk_level_id, risk_detailsRisk on the finding
observables.name, observables.type, observables.valueObservables (lists)
vulnerabilities.cve.uidCVE ids (a list)

nano's own detection findings are under metadata.log_source=findings.

Enrichment

PathMeaning
src_endpoint.location.country, dst_endpoint.location.countryCountry code
src_endpoint.autonomous_system.number, src_endpoint.autonomous_system.nameASN (and the dst_endpoint equivalents)
enrichments.name, enrichments.value, enrichments.type, enrichments.provider, enrichments.short_descEnrichment records (lists)
enrichments.data.*Feed-specific payload

Which feed writes which path is in Enrichment field reference.

Event classes

Classes emitted by nano's OCSF 1.9 parsers.

class_uidClassCategory
0Base Event—
1001File System ActivitySystem Activity
1002Kernel Extension ActivitySystem Activity
1005Module ActivitySystem Activity
1006Scheduled Job ActivitySystem Activity
1007Process ActivitySystem Activity
1008Event Log ActivitySystem Activity
1009Script ActivitySystem Activity
1012Clipboard ActivitySystem Activity
2004Detection FindingFindings
3002AuthenticationIdentity & Access Management
3003Authorize SessionIdentity & Access Management
3004Entity ManagementIdentity & Access Management
3006Group ManagementIdentity & Access Management
3007User ManagementIdentity & Access Management
4001Network ActivityNetwork Activity
4002HTTP ActivityNetwork Activity
4003DNS ActivityNetwork Activity
4004DHCP ActivityNetwork Activity
4005RDP ActivityNetwork Activity
4006SMB ActivityNetwork Activity
4007SSH ActivityNetwork Activity
4008FTP ActivityNetwork Activity
4009Email ActivityNetwork Activity
4014Tunnel ActivityNetwork Activity
5001Device Inventory InfoDiscovery
5003User Inventory InfoDiscovery
5020Software Inventory InfoDiscovery
6002Application LifecycleApplication Activity
6003API ActivityApplication Activity
6006File Hosting ActivityApplication Activity
201001Registry Key ActivitySystem Activity (Windows extension)
201002Registry Value ActivitySystem Activity (Windows extension)
201003Windows Resource ActivitySystem Activity (Windows extension)
201004Windows Service ActivitySystem Activity (Windows extension)

type_uid combines class and activity: Authentication (3002) Logon (1) is 300201.

Which sources emit which classes: Supported sources.

What's next

On this page