ossec-analysisd

The ossec-analysisd program receives the log messages and compares them to the rules. It then creates an alert when a log message matches an applicable rule.

-c <config>

Run using <config> as the configuration file.

-D <dir>

Chroot to <dir>.

-d

Run in debug mode. This option may be repeated to increase the verbosity of the debug messages.

-f

Run in the foreground.

-g <group>

Run as a group.

-h

Display the help message.

-t

Test configuration.

-u

Run as a specific user.

-V

Display the version and license information.

Daemon multithreaded internal structure

How this works

  1. The socket receives the message and sends it to the respective decoder queue. They can be one of the following:
    1. Syscheck event decoder queue.

    2. Syscollector event decoder queue.

    3. Rootcheck event decoder queue.

    4. Hostinfo event decoder queue.

    5. Event decoder queue.

    6. Windows event decoder queue.

    If the selected queue is full, the event is dropped.

  2. Each decoder thread:
    1. Takes out the event from it's queue.

    2. Cleans the event.

    3. Decodes the event.

    4. Sends the event to the rule matching queue.

  3. Each rule matching thread:
    1. Takes the event from the queue.

    2. Runs rule matching.

    3. If the event is a firewall event, it is sent to the firewall queue.

    4. If the event has statistical flag, it is sent to the statistical queue.

    5. If the event has the FTS flag, it is sent to the FTS queue.

    6. If an alert is generated, it is sent to the alert queue.

    7. If logall is activated, the event is sent to the archives queue.

  4. Each writer thread:
    1. Takes the event from the queue.

    2. Stores the element in memory to be written on it's own log file.

  5. Logging:
    1. Every 1 second, all the log files are written to the HDD.

    2. Every 5 seconds (by default, if not overridden), the status file for Analysisd is generated.

Flow example of an event

The image below shows the flow for a Rootcheck event that generates an alert.

As you can see, every part of the Analysisd multithreaded engine is independent from one another, except for the rule matching threads that shares the same queue.

Automatic leveling of the threads

By default, when Analysisd starts it will spawn the number of threads based on the number of CPU cores of the machine where it's running. For example, if the machine has 4 physical cores, the following threads will be created:

  • 4 threads for decoders (4 for Syscheck, 4 for Syscollector, 4 for Rootcheck, 4 for Hostinfo and 4 for others).

  • 4 threads for rule matching.

This default configuration can be changed on the internal_options.conf file by changing the fields from the table below:

analysisd.event_threads

Description

Number of event decoder threads.

Default value

0

Allowed value

0: Sets the number of threads according to the number of cpu cores.

Any integer between 0 and 32.

analysisd.syscheck_threads

Description

Number of Syscheck event decoder threads.

Default value

0

Allowed value

0: Sets the number of threads according to the number of cpu cores.

Any integer between 0 and 32.

analysisd.syscollector_threads

Description

Number of Syscollector event decoder threads.

Default value

0

Allowed value

0: Sets the number of threads according to the number of cpu cores.

Any integer between 0 and 32.

analysisd.rootcheck_threads

Description

Number of Rootcheck event decoder threads.

Default value

0

Allowed value

0: Sets the number of threads according to the number of cpu cores.

Any integer between 0 and 32.

analysisd.hostinfo_threads

Description

Number of hostinfo event decoder threads.

Default value

0

Allowed value

0: Sets the number of threads according to the number of cpu cores.

Any integer between 0 and 32.

analysisd.rule_matching_threads

Description

Number of rule matching threads.

Default value

0

Allowed value

0: Sets the number of threads according to the number of cpu cores.

Any integer between 0 and 32.

analysisd.winevt_threads

Description

Number of rule matching threads.

Default value

0

Allowed value

0: Sets the number of threads according to the number of cpu cores.

Any integer between 0 and 32.

For example, if the mananger receives little Rootcheck events, we can decrease the number of threads for the Rootcheck decoder.