Add or View Custom Events and Metrics for Enhanced Monitoring

Use Advanced Collection to view, configure or add almost any metric you are interested to monitor in Aternity dashboards (custom attributes and measurements).

Make sure you know how to create XML files and PowerShell scripts, and how to create monitors in Aternity that collect data from WMI, Registry, and Event log.

Aternity comes with default out-of-the-box health events, attributes, and measurements for monitoring. You can add any other custom health event, device attribute, or measurement. For example, you can decide what network metric to track using the WMI collection method for better understanding of the device resources usage and hardware.
Add custom data for enhanced monitoring
Note

To use this capability, please contact your Aternity local representative to get the setup files and deploy the patch over your current on-premise deployment.

Custom predefined health events and attributes for enhanced monitoring

Previously, Aternity on-premise customers used Monitors Tree (that required Adobe Flash browser plug-in which is no longer supported) to add custom data to Aternity. Now you can do it using the new Advanced Collection screen. The Advanced Collection is supported for Aternity on-premise 12 and later.

Field Description
Device Health

This tab enables adding health events to Aternity to monitor issues on the device level triggered by these health events (not an application's activity).

How to create custom health events, learn here.

How to add custom health events to Aternity, learn here.

Custom Data

This tab enables adding custom metrics to Aternity and monitoring performance by querying WMI, Registry, and Event Logs. You can collect and analyze any performance parameter which Aternity does not normally detect.

Add to Aternity any performance metrics you want to collect and then view them in the Custom Data (Advanced) dashboard.

Learn more.

How to add custom data to Aternity, learn here.

Device Attributes

This tab enables adding custom device attributes to Aternity to monitor issues on the device level.

How to create device custom attributes, learn here.

How to add device custom attributes to Aternity, learn here.

The below table displays the full list of monitors added to Aternity. The fields vary depending on what tab you are currently viewing:

Field Description

Health Event

Monitor Name

Attribute Name

Displays the name of a Health Event as entered in the Add Monitor window and as it appears in the dashboards. It displays a lock for predefined events, as you cannot remove or edit them.

Displays the name of a custom data monitor as entered in the Add Monitor window and as it appears in the dashboards. It displays a lock for predefined monitors, as you cannot remove or edit them.

Displays the name of a device attribute as entered in the Add Monitor window and as it appears in the dashboards. It displays a lock for predefined attributes, as you cannot remove or edit them.

Description

Displays the description of a health event, monitoring instance, or attribute.

Monitor Type
Displays the type of monitor out of those technologies Aternity uses to collect data:
  • Registry: Monitor that checks Windows property in device's registry

  • WMI: Monitor that queries operating systems database that includes information about devices

  • Event Log: Monitor that gets notifications from Windows Event Viewer that includes information about application, system crashes, and more

  • PowerShell: Microsoft automation solution

  • Generic Plugin: Agent plugin that collects data from monitored devices

  • Dump Analyzer: Monitor that explores what caused a blue screen on the device

Collection Method

Relevant for device custom attributes only.

Displays the method of collecting data:
  • CSV: Collecting data from a .CSV file after uploading it to Aternity

  • Monitor: Collecting data from an XML file after uploading it to Aternity

  • PowerShell: Collecting data from a PowerShell script after uploading it to Aternity

If collection method is not selected, it appears as Not Assigned.

Category

Relevant for the Device Health tab only.

Displays the category of a health event added to Aternity. There are several supported categories:
Subcategory

Relevant for the Device Health tab only.

Displays the Subcategory for the health event. Under the main categories of health events: Application, Background Process, Hardware and System, there are sub-categories like Windows Background Process, MobileApp, DotNet, Network, Battery and so on.

Severity

Relevant for the Device Health tab only.

Displays the Severity level of your health event. For example, if a background process crashes, its severity is minor , if an application crashes, it is major , while a system crash is critical .

Frequency

Displays frequency of the check interval. How often the Agent will run the monitor and will query the WMI, Registry, Event Log or PowerShell. If there is an event, it will be detected and reported. If there is a change in a device attribute or a custom measurement data, it will be detected and reported, Depending on a metric or event you are monitoring, we recommend running the check once a day or once an hour, if required. For example, sample CPU usage every minute.

Frequency for Event Log is predefined to 60 seconds.

Rollout
Displays the group of devices which monitor this entry:
  • Test Group indicates that Aternity only monitors this entry for users or devices in the test group.

  • All Users indicates that Aternity monitors this entry for all reporting devices.

  • Custom indicates that Aternity monitors this entry for users or devices in a custom group that you created.

Last Modified

Displays the time stamp when someone last changed anything in the XML, CSV, or PowerShell file.

To... Do This...

To view the list of out-of-the-box and predefined health events, custom measurements, and device custom attributes already monitored by Aternity

Select the Gear Icon > Advanced Collection. Move between the tabs to view device health events or custom measurements or device custom attributes monitored by Aternity.

To add a custom health event to Aternity in order to monitor device health.

You can add new health events if they do not already appear in the Advanced Collection screen, Device Health tab. For example, monitor hard disk failures or the battery charge level. Once the monitor was set, you can troubleshoot hardware, system, and application issues on the Device Health dashboard.

Select Add Monitor and then Advanced Monitor or PowerShell.

Learn more.

To add a custom measurement to Aternity in order to measure performance.

Select the Gear Icon > Advanced Collection > Custom Data.

Learn more.

To add a custom device attribute to Aternity in order to monitor its performance.

Select the Gear Icon > Advanced Collection > Device Attributes.

Learn more.

To edit the properties of a health event, device attribute, or custom measurement like changing the name or description, replacing the XML or CSV file

Select the Gear Icon > Advanced Collection, then select the required tab, and then select the row's context menu on the right > Edit. You can change the name as displayed in the Advanced Collection screen and in the dashboards, upload a new XML file, and more.

To download an XML or CSV file

Select the Gear Icon > Advanced Collection, then select the required tab, and then select the row's context menu on the right > Download XML or CSV (depending on the selected tab).

To stop monitoring a custom device attribute and remove it from Aternity

Select the Gear Icon > Advanced Collection > Device Attributes then select the row's context menu on the right > Stop collection for that monitor.

Disable the monitoring of a custom device attribute

This operation will delete the monitor from Aternity.

To remove a health event from the list or to disable it

Select the Gear Icon > Advanced Collection > Device Health and then the row's context menu on the right > Delete.

You can also disable it instead of completely removing from Aternity.

Tip

You cannot remove a predefined out-of-the-box health event, but you can stop it from being monitored by selecting the row's context menu on the right > Disable.

To remove a custom data measurement from the list or to disable it

Select the Gear Icon > Advanced Collection > Custom Data and then the row's context menu on the right > Delete.

You can also disable it instead of completely removing from Aternity.