Findings fields

The findings data streams store findings generated by detection rules. Wazuh creates one data stream for each event category, for example wazuh-findings-v5-security and wazuh-findings-v5-system-activity. You can query all of them with the wazuh-findings-v5* index pattern.

Findings include all the event fields, plus fields that describe the rule that matched and the case the finding belongs to:

  • wazuh.rule.*: The rule that generated the finding, including its ID, title, level, and status, its MITRE ATT&CK mapping (wazuh.rule.mitre.*), its compliance requirements (wazuh.rule.compliance.*), and the Sigma rule it was imported from (wazuh.rule.sigma_id).

  • wazuh.case.*: The case the finding is attached to, including its title, status, severity, priority, TLP classification, owner, and comments.

  • event.doc_id and event.index: The ID and the backing index of the event that matched the rule.

The complete list of findings fields is in the fields.csv and wcs_flat.yml files of the stateless/events/findings module.

Example: Set the level of a finding from a rule

Decoders don't write findings fields. Wazuh creates a finding when an event matches a rule, and copies the rule's details into wazuh.rule.*. wazuh.rule.level comes from the rule's level. This rule matches the failed SSH logins that the system-auth integration decodes from the authentication log of a Linux endpoint.

Create the rule in Ruleset management > Detection > Rules. The rule's logsource.product must match the title of the integration you create it in. The events come from the built-in system-auth integration, so create the rule in a custom integration titled system-auth. Then promote it to the custom space and add it to a custom detector in Ruleset management > Detection > Detectors. The highlighted lines show where wazuh.rule.level is used and where it appears in the output.

Rule

logsource:
  product: system-auth
level: high
status: experimental
enabled: true
tags:
  - attack.credential-access
  - attack.t1110
detection:
  condition: selection
  selection:
    event.dataset: system-auth
    event.outcome: failure
metadata:
  title: SSH authentication failure
  author: Security Team
  description: Detects a failed SSH authentication on a monitored endpoint.

Finding (excerpt)

{
  "_index": ".ds-wazuh-findings-v5-system-activity-000001",
  "_source": {
    "event": {
      "dataset": "system-auth",
      "action": "connection-closed",
      "outcome": "failure",
      "doc_id": "ncvwq6EBmx_Zvxl5lghO",
      "index": ".ds-wazuh-events-v5-system-activity-000001"
    },
    "user": { "name": "wcsdocsfail" },
    "source": { "ip": "192.168.72.3" },
    "wazuh": {
      "agent": { "name": "Ubuntu" },
      "rule": {
        "title": "SSH authentication failure",
        "level": "high",
        "tags": [ "high", "system-auth", "attack.credential-access", "attack.t1110" ]
      }
    }
  }
}

Note

  • Filter findings by wazuh.rule.level to triage the most severe ones first.

  • The rule level is also the first item of wazuh.rule.tags, followed by the integration and the rule's own tags.

  • event.doc_id and event.index point to the original event in the events data stream.

Fields

Field

Type

Level

Normalization

Indexed

Example

Description

event.doc_id

keyword

custom

true

4cgCE6EBJxulUzH6bBKf

In a finding, the _id of the event that matched the rule.

event.index

keyword

custom

true

.ds-wazuh-events-v5-security-000001

In a finding, the backing index of the event that matched the rule.

wazuh.case.comments

nested

custom

array

true

Array of comments attached to the case, each authored and timestamped independently.

wazuh.case.comments.author

keyword

custom

true

admin

Name of the user that authored the comment.

wazuh.case.comments.comment

match_only_text

custom

true

This is a comment for the case.

Text content of the comment.

wazuh.case.comments.created_at

date

custom

true

1623456789000

Timestamp when the comment was created.

wazuh.case.comments.updated_at

date

custom

true

1623456789000

Timestamp when the comment was last updated.

wazuh.case.created_at

date

custom

true

1623456789000

Timestamp when the case was created.

wazuh.case.description

match_only_text

custom

true

This is a sample description for the case.

Detailed description of the case.

wazuh.case.priority

keyword

custom

true

medium

Priority of the case. One of low, medium, high, urgent.

wazuh.case.severity

keyword

custom

true

medium

Severity of the case. One of informational, low, medium, high, critical.

wazuh.case.status

keyword

custom

true

active

Current status of the case. One of active, acknowledged, completed, error, deleted, audit.

wazuh.case.tags

keyword

custom

array

true

["tag1", "tag2", "tag3"]

Tags attached to the case for organization.

wazuh.case.title

match_only_text

custom

true

Sample Case Title

Title summarizing the case.

wazuh.case.tlp

keyword

custom

true

TLP:CLEAR

Traffic Light Protocol classification of the case. One of TLP:RED, TLP:AMBER, TLP:GREEN, TLP:CLEAR.

wazuh.case.updated_at

date

custom

true

1623456789000

Timestamp when the case was last updated.

wazuh.case.user.name

keyword

custom

true

admin

Name of the user that owns the case. Not editable by the user.

wazuh.rule.author

keyword

extended

array

true

["Star-Lord"]

Rule author

wazuh.rule.category

keyword

extended

true

Attempted Information Leak

Rule category

wazuh.rule.compliance.cmmc

keyword

custom

array

true

["AC.1.001", "AU.L2-3.3.1"]

CMMC requirements.

wazuh.rule.compliance.fedramp

keyword

custom

array

true

["AC-2", "SC-7"]

FedRAMP requirements.

wazuh.rule.compliance.gdpr

keyword

custom

array

true

["Art. 32", "Art. 25"]

GDPR requirements.

wazuh.rule.compliance.hipaa

keyword

custom

array

true

["164.312(a)(1)", "164.308(a)(5)(ii)(C)"]

HIPAA requirements.

wazuh.rule.compliance.iso_27001

keyword

custom

array

true

["A.9.4.1", "A.8.8"]

ISO 27001 requirements.

wazuh.rule.compliance.nis2

keyword

custom

array

true

["Art. 21", "Art. 23"]

NIS2 requirements.

wazuh.rule.compliance.nist_800_171

keyword

custom

array

true

["3.1.1", "3.3.1"]

NIST 800-171 requirements.

wazuh.rule.compliance.nist_800_53

keyword

custom

array

true

["AC-3", "AU-2"]

NIST 800-53 requirements.

wazuh.rule.compliance.pci_dss

keyword

custom

array

true

["2.2.1", "6.3.3"]

PCI DSS requirements.

wazuh.rule.compliance.tsc

keyword

custom

array

true

["CC6.1", "CC7.1"]

TSC requirements.

wazuh.rule.description

keyword

extended

true

Block requests to public DNS over HTTPS / TLS protocols

Rule description

wazuh.rule.id

keyword

extended

true

8784f095-729a-5912-9315-119722b444ed

Rule ID. Under wazuh.rule, the ID of the Wazuh rule that matched.

wazuh.rule.level

keyword

custom

true

high

Severity level of the rule: informational, low, medium, high or critical.

wazuh.rule.license

keyword

extended

true

Apache 2.0

Rule license

wazuh.rule.mitre.subtechnique

object

custom

true

MITRE ATT&CK subtechniques.

wazuh.rule.mitre.subtechnique.id

keyword

custom

array

true

["T1059.001", "T1078.001"]

MITRE ATT&CK subtechnique identifiers.

wazuh.rule.mitre.subtechnique.name

keyword

custom

array

true

["Command and Scripting Interpreter: PowerShell", "Valid Accounts: Default Accounts"]

MITRE ATT&CK subtechnique names.

wazuh.rule.mitre.tactic

object

custom

true

MITRE ATT&CK tactics.

wazuh.rule.mitre.tactic.id

keyword

custom

array

true

["TA0002", "TA0005"]

MITRE ATT&CK tactic identifiers.

wazuh.rule.mitre.tactic.name

keyword

custom

array

true

["Execution", "Defense Evasion"]

MITRE ATT&CK tactic names.

wazuh.rule.mitre.technique

object

custom

true

MITRE ATT&CK techniques.

wazuh.rule.mitre.technique.id

keyword

custom

array

true

["T1059", "T1562"]

MITRE ATT&CK technique identifiers.

wazuh.rule.mitre.technique.name

keyword

custom

array

true

["Command and Scripting Interpreter", "Impair Defenses"]

MITRE ATT&CK technique names.

wazuh.rule.name

keyword

extended

true

BLOCK_DNS_over_TLS

Rule name

wazuh.rule.reference

keyword

extended

true

https://en.wikipedia.org/wiki/DNS_over_TLS

Rule reference URL

wazuh.rule.ruleset

keyword

extended

true

Standard_Protocol_Filters

Rule ruleset

wazuh.rule.sigma_id

keyword

custom

true

5af54681-df95-4c26-854f-2565e13cfab0

Identifier of the Sigma rule the rule was imported from, when it has one.

wazuh.rule.status

keyword

custom

true

stable

Maturity status of the rule: stable, experimental, test, deprecated or unsupported.

wazuh.rule.tags

keyword

custom

array

true

["low", "wazuh-generic-1", "attack.privilege-escalation", "attack.t1548"]

Tags of the rule. Under wazuh.rule, the level, the integration and then the rule tags.

wazuh.rule.title

keyword

custom

true

Sudo command executed - vagrant

Title of the rule. Under wazuh.rule, placeholders are filled with event values.

wazuh.rule.uuid

keyword

extended

true

1100110011

Rule UUID

wazuh.rule.version

keyword

extended

true

1.1

Rule version