Skip to main content
Operating system & services

Event Log

Scan the Windows Event Log for errors or missing expected events and get alerted when your thresholds are reached.

The Event Log check scans the Windows Event Log for entries at or above a specified severity level and raises an alert when the count reaches or exceeds a threshold. Instead of manually checking the event logs on each device, you set a threshold and octoja notifies you when something needs attention. The check is Windows-only and runs every 15 minutes by default. For Linux and macOS, use the System Log Check instead, which monitors syslog/journald.

Prerequisites

  • You need the Monitoring Check Management permission.
  • The target device must be running Windows with a connected agent.

Steps

Event Log check editor on NORTHWIND-FS01 with the Add Check confirm button highlighted

  1. Go to Devices and open the device.
  2. Click the Checks tab → Add Check → Event Log.
  3. Choose the Event Logs and the Minimum severity. Lookback period, Maximum event details, Filter scan limit per log, and the two threshold counts live behind Show advanced options — toggle it open to see them.
  4. Optionally, narrow the check further. Include only matching events counts nothing but the events matching your rules, Exclude specific events drops individual events, and Exclude sources filters out known noisy event sources that produce harmless errors. Use Add to append a rule.
  5. Optionally, invert the logic with Expected events (alert when missing): the check alerts when an event that should appear is missing within the lookback period.
  6. Click Add Check.

After the first check interval, the result appears in the device's Checks tab.

Settings

FieldTypeRequiredDefaultDescription
Event Logslist of stringsNoSystem, ApplicationWhich event logs to scan
Minimum severityradio (one of five)NoCritical + ErrorMinimum severity to match. Inclusive: the selected option includes that level and every more severe level. Options: Critical only, Critical + Error, Critical + Error + Warning, Through Information, All levels (including Verbose). No other values are accepted.
Include only matching eventslist of rulesNo—Only events matching at least one rule are counted. Each rule has Event ID, Source and Message contains — fill at least one field per rule, and every filled field must match. Message contains reads the message text as it appears in Event Viewer and ignores upper and lower case. Leave the list empty to count all events at the selected severity.
Exclude sourceslist of stringsNo—Event sources to ignore (e.g. ESENT, DistributedCOM)
Exclude specific eventslist of rulesNo—Events matching at least one rule are ignored. Same fields as Include only matching events: Event ID, Source and Message contains.
Expected events (alert when missing)list of rulesNo—Inverts the logic: the check alerts when an event that should appear is missing within the lookback period — for example a daily backup that logs a success event. Give a source and/or event ID so the match is reliable, and set the lookback to cover the expected interval (for example 1440 minutes for a daily job). On top of the three matching fields each rule adds Minimum count (default 1) — the number of times the event has to appear before the rule counts as satisfied — and Severity when missing, either Warning (default) or Critical. Expected events are matched no matter what Minimum severity is set to, so an Information-level heartbeat is still found.
Lookback period (minutes)minutesNo (advanced)60How far back from the current time to search. Hidden behind Show advanced options under the Query settings section.
Maximum event detailsintegerNo (advanced)50Maximum matching events shown in the result. Without include rules or message-text exclusions this also limits how many events are read per log. Hidden behind Show advanced options under the Query settings section.
Filter scan limit per logintegerNo (advanced)1000Maximum candidate events scanned per log when include rules or message-text exclusions are used. If the limit is reached, the check reports a warning and says so in the result. Hidden behind Show advanced options under the Query settings section.
Warning threshold (event count)integerNo (advanced)5Number of matching events that triggers a warning. Set it to 0 to switch the warning threshold off. Hidden behind Show advanced options under the Thresholds section.
Critical threshold (event count)integerNo (advanced)20Number of matching events that triggers a critical result. Set it to 0 to switch the critical threshold off. Hidden behind Show advanced options under the Thresholds section.

Interval is a check-level setting and is not part of the per-assignment configuration. Set the lookback period to match or exceed the check interval to avoid gaps between runs; with the 15-minute interval, the default 60-minute lookback misses no events between runs.

Severity levels

LevelValueDescription
Critical1System is unusable or data loss has occurred
Error2An operation failed
Warning3Something may need attention soon
Information4Normal operation was recorded
Verbose5Detailed tracing output

Critical only, Critical + Error and Critical + Error + Warning count levels 1 to 3 only, so informational entries stay out of the totals. Through Information also picks up events that Windows records without a level, which Event Viewer displays as Information. All levels (including Verbose) removes the cap altogether, so provider-defined levels above 5 are counted as well.

Results

The check reports a warning or critical result as soon as the number of matching events reaches or exceeds the Warning threshold (event count) or Critical threshold (event count). If an expected event is missing, it reports the Severity when missing chosen in that rule.

The result includes:

  • Total count of matching events across the selected logs. With include rules or message-text exclusions the full filtered count is reported, up to Filter scan limit per log for each log; otherwise the count is capped at Maximum event details
  • The most recent matching entries (up to Maximum event details, default 50), each with its source, event ID, log name, message, and timestamp. This helps you spot patterns — for example, a single source flooding the log with repeated errors
  • One result per expected-event rule: how many matches were found, the required minimum, and whether the rule was satisfied
  • List of logs that were requested but could not be read

An OK result does not confirm that every requested log was readable: read errors appear under Skipped logs but do not directly affect the overall status. That status comes from the collected events and expected-event rules. For skipped logs, verify their names and the agent service's read access before treating the result as a complete check.

The default cap of 50 shown events keeps the result payload manageable. If you need more detail, open the device's Event Log view in the toolbox to browse entries directly — or query the event log via the remote terminal.

Tips

  • Start with the System and Application logs. These cover the most common issues (service failures, driver errors, application crashes). Add specialized logs like Security only when needed.
  • Use Exclude sources for event sources that produce frequent, harmless errors. Common examples: ESENT and DistributedCOM.

FAQ

Yes, through the local event log on each participating server. Enter DFS Replication as the log name, including on German Windows, and select the required severities. Use include rules to narrow the check to relevant event IDs. Validate the rules against existing events and choose suitable count thresholds and a sufficiently long lookback.

This monitors logged problems, not the number of pending files. It does not replace a DFSR backlog counter, and an empty result does not prove healthy replication. Do not blanket-grant administrator rights to computer accounts just to work around denied remote backlog access.