Key Task: Analyze Application Events (Advanced)

The Analyze Application Events (Advanced) dashboard shows only application events, which you can create to report the number of errors or the number of times someone used a feature in your application, like accessing its online help. You create application events in the Aternity Activity Designer and upload it to Aternity in a similar way to a regular custom activity. This advanced analyze dashboard allows you to customize its layout, so you can correlate the occurrence of an application event with other system or application measurements, but it does NOT display regular activities, only application events.

To upload your application events into Aternity, contact Customer Support.

You can customize your own application events to count the number of times something happened in your application, like the number of errors, or the number of times people used a specific feature, or to measure the response time of a non-standard activity.

Important

This dashboard is empty if you have not created and uploaded your application events.

Count a custom application event

There are three types of application events:

  • Application Usage Duration is for measuring the time to complete a non-typical complex business activity, like one which includes application response times mixed with time waiting for the user. For example, use this to measure the time required for a user to identify a customer at the beginning of a call.

  • Application Usage Event is for counting the times when an event occurred, or when it is not easy to identify the end event of an activity. For example, if you want to track the number of times when people shared their desktop in Skype for Business, track this as an application usage event, and assign a Category to different types of usage events.

  • Application Error Events are for tracking the occurrence of errors. Each error has a Category, or type of error, and a Details field, which contains details of the event or error.

In this dashboard, the following fields have a slightly different meaning for application events:

Field Description
Activity Response

Displays the length of time for this business transaction, as stored in the Duration field of the event for a Application Usage Duration.

Info1

Displays the type of error or other kind of custom data held in the Category field of an Application Error Event.

Info2

Displays the details of an error or other kind of custom data as held in the Details field of an Application Error Event.

There are endless ways you can use the data from this dashboard to check almost anything you want to investigate.

For example, you can check if there are more errors of a certain type in one location over another, or check whether employees in India use a particular feature more than other employees elsewhere.

If you saved this dashboard for later viewing, it opens the main sheet (only) in view mode. To further customize (if you have permission), select Edit.

Tip

You can also view and analyze this data using the APPLICATION_EVENTS REST API. (Learn more).

Procedure

  1. Step 1 Open a browser and sign in to Aternity.
  2. Step 2 Select Main Menu > Analyze > Application Events (Advanced).
    Access the Analyze Application Events (Advanced) dashboard
  3. Step 3 Add columns and rows as required to correlate the data you need with the application events you are tracking.

    For more information on the full editing capabilities of this dashboard, see http://www.tableau.com/learn/training. View the following training sections:

    • Visual Analytics

    • Calculations

    • Tableau Server

    • How To

    Tip

    If you receive a communication error 504, ensure that your dashboard does not list too many rows (like all your device names or usernames). You can narrow the scope of the data displayed by selecting Show Filter for that attribute and selecting the values to display. To further improve dashboard performance, select Aggregation Type > Hourly or Daily, and do not include Tableau's level of detail expressions.

  4. Step 4 You can create a custom group for an attribute in any of the advanced Analyze dashboards, from data in Excel (like a CSV file).

    For example, you can create two custom groups to compare their measurements.

    Use CSV data to create a custom group
    1. a Copy the values you want for the group from a CSV file in Excel.

      For example, if you have a CSV file of device names from the device inventory API, choose the names you want as a group and copy them to the clipboard.

    2. b Display the attribute of your group in the dashboard by dragging it from the left pane to the top bar.

      For example, to display rows of hostnames in this dashboard, drag Client Device Name from the left pane to the Rows bar at the top.

      Drag the attribute to the top bar and show its filter
    3. c To display a filter of this value in the right pane of the dashboard, hover over the attribute, open its drop-down menu, and select Show Filter.
      Choose Show filter from the drop-down menu
    4. d To display only the values from your CSV file, change the filter in the right-hand bar by opening its drop-down menu and selecting Multiple values (custom list).

      This displays only several specific values in the dashboard.

      In this example, to display only the specific hostnames from your CSV file, in the right hand bar, select Client Device Name > Multiple values (custom list).

      Display only specific values in the dashboard
    5. e To display only the items from your CSV file, paste them into the filter field.
      Paste your data into the filter field
    6. f Create a group by selecting the group members, then in the pop-up select the group icon .
      Select items and create a group

      It creates a custom group as a new object in the left sidebar. You can now use it as part of your analysis like any other object.

    7. g To create a second custom group for comparison with your first group, select Clear List to clear the first group's data from the filter, and repeat the process.

      Paste a second set in the filter field to display them, select them in the dashboard, then group them.

      Clear the data from the filter
    8. h Clear the filter and now paste both lists into the filter so you can see all values from both groups in the dashboard.

      This displays all members of the groups in their respective groups so you can compare them side by side.

      View a comparison of two custom groups
  5. Step 5 You can limit the display of this dashboard using the menus at the right of the window.
    Field Description
    Timeframe

    You can change the start time of the data displayed in the dashboard in the Timeframe menu in the top right corner of the dashboard.

    You can access data in this dashboard (retention) going back up to 14 days. This dashboard's data refreshes every hour.

    Event Type

    Select to view only specific types of application events:

    • Application Usage Duration is for measuring the time to complete a non-typical complex business activity, like one which includes application response times mixed with time waiting for the user. For example, use this to measure the time required for a user to identify a customer at the beginning of a call.

    • Application Usage Event is for counting the times when an event occurred, or when it is not easy to identify the end event of an activity. For example, if you want to track the number of times when people shared their desktop in Skype for Business, track this as an application usage event, and assign a Category to different types of usage events.

    • Application Error Events are for tracking the occurrence of errors. Each error has a Category, or type of error, and a Details field, which contains details of the event or error.

  6. Step 6 You can create multiple sheets (widgets) in the advanced custom dashboards.
    Instead of having many custom dashboards with a single section each, you can now create a single dashboard with all sections you need. This allows more information to be provided within one dashboard displaying much more holistic view, as well as much stronger analytics by cross filtering between the sheets.
    Create multiple sheets in the same dashboard.
    For more information on how to open multiple dashboard sheets in Tableau, see the Tableau tutorial.
    Timeframe drop-down menu in the top right corner of the screen serves all widgets. Use it to set the required timeframe for each widget if necessary.
    Set timeframe in the top right corner of the screen

    Once you have created several widgets and then a dashboard that uses these widgets, save a new dashboard. Make sure to click Save while focusing on the dashboard (in the bottom of the screen there is a list of all open tabs). Note that if, by mistake, the focus is on a widget, the saved view will display this widget instead of dashboard. Click Edit to make changes.

    Focus on a new dashboard to save it