The Wazuh-Logtest solution is distributed by different components of the Wazuh environment:

Core Logtest

The logtest core is part of the ossec-analysisd.

Wazuh RESTful API

Provides Core Logtest remote interface to test rules and decoders.

wazuh-logtest tool

Wazuh-Logtest replacement for ossec-logtest tool.

Wazuh API and wazuh-logtest tool connect to the ossec-analysisd session manager, this acts as a sandbox with the rules engine, allowing to isolate different users with their own rules and decoders. The below show image illustrations how the user logs test flow through the Wazuh environment.


Wazuh-Logtest is based on the use of isolated sessions, identified with a “token”. Each session stores its own history of events, rules and decoders loaded. When the log evaluation is requested for the first time, the session manager creates a new session, processing and returning the result along with the alphanumeric token as identification of the new session.

Idle session collector

The idle session collector, runs every session_timeout seconds. This parameter is defined in the rule_test section of the ossec.conf file. Every time the collector starts, it searches for sessions that have been idle longer than the time specified in session_timeout to close them.

The following illustration shows how the collector runs on T0, T1, T2 … At the moment the session generates its last request, between T0 and T1, its timeout is between T1 and T2, then on T2 the collector closes the session.

Session lifetime

Sessions have a default expiration time of 15 minutes. When a session remains idle with no log processing requests during that period, the idle session collector closes the session. Requests with an expired session token are also processed, generate a new session token and notify the user.