Validate a Custom Activity for a Desktop Application

After you create a new custom activity, test it on an end user's computer in a production environment. When you validate using the Aternity Recorder, you view all of the activities captured by that version of the Agent and confirm that it reports the data from your activity to Aternity's dashboards.

For example, if you created an activity for opening the Outlook address book, upload that activity to Aternity, and distribute it to a test group. Then, on one of the test computers, run the Recorder in validate mode and perform the activity to check if the Agent is reporting the activity's performance.

Before you begin

  • Define your business transaction. Learn more.

  • Record the business transaction using the Aternity Recorder. Learn more.

  • Create a new custom activity in the Designer. Learn more.

  • Validate your activity in the Designer.

  • Upload your custom activity to Aternity, so that it is assigned to a test group of monitored desktop devices. Learn more.

  • ( Agent 9.1.x or later) Obtain access, or remote access, to one or more of the test computers to perform the Recorder validation.

  • Verify that the Aternity Assistant Service (A180AA) is running: Go to Task Manager > Services and check that A180AA is up a running.
    Verify that the Aternity Assistant Service is up and running
    If it is not, do the following:
    1. Contact your Administrator of Aternity and ask to disable the Disable Assistant Service monitor for the relevant hostnames.
    2. (For Administrator of Aternity only): Go to Monitors Settings screen (deprecated), navigate to the Monitors > Aternity Enabler > Disable Assistant Service and exclude the device's hostname. Apply the change and publish.
    3. Wait until the request is fulfilled and the change is applied and then start the Aternity Assistant Service (A180AA).

      To start it, you need admin rights!

      To start the A180AA process, go to Services > A180AA Properties , change the Startup type from Disabled to Automatic and then select Start.
    4. Verify the service is up and running and continue with the procedure.
      Verify service


  1. Step 1 (For Agents earlier than 9.1.x begin here) Open the Aternity Recorder on a computer in the test group.

    Go to C:\ProgramData\Aternity and double-click the Aternity Recorder shortcut. The Recorder is part of the Agent for End User Devices.

  2. Step 2 Select the validation mode.
    Select the validation mode for the Recorder
  3. Step 3 Select to start the Recorder in validation mode.

    While the Recorder runs, perform the activity several times, setting a bookmark each time. Bookmarks make it easy to find the activity in the validation results screen.

  4. Step 4 (Agent 9.1.x and later) Select , to view the Validation Summary.

    The button is visible only after you start the recording.

    The validation summary lists all of the activities detected by the Agent, and displays the measurements it collects. It also displays the incomplete activities, and which event ended the activity. Use the summary to see if the Agent is capturing the data you require for your application.


    During validation the Agent runs more processes than usual, so there are likely to be delays between performing the activity and seeing it in the summary.

    Display of all of the activities detected and reported by the Agent
  5. Step 5 Use the Filters to view only the activities or applications that interest you.
    Filter by activity to focus the results
    Field Description

    Select one of the bookmarks you used when performing the activity to view only the events associated with that portion of your recording.


    Select to filter by application. For example, choose Microsoft Outlook.


    Select to filter by activity. For example, choose Open Address Book.


    Select to filter by user.

    When measuring performance for applications running on virtual application servers, filter to see the data for only one user.

    Expand the results to see the measurements.

    Expand each result and see the activity response time

    Other results are more detailed, such as those for launching Outlook, which include network and server information.

    Some activities include server and network data
  6. Step 6 (Agents earlier than 9.1.x). Perform the activity on the test group computers, and check that the performance results appear in the User Experience dashboard.

    The completed activity:

    • Should match only the exact activity you want to analyze.

    • Should capture every completed activity.

  7. Step 7 Distribute the new activity to all of the Agents in your organization. Learn more.