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, including Windows 32-bit or 64-bit processes, system utilities and so on. 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.

When adding a desktop or web application to be managed, you can choose to monitor the application's performance or the performance of any of its activities on all devices in the organization, or limit the monitoring to a test group.

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 for popular applications, including 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 the system.

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 Aternity Agent, 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 Aternity Agent.

Procedure

  1. Step 1 Open a browser and sign in to Aternity.
  2. Step 2 View the list of applications already managed by the system 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
  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 the system. You cannot add the same process name for more than one application. For details, see this step below.

    + Add multiple process

    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.

    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.

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

    • Multiple indicates that Aternity monitors this application for several different groups, which are assigned to different activities of the application.

  5. Step 5 To view the activities of an application, select the menu on the right > Manage Activities, or select the application name.

    For more information, see Add, View or Edit the Activities of an Application.

    Select an application to view and edit its activities
  6. Step 6 To manage a Java application, you must add the name of the application as managed, but assign it a fictitious (dummy) process name.

    Do NOT assign it to the Java process name.

    Create custom activities for this Java application, and upload them under your application name, so that all its activities appear in the dashboards under the same application.

    Tip

    While you can track the performance of your custom activities, the system cannot gather other data like UXI, wait times, usage times and so on.

  7. Step 7 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 uploading 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 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.

  8. Step 8 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.