Skip to main content

Task Event Log - Event Log Read​

The Event log - read Task reads the entries of a Windows event log on the Server computer or on a remote computer that match a filter, and writes chosen fields of them to the output.

Event log - read tab, with the scope settings and the event log entry filter

The Main settings, Flow, On error, Conditions and TimeOut tabs are the same for every Task; see Job - Tasks.

Event log - read tab​

Scope

  • Local (default): reads the event log of the Server computer
  • Remote: reads the event log of another computer. Enter its host name or IP address in the box next to it, or select it from the list of network computers
  • The Credential: the Credential used to read a remote event log. It is used only with Remote. Click the settings button to open Manage credentials; see Credentials

Event log entry filter

  • Event log: the event log to read, "Application" by default
  • Source, Entry type, Category ID, Category, Event ID, Message: a condition and a value for each field. "Don't check" (default) leaves the field out of the filter, and its value box is not available

An entry is returned when it matches every condition that is not "Don't check". The conditions are:

  • Entry type: "Don't check", Equal (=) or Not equal (!=), with the entry type "Information" (default), "Any", "Error", "Failure Audit", "Success Audit" or "Warning". With Equal (=), "Any" matches no entry; to read every type, set the condition to "Don't check" and filter on another field
  • Category ID and Event ID: Equal (=), Not equal (!=), Larger than (>), Larger than or equal (>=), Smaller than (<) or Smaller than or equal (<=), with a number
  • Source, Category and Message: the same conditions, and also Contains (=%) and Not contains (!=%). Use "Larger than" and "Smaller than" only with numbers: with text, the Task fails

Values may contain Variables.

warning

Not equal (!=) on Source, Category ID, Category, Event ID or Message matches every entry. For text, use Not contains (!=%).

With every condition set to "Don't check", no entry is returned, the output is empty, and the Task reports success. Set at least one condition.

With XML object selected, no output is written, and the Task reports success.

Event log - read: Output tab​

Result

  • Limit result to top row count: returns only the number of entries entered, "1" by default. The newest entries are read first

Output format

  • XML object: no output is written, and the Task reports success
  • Specific string values: writes the fields selected in the list, one line for each entry. Select a field and click Add; click Delete selected to remove fields. The fields are InstanceID, EventID, CategoryID, Category, Source, EntryType, Message, Username and TimeGenerated
  • Include field names: writes the field names in the first line
  • Field separator: the character between fields, "Tab" by default
  • Text qualifier: an optional character around each value
  • Line break: the character between entries, "CrLf" by default

Output and errors​

If the event log cannot be read, the Task fails.