Windows Event Logs

Prev Next

This article covers how to record and analyze Windows events with ControlUp.

Event collection and recording

The ControlUp for Desktops Agent collects events and sends them to your tenant every minute. This means that there might be up to a one-minute delay between the event occurring on a device and the event appearing in ControlUp.

Events are recorded only if the agent is running at the time of the event. Events that occur when a device is starting might not be recorded because the agent is not yet running on the device.

Events recorded by default

The following events are always recorded. In addition, you will find some events pre-populated in your Windows Event Log collection settings.

Log

Event ID

Source

Logged by

Description

System

1074

User32

Windows

Shutdown or restart started by a user or program

Application

1000

Application Error

Windows

Application crash. The agent also records one of events 61004–61007 for each 1000 event, so count one or the other, not both.

Application

1002

Application Hang

Windows

Application stopped responding and was closed before it recovered

Application

1033

MsiInstaller

Windows

MSI install

Application

1034

MsiInstaller

Windows

MSI uninstall

Application

61002

Application Frozen

ControlUp agent

Foreground application stopped responding for more than 4 seconds and closed before it recovered (either closed by the user or the app closed some other way). Includes the freeze start time, end time and duration.

Application

61003

Application Frozen

ControlUp agent

Foreground application stopped responding for more than 4 seconds, then recovered. Includes the freeze start time, end time and duration.

Application

61004

SIP Agent

ControlUp agent

Foreground application crash

Application

61005

SIP Agent

ControlUp agent

Windowed application crash

Application

61006

SIP Agent

ControlUp agent

Background process crash

Application

61007

SIP Agent

ControlUp agent

Application crash with an unknown state (foreground, background or windowed couldn’t be determined)

Configure a new event to be collected

  1. Go to Devices > Configuration > Settings > Agent > Windows Event Log Collection.
    Accessing the Windows Event Log Collection settings

  2. Click Add Row.

  3. In the Event Log column, enter the full name of the event log in which the event is stored. You can select from the dropdown list or type in the event log name (for example, Microsoft-Windows-WindowsUpdateClient/Operational)
    Log Name highlighted in the Windows Event Viewer

  4. In the Event IDs column, enter a comma-separated list of event IDs that you want to record from the event log.

  5. Optionally, if you want to collect events only from a specific provider, enter the provider name in the Provider column. To view the provider name of an event, right-click the event and go select Event Properties > Details. If you don't enter a provider, then events from all providers are recorded.
    Event provider name highlighted

  6. In the Description column, add a description to help you remember what the events mean. The description you enter doesn't appear anywhere else in ControlUp.

  7. Click Save Windows Event Log Settings to save your changes.

The final event log collection entry should look like this:

Final configured event log collection settings

After adding Windows events to the Windows Event Log Collection table, the agent will record future events meeting the conditions you specified. Changes to event log collection settings do not update historical data that was previously collected.

View recorded events

The Windows Event Log report shows all of the recorded events in your environment. To access the report, go to Devices > Reports > Windows Event Log.

Windows Event Log report.

The report is built from the win_event_log data index. To view the raw data in the data index, go to Devices > Configuration > Data > win_event_log.

Set up alerts and automation based on events

You can use the win_event_log data index to create an automatic alert that triggers when a device has a specific Windows event. Learn how to create an alert from a data index.

Get Windows events by remote controlling a device

Another method to view events is to remote control into a device and view the events locally from the device. Learn more about remote control.

Get Windows events by running a acript on a device

You can run a script on a device to scrape for events matching the conditions specified in the script.

The following script returns events with ID 1030, 1031, or 1032 in the Application log in the last 96 hours. Edit the script to adjust the search criteria. Uploading data to the System Events log using SIP EVENT BEGINS has a limit of 4000 characters, so you might need to change MaxEvents in the script to a number lower than 20 if the output is greater than 4000 characters.

Add the script to ControlUp and run it as Custom Action - System on the target device. Learn how to add a custom scripts.

$EventList = Get-WinEvent -MaxEvents 20 -ErrorAction SilentlyContinue -FilterHashtable @{ LogName = 'Application'; StartTime = (Get-Date).AddHours(-96); Id = 1030,1031,1032 }

Write-Output "### SIP EVENT BEGINS ###"
Write-Output ($EventList.Length)
Write-Output ($EventList  | Format-List)
Write-Output "### SIP EVENT ENDS ###"