Build a small Wazuh SIEM lab
Deploy a single-node learning environment, add one endpoint, verify log flow, and document the first useful alert.
Scope
For learners with an isolated Linux virtual machine and one disposable endpoint.
Start with the situation, not the slogan
This lab is designed to produce evidence and judgement, not a ceremonial screenshot of a tool running. Build a small Wazuh SIEM lab is successful when you can explain the question, predict the expected observation, collect it safely and distinguish a useful result from noise. The commands are the least interesting part, although they are traditionally the part everyone photographs.
Use systems you own or have explicit permission to test. Keep the exercise isolated from household, client and production networks, take a snapshot before deliberate breakage, and write the rollback step before the first change. A lab without a reset path is simply a future troubleshooting appointment.
Installing a dashboard is not the same as building detection. The lab focuses on data path, timestamps, agent health, one controlled event, and evidence of alert processing.
Composite scenario
How this usually reaches the desk
Set one modest objective for the session. Begin with the expected clue: The agent is enrolled, healthy, time-synchronised, and sending the intended log source. Then create or collect only enough benign activity to make that clue visible. If the observation does not appear, investigate the data path before adding more tools. Instrumentation that cannot see a known test event will not become more perceptive during a real incident.
This scenario combines common operational patterns; it is not presented as a report of one named incident.
What to look for
Begin with preserved, comparable evidence. One signal is rarely proof; use independent observations and a reliable timeline before declaring scope or intent.
The agent is enrolled, healthy, time-synchronised, and sending the intended log source.
Write the expected observation before the exercise. Include the source, destination, time and field that should carry it; this turns an interesting screen into a falsifiable test.
A safe test event appears in raw data and in a normalised alert with the expected fields.
Confirm that clocks, names and identifiers line up across the lab. Time drift and ambiguous hostnames can turn three tidy events into an accidental detective novel.
Storage, credentials, certificates, and network exposure match the lab boundary.
Keep a known-good comparison. The aim is not merely to produce an alert or packet, but to explain how the test differs from ordinary activity and where false positives would arise.
Working examples
Run it, read it, decide what changes
These examples use documentation addresses, test identities and bounded targets. Replace placeholders only inside systems you own or are explicitly authorised to operate. Read the expected result and next action before running the command; a successful command is evidence, not yet a conclusion.
Verify that the Wazuh agent is connected
- Prerequisites
- Shell access to the manager.
sudo /var/ossec/bin/agent_control -lcConnected agents are listed as active with their IDs and addresses.
An active status proves recent communication, not that every log source or rule is working.
Choose one agent and generate a harmless known event that its configured data source should collect.
Generate and find a benign authentication failure
- Prerequisites
- A lab agent configured to collect syslog.
logger -p auth.warning -t nmf-lab "NMF_TEST failed login for test-user"
sudo tail -n 20 /var/ossec/logs/ossec.logThe local logger sends a recognisable message; the agent log should show continued operation.
The message reaching syslog is not proof that Wazuh decoded or alerted on it.
Search the dashboard for `NMF_TEST`, inspect decoder/rule fields, and record the end-to-end delay.
Test one log line with wazuh-logtest
- Prerequisites
- A representative, non-sensitive log line.
sudo /var/ossec/bin/wazuh-logtest
Aug 18 08:30:00 lab sshd[1234]: Failed password for invalid user test from 192.0.2.50 port 55555 ssh2The tool shows decoding phases and any matched rule without creating a real login attempt.
A synthetic line proves parser behaviour for that format only; production timestamps and variants may differ.
Add boundary samples, tune the rule in the supported local-rules location, restart safely, and repeat the known event.
Lab procedure
Read the whole sequence before starting. Several workstreams may run in parallel, but their evidence, authority and expected outcomes still need to be explicit. Every step below points back to a concrete example; use the example as implementation evidence, not as permission to operate outside the stated scope.
Operational judgement
Keep a lab notebook with four columns: time, action, expected evidence and observed evidence. Add screenshots only when they preserve information that text cannot. The notebook should allow another person to repeat the exercise without inheriting your browser history, shell history and particular relationship with luck.
The transfer-to-production question matters more than the demo. For Wazuh, SIEM and Logs, consider data volume, retention, credentials, privacy, performance, ownership and failure behaviour. A successful lab proves that a mechanism can work under stated conditions; it does not prove that it can be deployed everywhere before lunch.
Handover
Make the result useful to the next person
Turn the exercise into a reusable lab card. Record the learning objective, isolation boundary, diagram, versions, seed data, expected observations, exact queries, screenshots that add real information, and the reset procedure. Mark which evidence was generated and which was supplied. If the lab uses a deliberately vulnerable image or sample, store its provenance and checksum. Future-you is a different operator and deserves better documentation than “it worked after I restarted something”.
End with a short teach-back. Explain why “Review current Wazuh requirements and size a single-node deployment only for the small lab workload.” matters, demonstrate the observation that supports the conclusion, and show how the environment returns to baseline after “Document reset, upgrade, backup, and removal steps before adding additional endpoints.” Then name one production assumption the lab did not test. That last sentence keeps a useful experiment from turning into unjustified confidence and gives the next exercise a sensible place to begin.
Validate before you close
The test passes when the event is visible end to end, the alert fields explain why it matched, and the lab can be reset without leaving agents or exposed services behind.
Capture the test, the expected result and the observed result. Where a person or business owner must accept restored service, name them in the record. A green dashboard can confirm that a component is answering; it cannot confirm that invoices, identities or restored data are trustworthy.
Finish with a compact closure note: the original trigger, confirmed scope, evidence retained, controls changed, tests passed, known gaps, residual risk, and the people responsible for the remaining work. Schedule a review while the timeline is still fresh enough to challenge. The purpose is not to find a person to blame; computers already perform blame with admirable efficiency. The purpose is to make the next response faster, safer and less dependent on one person remembering where the useful log was hidden.
Common mistakes
- Connecting an intentionally weak lab directly to a home or production network.
- Copying commands without recording the expected evidence and rollback step.
- Calling a test successful without comparing the result to a known-good baseline.
These errors usually come from haste, unclear ownership or misplaced confidence. Build the safeguard into the runbook: a required evidence field, a second-person review, a rollback test or a specific exit criterion.
Questions people ask when the clock is running
Can I run this against a public target for practice?
No. Keep the work to systems you own or are explicitly authorised to assess. An educational intention is not an access-control mechanism and will not improve the conversation with a provider or solicitor.
What should I save from the exercise?
Keep the topology, versions, raw evidence, exact filters or rules, expected result, observed result and rollback notes. Remove real secrets and personal data before sharing the notebook.
How do I know the lab worked?
The test passes when the event is visible end to end, the alert fields explain why it matched, and the lab can be reset without leaving agents or exposed services behind. Repeat the key observation from a clean snapshot; repeatability is a stronger result than a single attractive screenshot.
Safety boundary
Use these steps only on systems you own or are explicitly authorised to assess. Preserve evidence, follow your organisation’s legal and regulatory obligations, and prefer reversible actions when the situation is not yet understood.
Primary references
- Wazuh QuickstartWazuh
- Wazuh Data AnalysisWazuh
Editorial status: first edition. Review the linked vendor documentation for product- and version-specific changes before acting.