Add Custom Device Attributes to Aternity

This screen enables you to view all device attributes defined in Aternity, and to define new collections for specific attributes that are relevant to your organization, to fine-tune the performance analysis and troubleshooting capabilities of Aternity.

The Advanced Collection > Device Attributes screen lists all defined attributes in alphabetical order. Selecting the row's context menu on the right allows you to assign a new monitoring file to the attribute.

The default device attributes defined in Aternity appear as Built in and their settings are grayed out. For example, Vendor, Office, WiFi Channel, Subnet, and others. Use Advanced Collection to add almost any device attribute you want to monitor. Select the one that appears as Not Assigned and assign the required collection method to it.
Set collection method
Note that this requires creating monitoring files, such as XML files and PowerShell scripts. How to create custom device attributes, learn here.
Note

Only users who are assigned the Manage advanced collection privilege are able to edit device attribute settings. To view this screen, users need the View advanced collection privilege.

Procedure

  1. Step 1 Open a browser and sign in to Aternity.
  2. Step 2 View the list of out-of-the-box as well as predefined customer attributes already monitored by Aternity by selecting the Gear Icon > Advanced Collection > Device Attributes.
    Add to Aternity attributes you want to monitor
    The table displays the full list of custom attributes added to Aternity.
    Field Description

    Attribute Name

    Displays the name assigned tocustom attribute as entered in the Add Monitor window and as it appears in the dashboards.

    Description

    Displays a description of the attribute and its values.

    It is recommended to fill this field especially for custom attribute 1-6 to be able to differentiate between them.

    Collection Method
    Specifies the method used to collect data for the attribute. Valid values are:
    • Built-in: Agent collects data from monitored devices for the predefined attributes

    • CSV Mapping: Aternity maps the collected data using the .CSV file once it is uploaded to Aternity

    • Advanced Monitor: Aternity collects data from WMI, Event Log, or Registry using monitoring XML files. The type of the Monitor is added to the method name (Monitor-WMI, Monitor-Registry, Monitor-Event Log)

    • PowerShell: Aternity collects data using PowerShell script once it is uploaded to Aternity

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

    • Multiple Monitors: Several monitoring files can be uploaded to collect the same static attribute value. For example, values in Registry for Windows 7 and Windows 10 reside in different places. Editing this collection method is not allowed.

    If no method is assigned, a Not Assigned mark appears next to the attribute on its row in the list, and the collection method may be assigned to it.

    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.

    Last Modified

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

  3. Step 3 To assign a a collection method to the attribute you want to monitor, select one of Not Assigned custom attributes, go to the row's context menu on the right > and select a collection method:
    • Set CSV Mapping
    • Set Advanced Monitor Collection
    • Set PowerShell Collection
    Method Description
    Set CSV Mapping
    To create a mapping file for upload, note the following:
    • There are two fields. The first is the source attribute value, and the second is the target attribute value to map to.

    • The fields are separated with a comma (comma separated values) and there should be a new line between the different mappings.

    For example, you want to assign a name to each organizational subnet to make your analysis easier and this name will be an office name. On the dashboard, for each monitored device, you will see the office name next to custom attribute 1-6 and will be able to better visualize issues.

    Add CSV file to Aternity
    Field Description
    Description

    Enter a description about values you want to collect for the selected attribute.

    Source Attribute

    The attribute from which data is extracted (key) and mapped to the selected attribute (value). For example, if the attribute selected is Location, selecting the Subnet Source Device Attribute maps subnet to location, using Subnet, Location key-value pairs listed in the last uploaded CSV file.

    Missing Value

    Enter a (string) value for the system to use when no matching value is found (for example, Not Mapped).

    Upload CSV

    Upload the created CSV file to Aternity, and the mapping table currently used is replaced with the specified mapping parameters.

    Set Advanced Monitor Collection
    This allows Aternity to collect data from WMI, Event Log, or Registry. For example, language of the operating system, free disk space, or else.
    Add XML file to Aternity
    Field Description
    Description

    Enter a description about values you want to collect for the selected attribute.

    Upload XML

    Upload the created file to Aternity.

    Set PowerShell Collection
    This allows Aternity to collect data using PowerShell scripts. Every PowerShell script requires a different XML. PowerShell script can include both contextual and static attributes, one or several context values. So, when collecting data using PowerShell scripts, you also need to upload the respective XML file.
    Add XML and PowerShell files to Aternity
    Field Description
    Description

    Enter a description about values you want to collect for the selected attribute.

    Monitor XML

    Upload the created file to Aternity.

    PowerShell

    Upload the created file to Aternity.

  4. Step 4 Fill in all fields and save.
  5. Step 5 To edit the settings, go to the row's context menu on the right > and select Edit.

    You can edit only some of the fields, for example Description. You can also upload a different XML file.

  6. Step 6 It is possible to retrieve currently used for the selected attribute mapping by downloading the file.

    To download the XML file, select the Gear Icon > Advanced Collection, select the required tab, and then select the row's context menu on the right > Download XML.

  7. Step 7 To stop monitoring a custom device attribute and to remove its monitoring file from Aternity, select the Gear Icon > Advanced Collection > Device Attributes, select the custom attribute you want to remove from the list, then select the row's context menu on the right > Stop collection for that attribute.
    Disable the monitoring of a custom device attribute
    This operation will delete the monitoring file from Aternity and the custom attribute will show Not Assigned again.
    Assign an attribute to a custom placeholder