Detection Engineering

Detection and Tuning Notes

Write practical detection notes, false-positive notes, tuning recommendations, and collection-gap observations from the SOC lab.

Domain alignment

Detection Engineering SIEM Operations

What this lesson covers

  • Writing practical detection notes
  • Identifying false positives and expected activity
  • Documenting collection gaps
  • Separating tuning ideas from immediate changes
  • Creating a simple detection backlog

Step 1: Pick an alert or missing alert

Detection notes can be written for alerts that fired or for expected activity that did not produce useful visibility.

Detection note types:
- Alert fired and was useful
- Alert fired but was noisy
- Alert fired but severity felt wrong
- Expected activity did not appear
- Activity appeared but lacked context

Step 2: Write the detection note

Detection note:
Event or behavior:
Endpoint:
Rule ID:
Rule description:
Severity:
Was this expected? yes/no
Was the alert useful? yes/no
What context was missing?
False positive reason if applicable:
Recommended tuning:
Risk of tuning too aggressively:
Owner:
Status:

Step 3: Classify the finding

Keep:
  The alert is useful as-is.

Tune:
  The alert is useful but needs filtering, grouping, severity adjustment, or documentation.

Investigate:
  The alert may represent real suspicious behavior.

Improve collection:
  The issue is not the rule. The sensor is not collecting enough context.

Document only:
  The behavior is expected lab activity and does not need a change.

Step 4: Build a small backlog

Detection backlog item:
Title:
Source endpoint:
Problem:
Recommended change:
Expected benefit:
Risk:
Priority:
Next action:

Step 5: Do not tune blindly

In a real SOC, tuning can reduce noise, but it can also hide important behavior. Every tuning decision needs a reason and a rollback path.

Bottom line: Detection engineering starts with observation. Capture what fired, what did not fire, what context was missing, and what change would make the signal better.

Check your understanding

  1. Why can a missing alert be a useful detection note?
  2. Why should tuning recommendations include risk?
  3. What is the difference between tuning and improving collection?
  4. Why should expected lab activity still be documented?
← Previous: Investigating Alerts in Wazuh Series index Next: SOC Incident Workflow →