You can set up filters for Windows log files to explicitly include or exclude log events.

About this task

You use the whitelist and blacklist parameters to evaluate a filter expression. The filter expression is a Boolean expression that consists of event fields and operators.

Note:

The blacklist option only works for fields; it cannot be used to blacklist text.

  • whitelist collects only log events for which the filter expression evaluates to non-zero. If you omit whitelist, the value is an implied 1.

  • blacklist excludes log events for which the filter expression evaluates to non-zero. The default value is 0.

For a complete list of Windows event fields and operators see Event Fields and Operators.

Prerequisites

Log in to the Windows machine on which you installed the vRealize Log Insight Windows agent and start the Services manager to verify that the vRealize Log Insight agent service is installed.

Procedure

  1. Navigate to the program data folder of the vRealize Log Insight Windows agent.

    %ProgramData%\VMware\Log Insight Agent

  2. Open the liagent.ini file in any text editor.
  3. Add a whitelist or blacklist parameter in the [filelog|] section.

    For example:

    [filelog|apache]
    directory = path_to_log_directory
    include = glob_pattern
    blacklist = filter_expression
  4. Create a filter expression from Windows events fields and operators.

    For example

    whitelist = myServer
  5. Save and close the liagent.ini file.

Filter Configurations

You can configure the agent to collect only Apache logs where the server_name is

[filelog|apache]
directory=C:\Program Files\Apache Software Foundation\Apache2.4\logs
include=error.log
parser=clf
whitelist = server_name == "sample.com"
blacklist = remote_host == "127.0.0.1"