Assign Activities to a Monitored Web Application (WPM)

Monitoring a web application measures both the availability and the load times of its web pages, and then displays those times in the dashboards under an activity called Other Pages. To assign each web page (or group of pages) to a different activity, use Web Application Settings, or web page monitoring (WPM), and then view the performance of each activity separately.

Assign activity names to web pages and view them in the Troubleshoot Application dashboard

For example, after you added a web application to Aternity (see Add a Web (Cloud) Application to be Monitored), you can view the load times of its web pages in the Troubleshoot Application dashboard, under the Other Pages activity. Then assign activities to the load times of different types of web pages. For example, you may want to track if search results pages take much longer to load than other pages.

To assign an activity name, create rules to map an activity name to a web address (URL) or the title of a web page. The system executes the rules in a specific order, so for example, your first rule might state that if a web page’s title is Create Customer, it belongs to the Create activity. It processes the other rules only after this one has completed.

Monitoring of the load times of a web page works best when it has a unique URL or title, and it does not contain any elements which load after the main page has completed (like iframes, Ajax elements or bookmarks with # in the URL).

Note

To monitor activities with finer definitions in your web app, like starting a business activity with a button press and ending it with a text change in the web page, you can design your own custom activities. For more information, contact Customer Services.

Before you begin

Verify the monitored device running the web application has at least version 8 of the Aternity Agent, and you are running the web application in one of the following browsers:

  • Microsoft Internet Explorer v9, 10 or 11.

    Disable Compatibility Mode to automatically discover web applications. It monitors custom activities even in compatibility mode.

    Select > Internet Options > Advanced > Security, and deselect Enable Enhanced Protection Mode).

  • Any Google Chrome browser released in the past two years, with the Aternity Extension for Chrome installed, to monitor web page monitoring events and all browser interaction. Without this, Aternity only monitors clicking a link, back, forward, direct URL, HTTP GET and POST events.

  • Firefox version 38 ESR or version 45 ESR.

    For version 45 ESR, contact Customer Services to ensure custom activities are compatible with this version of Firefox, and to add the necessary component to Aternity.

Perform the following steps before assigning an activity name to a page in a web application:

  1. Add the web application to the list of monitored applications (see Add a Web (Cloud) Application to be Monitored).

  2. Run the web application on a monitored device running at least version 8 of the Aternity Agent.

  3. Perform specific actions in the web application which you want to assign to an activity.

  4. View the usage and performance data of the web application in the Troubleshoot Application dashboard.

Procedure

  1. Step 1 Open a browser and log in to Aternity.
  2. Step 2 Select the Gear Icon > Managed Applications.
  3. Step 3 View the list of applications already monitored by the system.
  4. Step 4 On the row of a web application, select ... > Edit Web Application Activities.
  5. Step 5 View the recent usage of the web application in the Pages section, to create a rule which assigns an activity to a set of web pages.
    1. a Enter the device name which used the web application.
      Viewing the recent usage of a web application to create a rule
      Field Description
      Timeframe

      Choose the start time of the data displayed in this dashboard.

      Activity

      Select the activity to display in the dashboard.

      Hostname

      Enter the name of the device whose history you want to review. Start typing the name to see the list of monitored devices beginning with these characters.

      The system displays up to one thousand entries at a time.

    2. b Select Load pages to view the recent history of this web app from this device within this timeframe.
      View recent pages of the web application accessed by a specific device
    3. c If the list is too long, use the filter fields to narrow the list to the pages you want to map to an activity.
      Filter the list of recent pages used by a specific device
      Field Description
      Title

      Enter the title (case sensitive) of the web page, to narrow the list of web pages from that device whose title begins with this text.

      URL

      Enter the URL (case sensitive) of the web page, to narrow the list of web pages from that device whose URL begins with this text.

      Refresh Pages

      Select to perform the search again to view the recent history of this web application from this device within this timeframe.

      Edit Pages Filter

      Select to change the search to look for the history from a different device or timeframe.

    4. d To create a rule based on one title or URL, select that item in the list.
      Create a rule based on a specific page
      Field Description
      Title / URL Including Domain / URL Without Domain

      Choose the basis of your rule, to be checking for the title or the URL of the web page.

      Is / Contains / Begins With / Ends With

      Choose the condition of your rule, then enter the matching text (case sensitive) in the next field.

      For example, if you want your rule to apply to all pages whose title contains the words New Contact, select Contains, then enter New Contact in the following field.

      Tip

      Try to narrow the URL definition, to avoid capturing unwanted pages with similar patterns, like redirects from ads. For example, adding the caret and dollar symbols around a regex formatted URL, such as ^http://company.com/…$, will ensure that it only captures the desired page access and not ad-related redirects that have the same pattern appended somewhere in the URL.

      Use In Activity

      Select the name of the activity to assign to the web pages which conform to this rule. This is the activity name to be displayed in Aternity.

      For a new activity name, select (Create new activity) and enter the name of the new activity.

      Tip

      Define the activity name which clearly indicates that it measures the load time of the web page. For example, an activity for a login page would be Login (Page Load).

      Exclude from Application Monitoring

      Select this option to exclude a web page from monitoring if it conforms to this rule.

    5. e Select Add Include Rule or Add Exclude Rule to apply the rule.
    6. f To verify your rule is working as expected, view the recently accessed pages above, and preview how each page would be classified, under the Trial Run Activity column in the top part of the window.
  6. Step 6 Select Add New Activity to define a new activity rule without referencing previous access of the web application.
    Create a rule to assign an activity
    Field Description
    Activity Name

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

    Tip

    Define the activity name which clearly indicates that it measures the load time of the web page. For example, an activity for a login page would be Login (Page Load).

    Include Any Of +

    Select + to create a condition which would add a web page to this activity if it conforms to the rule. You can add multiple conditions, so that this rule is applied if ANY of these conditions are true.

    Title / URL Including Domain / URL Without Domain

    Choose the basis of your rule, to be checking for the title or the URL of the web page.

    Is / Contains / Begins With / Ends With

    Choose the condition of your rule, then enter the matching text (case sensitive) in the next field.

    For example, if you want your rule to apply to all pages whose title contains the words New Contact, select Contains, then enter New Contact in the following field.

    Tip

    Try to narrow the URL definition, to avoid capturing unwanted pages with similar patterns, like redirects from ads. For example, adding the caret and dollar symbols around a regex formatted URL, such as ^http://company.com/…$, will ensure that it only captures the desired page access and not ad-related redirects that have the same pattern appended somewhere in the URL.

    Exclude Any Of

    Select + to create a condition which would remove or exclude a web page to this activity if it conforms to the rule. You can add multiple conditions, so that this rule is applied if ANY of these conditions are true.

    Edit

    Select to edit a web page activity rule.

    Up / down arrow

    Select to change the order in which each rule is processed.

    Delete

    Select to delete a web page activity rule.

  7. Step 7 Select Save at the top of the window to implement the rules.
    Note

    The system only implements the rules when you select Save at the top of the window.

    While the Trial Run Activity column displays the previous history with categorizations according to your new rules, the dashboards (like the Troubleshoot Application dashboard) only separate out the new activities from now onwards, for new access to the web application, not previous access.