Add a Desktop Application as Managed to Enhance its Monitoring

You can enhance the monitoring of any desktop application by adding its process name as a managed application A managed application has enhanced monitoring over a regular discovered application, because it adds default activities which track its launch times, resource consumption (PRC), and you can further add your own custom activities. For managed apps on Apple Macs, Aternity monitors the PRC only.

Add a desktop application for enhanced monitoring as a managed application

Regular discovered applications only monitor the default performance measures, like application health, UXI, wait times and so on.

Enter details of the desktop application for monitoring

You can limit the scope or rollout of devices which monitor a managed application. Choose either all devices in the organization, or limit the monitoring to a test group (learn more).

Important

The application's process name must be unique in Aternity. You cannot add the same process name for more than one application. For details, see this step below.

Aternity comes with default predefined activities out of the box, for popular business applications. For example, there are many predefined activities for the applications in Microsoft Office, like Outlook's open mail or send mail. There are predefined activities for Acrobat Reader, Microsoft Office 2007, 2010, 2013 and 2016 (Outlook, Word, PowerPoint, Excel, all in English), Microsoft Skype for Business and Citrix WorxMail for mobile devices. For a full list of predefined activities, see View Data Collected by Aternity.

You can define your own custom activities for desktop applications, web applications or mobile apps, to view their performance in Aternity. Learn more.

Tip

If your enterprise uses SteelCentral Essentials License, you can add managed applications, and you use predefined activities, but you cannot create your own new custom activities. To add custom activities, ask your administrator about upgrading to SteelCentral Enterprise License. Learn more.

Before you begin

Before adding an application to Aternity, verify the following:

  • Verify the access rights and privileges for your user includes Edit Configuration privileges.

  • We recommend that at least one device in your organization is a monitored device, running the Agent for End User Devices, which gathers performance and usage data. See more on deploying the Agent on devices in your organization.

    You can only monitor applications on computers which have the Agent for End User Devices.

Procedure

  1. Step 1 Open a browser and sign in to Aternity.
  2. Step 2 View the list of applications already managed by Aternity by selecting the Gear Icon > Managed Applications.

    Aternity has several predefined managed applications, and discovers all others in use. You can add new applications as managed if they do not already appear here.

    List of managed applications
    Field Description
    Type

    Displays the type of application, which can be a desktop (), web () or mobile app ().

    Application Name

    Displays the name of the application as it appears in the dashboards. Select the name to view or edit its activities. It displays a lock for predefined applications, as you cannot removed or edit them.

    Process Name

    Displays the name of the Windows process, base URL or package name, which Aternity is monitoring as a managed application.

    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.

    Users

    The number of unique users who have been running the application in the past hour. This is refreshed every minute.

    Activities

    The number of business activities defined for this application.

    This not a measure of the number of activities performed at present. It is only the number of defined activities for this application.

    If several activities for the same application have the same name, they are counted as one business activity. For example, two Open activities, one for each version of your application, are counted as one in this field.

    Last Modified

    Displays the date and time when this entry in the list of monitored applications was last changed.

  3. Step 3 Select Add Application > Desktop Application.
    Add a desktop application as a managed application
  4. Step 4 Enter the details of the desktop application which you want to have enhanced monitoring.
    Enter details of the desktop application for monitoring
    Field Description
    Display Name

    Enter the name of the application as you want it to be displayed in Aternity.

    Tip

    If you change an existing name, the dashboards display the new name as a separate entry, starting its own new history. For a week since the change, you can continue to view its previous data under the old name.

    Process Name

    Enter the process name or the application name as listed in the Windows Task Manager or Mac Activity monitor. If Aternity has already discovered this application, choose it from the drop-down menu.

    Important

    The application process name must be unique in Aternity. You cannot add the same process name for more than one application. For details, see this step below.

    + Add Process Name

    If your application runs several processes, add them here, to display their performance under the same application name.

    For example, SAP runs several Windows processes, including saplogon.exe, sapgui.exe and saplgpad.exe. Enter all process names to display them all under a single name, SAP. Some applications (like Adobe Acrobat Reader) have different process names for their 32-bit and 64-bit variants.

    Add more than one process to a managed application
    Deploy to

    Choose the group of devices which should report performance data for 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.

  5. Step 5 If several business applications use the same process:
    • You can display all the business applications as a single application in the dashboards, by adding the main application as managed, and then asking customer services to upload the custom activities for all the business applications under the main application.

      For example if, MyMail's plugin does not have its own Windows process, you can add MyMail as a managed application, and include both its own activities and the plugin's activities all under a single application.

    • Alternatively, to display each business application separately in the dashboards, if you have custom activities defined for each business application:

    1. a Add one of the applications with its process name as a managed application.

      For example, if the applications bank_clients, bank_support and bank_vip all use the same underlying process bank.exe, create a managed application called bank_clients with the process bank.exe.

    2. b Add the remaining business applications as managed applications, but assign them a fictitious (dummy) process name.

      These act as containers to house the custom activities for each business application.

      For example, create additional managed applications called bank_support and bank_vip, each assigned with a made-up process name.

    3. c Contact customer services to upload custom activities for each business application.

      In this example, bank_clients would display usage and health data (like UXI, wait time, launch times) and the performance of its activities, while bank_support and bank_vip would display performance only in terms of their activity response times.

  6. Step 6 Select Save.

    You can expect to start seeing performance data in the dashboards within 10 minutes. For example, go to the Monitor Application dashboard to view the launch times and CPU and memory usage of the application.

  7. Step 7 To view the activities of an application, select the Gear Icon > Managed Applications > <app_name> (learn more).
    View the activities of a managed application
  8. Step 8 (Optional) Add custom activities for your application.

    Create custom activities for this desktop application (learn more).

    Then upload them to Aternity and associate them to this application (learn more).

    Tip

    For Java apps, upload the custom activities under the application name (not the Java process name), so that all its activities appear in the dashboards under the same application. Aternity monitors your custom activities for Java, but does not gather data like UXI, wait times, usage times.