check-windows-eventlog is a plugin that monitors Windows event logs. It raises an alert when it detects an event matching a specified pattern.
Configurable options
| Option | Abbreviation | Description | Default |
|---|---|---|---|
| --log | Specify the type of event log you want to detect. See the Types of event logs that can be monitored. |
Application | |
| --type | Specify the event type you want to detect. See the Event type to be alerted. |
||
| --source-pattern | Specify the event source you want to detect. | ||
| --source-exclude | Specify the event sources you want to exclude. | ||
| --message-pattern | Specify the string pattern you want to detect with a regular expression. (AND conditions are not supported.) *1 | ||
| --message-exclude | Specify the string pattern you want to exclude with a regular expression. (AND conditions are not supported.) *1 | ||
| --event-id-pattern | Specify event IDs to be detected, Multiple specifications can be specified by separating them with commas, and ranges can be specified with hyphens. | ||
| --event-id-exclude | Specify event IDs to exclude, Multiple specifications can be specified by separating them with commas, and ranges can be specified with hyphens. | ||
| --warning-over | -w | Warning alert occurs if the number of lines matching the detection pattern exceeds the specified value. | 0 |
| --critical-over | -c | Critical alert occurs if the number of lines matching the detection pattern exceeds the specified value. | 0 |
| --return | -r | Alerts you to log lines that match the pattern, Up to 1024 characters. | |
| --state-dir | -s | Specify the directory path where the State file is to be saved. | See About State File. |
| --no-state | Target all logs without use State file. | ||
| --fail-first | Alerts on first check immediately after setting up the plugin. | ||
| --verbose | Display execution results in detail. Used for debugging. | ||
| --help | -h | Show Help. |
- *1 If multiple options are specified, only the last option is valid.
Types of event logs that can be monitored
- Application
- Security
- System
Event type to be alerted
| Event Type | Alert Level |
|---|---|
| Error | Critical |
| Audit Failure | Critical |
| Warning | Warning |
Event types other than those listed above are not supported.
About State File
Since check-windows-eventlog monitors for differences in event log output, it records the last read EventRecordID in the State file.
If the --state-dir option is not specified, the State file will be stored in the following folder in the format {monitored event log type}-<hash string>.
- When executed via agent.
C:\Windows\SystemTemp\check-windows-eventlog- mackerel-agent v0.80.0 or earlier
C:\Windows\Temp\check-windows-eventlog
- When executed manually.
check-windows-eventlogfolder underTempfolder of logged-in user. Check the Windows environment variableTEMPfor the location of theTempfolder.
Example configurations
Target Error events in the Application log that contain the string foo and do not contain bar.
[plugin.checks.check-windows-eventlog-sample] command = ["check-windows-eventlog", "--log", "Application", "--type", "Error", "--message-pattern", "foo, "--message-exclude", "bar"]
Target the Event IDs 900 and 901 in the Error event in the Application log.
[plugin.checks.check-windows-eventlog-sample] command = ["check-windows-eventlog", "--log", "Application", "--type", "Error", "--event-id-pattern", "900,901"]
Among the Error events in the Application log, event IDs 900 through 1200 are targeted, and only 1101 is excluded.
[plugin.checks.check-windows-eventlog-sample] command = ["check-windows-eventlog", "--log", "Application", "--type", "Error", "--event-id-pattern", "900-1200", "--event-id-exclude", "1101"]
Troubleshooting
"Perflib:Because the message resource could not be found, the event log message could not be obtained. Please access the target server and check the event log directly." event occurs.
This event occurs when the --return option is given and the contents of the event matching the pattern cannot be retrieved from the EventMessageFile. The cause may be that the log of the event source is not output in a format that meets the specifications of the event viewer. Please identify the relevant event in the Event Viewer based on the time when the alert occurred, and check the output format of the Event Source log.
Event Log UNKNOWN: strconv.ParseInt: parsing "\x00\x00\x00\x00\x00\x00\x00": invalid syntax alert occurs.
The State file may be corrupt. Deleting the State file corresponding to the monitored event log will close the alert (The State file will be re-created at the next monitoring run). Please refer to About State File for the location of the State file.
Repository
https://github.com/mackerelio/go-check-plugins/tree/master/check-windows-eventlog
