OCSF field reference
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.
| Entity | Paths |
|---|---|
| User | actor.user.name OR user.name |
| Host | device.hostname OR src_endpoint.hostname OR dst_endpoint.hostname |
| IP | src_endpoint.ip OR dst_endpoint.ip |
| Hash | file.hashes.value OR process.file.hashes.value OR actor.process.file.hashes.value |
| Domain | http_request.url.hostname OR query.hostname |
| Process | process.name OR actor.process.name |
| File | file.path OR file.name |
| URL | http_request.url.url_string |
| Email address | actor.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_nameEvent identity
| Path | Meaning |
|---|---|
time | Event time (epoch milliseconds) |
metadata.uid | Unique event id |
metadata.log_source | Log source the event came from (lowercase) |
metadata.product.name, metadata.product.vendor_name | Product and vendor that produced the log |
metadata.log_name, metadata.log_provider | Log name and provider, where the source has them |
metadata.version | OCSF schema version (1.9.0) |
class_uid, class_name | Event class |
category_uid, category_name | Class category |
activity_id, activity_name | Activity within the class |
type_uid | class_uid * 100 + activity_id |
severity_id, severity | Normalized severity (0–6) and its label |
status_id, status, status_detail | Outcome: 1 Success, 2 Failure |
message | Readable summary |
raw_data | Original log line |
unmapped.<key> | Source fields with no OCSF home |
Network endpoints
| Path | Meaning |
|---|---|
src_endpoint.ip, src_endpoint.port, src_endpoint.hostname, src_endpoint.mac | Source |
dst_endpoint.ip, dst_endpoint.port, dst_endpoint.hostname, dst_endpoint.mac | Destination (dst_, not dest_) |
connection_info.protocol_name, connection_info.protocol_num | Transport protocol (tcp, 6) |
connection_info.direction, connection_info.direction_id | Connection direction |
traffic.bytes_in, traffic.bytes_out | Bytes destination→source and source→destination |
traffic.packets_in, traffic.packets_out | Packets in each direction |
duration | Connection duration |
Hosts and devices
| Path | Meaning |
|---|---|
device.hostname | Host the event happened on (endpoint classes: process, file, registry) |
src_endpoint.hostname, dst_endpoint.hostname | Hosts on each side of a network event |
Users and authentication
| Path | Meaning |
|---|---|
user.name, user.uid, user.domain, user.email_addr | The 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.type | The account that performed the action |
auth_protocol, auth_protocol_id | Authentication protocol (Windows: 1 NTLM, 2 Kerberos) |
logon_type, logon_type_id | Logon type |
is_mfa, is_remote, is_cleartext | Authentication flags |
session.uid | Session or logon id |
class_uid=3002 status_id=2 | stats count, dc(src_endpoint.ip) as sources by user.name | where count > 20Processes
| Path | Meaning |
|---|---|
process.name, process.cmd_line, process.pid, process.uid | Process Activity (1007): the process the event is about |
process.file.path, process.file.hashes.value | Its executable and hashes |
actor.process.name, actor.process.cmd_line, actor.process.pid, actor.process.uid | The acting process. On Process Activity this is the parent. |
actor.process.file.path, actor.process.file.hashes.value | The 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_lineFiles, modules and registry
| Path | Meaning |
|---|---|
file.path, file.name, file.type_id | File the event is about |
file.hashes.value, file.hashes.algorithm_id | File hashes (a list; .value matches any) |
module.file.path, module.file.name | Loaded module (Module Activity) |
reg_key.path | Registry key |
reg_value.name, reg_value.path, reg_value.data | Registry value |
HTTP and URLs
| Path | Meaning |
|---|---|
http_request.http_method | Request method |
http_request.url.url_string, http_request.url.hostname, http_request.url.path, http_request.url.scheme | Request URL (HTTP Activity) |
http_request.url.categories | URL categories, where the source provides them |
http_request.user_agent, http_request.referrer | User agent and referrer |
http_response.code | HTTP status code |
http_response.status, http_response.length, http_response.content_type | Response status text, size and content type |
url.url_string, url.hostname | URL on network and other non-HTTP classes |
class_uid=4002 http_response.code>=500 | stats count by http_request.url.hostname, http_response.codeDNS and email
| Path | Meaning |
|---|---|
query.hostname | DNS query name |
answers.rdata | DNS answers (a list) |
email.from, email.to, email.subject, email.message_uid | Email sender, recipients (a list), subject and message id |
Cloud and API
| Path | Meaning |
|---|---|
cloud.provider, cloud.region | Cloud provider and region |
cloud.account.uid, cloud.account.name | Cloud account |
api.service.name, api.operation | Service and operation called |
resources.uid, resources.name, resources.type | Resources acted on (a list) |
metadata.log_source=aws_cloudtrail api.operation="DeleteTrail" | table time, cloud.account.uid, actor.user.name, src_endpoint.ipFindings, risk and observables
| Path | Meaning |
|---|---|
finding_info.uid, finding_info.title | Finding id and title |
finding_info.analytic.name, finding_info.analytic.uid | Detection rule that produced the finding |
finding_info.attacks.technique.uid, finding_info.attacks.tactic.name | MITRE ATT&CK mapping |
finding_info.related_events.uid | Events that matched |
risk_score, risk_level, risk_level_id, risk_details | Risk on the finding |
observables.name, observables.type, observables.value | Observables (lists) |
vulnerabilities.cve.uid | CVE ids (a list) |
nano's own detection findings are under metadata.log_source=findings.
Enrichment
| Path | Meaning |
|---|---|
src_endpoint.location.country, dst_endpoint.location.country | Country code |
src_endpoint.autonomous_system.number, src_endpoint.autonomous_system.name | ASN (and the dst_endpoint equivalents) |
enrichments.name, enrichments.value, enrichments.type, enrichments.provider, enrichments.short_desc | Enrichment 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_uid | Class | Category |
|---|---|---|
0 | Base Event | — |
1001 | File System Activity | System Activity |
1002 | Kernel Extension Activity | System Activity |
1005 | Module Activity | System Activity |
1006 | Scheduled Job Activity | System Activity |
1007 | Process Activity | System Activity |
1008 | Event Log Activity | System Activity |
1009 | Script Activity | System Activity |
1012 | Clipboard Activity | System Activity |
2004 | Detection Finding | Findings |
3002 | Authentication | Identity & Access Management |
3003 | Authorize Session | Identity & Access Management |
3004 | Entity Management | Identity & Access Management |
3006 | Group Management | Identity & Access Management |
3007 | User Management | Identity & Access Management |
4001 | Network Activity | Network Activity |
4002 | HTTP Activity | Network Activity |
4003 | DNS Activity | Network Activity |
4004 | DHCP Activity | Network Activity |
4005 | RDP Activity | Network Activity |
4006 | SMB Activity | Network Activity |
4007 | SSH Activity | Network Activity |
4008 | FTP Activity | Network Activity |
4009 | Email Activity | Network Activity |
4014 | Tunnel Activity | Network Activity |
5001 | Device Inventory Info | Discovery |
5003 | User Inventory Info | Discovery |
5020 | Software Inventory Info | Discovery |
6002 | Application Lifecycle | Application Activity |
6003 | API Activity | Application Activity |
6006 | File Hosting Activity | Application Activity |
201001 | Registry Key Activity | System Activity (Windows extension) |
201002 | Registry Value Activity | System Activity (Windows extension) |
201003 | Windows Resource Activity | System Activity (Windows extension) |
201004 | Windows Service Activity | System 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
Rarity thresholds
Configure prevalence tracking: the host-count rarity threshold, which artifact types are tracked, and how long prevalence data is kept.
Supported sources
nano's OCSF 1.9 parser catalog: each source's log source name and the OCSF classes it emits, and the ways to send data on each deployment.