Published Application Usage Details Report

The objective of the Published Application Usage Details report is to aid administrators in monitoring the use of published applications in their organization. For a selected time frame, site, and published application, the report presents aggregated data about the instances of application use, as well as detailed information about the individual users of the application, how many times they opened the application, and the duration of their sessions.

Examples of questions this report is designed to answer are:

• How many users in the organization use application X?
• Which users use the application?
• Which users use the application the most?
• How many sessions of application X are likely to take place simultaneously?
• How long do sessions of application X usually last?
• How many licenses does the organization require for application X?

Data included in this report is only from Citrix Virtual Desktop sites which are connected to ControlUp.

Sections of the Report

This report is composed of three sections:

• Section 1: Report parameters
• Section 2: Aggregated data about usage of the selected application over the selected time period and at the selected site
• Section 3: Details about the users of the application and how much they used it over the selected time period and at the selected site

Section 1: Report Parameters

The top section of the Published Application Usage Details report contains controls with which you can select the scope of the report.

Section 1: Parameters section

Select the parameters as follows:

1. Time frame: On the upper-right, choose the period of time to include in the report, as follows:

Option	Description
	The last four hours
	The last 24 hours
	The last week
	The last month
	The last year
	Select this option to open a calendar popup in which you can manually select the start and end time for the report. Calendar popup

The currently selected time range appears in the From and To fields.

2. Site: From the first dropdown list, choose the site. (If the organization only has one site, it is automatically selected.)

Site dropdown list

3. Application: From the second dropdown list, choose the application.

Each application is identified in the list by two names: its administrative name, which is its unique name on the site, and is only seen by the site’s administrators; and its public name, which is the name that users see (and may not be unique on the site). In the list, the administrative name appears first, and is followed by the public name, in parentheses.

The report is generated automatically when you select the application from the list.

Application dropdown list

Section 2: Aggregated Data

The middle section of the Published Application Usage Details report presents aggregate data about usage of the application over the selected period of time.

Aggregate usage data for the selected time period

The data is summarized on the left side of this section, as follows:

• Peak Concurrent Instances: The largest number of instances of the application that ran simultaneously at any time in the time period included in the report
• Unique Named Users: The total number of users who opened the application at least once during the time period included in the report

The right side of the section contains a graph that plots the peak number of concurrent instances of the application between the previous data point and the current one. The frequency of the data points depends on how long a time range is included in the report, as explained in the table below.

To see additional details about a data point in the graph, hover over the data point. A tooltip pops up and shows the information. Exactly which information appears depends on the range of time included in the report:

Tooltip showing details about a data point

To see the locations of the data points more clearly, hover over the name of the application that appears below the graph. Each data point is then marked with a dot on the graph for emphasis.

Data points emphasized

Section 3: Individual Usage

The last section of the Published Application Usage Details report presents data about individual users’ usage of the selected application during the selected period of time. A summary of this data is presented in a table. Any instance that was open at any time during the selected time period is included in the total, even if it started or ended outside of the time period.
A detailed list of the instances opened by a particular user can be opened from the table. Once it is open, it can also be exported as a CSV file for future use.

Summary of user data

To see a detailed list of the instances opened by a user, in the Total Instances column, click the number of instances listed for that user. A dialog box opens and displays the list.

List of instances for a user

To export the list of instances to a CSV file, select Export. The file is created, and is minimized at the bottom of the browser window.

Tab of the minimized CSV file at the bottom of the browser window

To save the file, in the browser window, click its tab to open it. The file is opened by your computer’s default application for opening CSV files (usually, Microsoft Excel). When the file is open, use the application in which it is opened to save it in the location of your choice.

Exported list of instances open in Excel

Additional functionality of the usage table:

• By default, the table is sorted by the Total Instances To sort the table by a different column, click the header of the column. Click the header a second time to reverse the sort order. The column that is currently the basis for sorting has a blue triangle displayed in its header. The sorting direction (up or down) is indicated by the direction the triangle is pointing.

Blue triangle in column header

• To filter the table, click the icon in the header of the column by which you want to filter it, and then select Filter . Configure the filter settings, and then select the Filter button to activate them. When a filter is active, the icon in the header is blue.

Blue icon in column header

Troubleshooting

In some cases, the Published Application Usage Details report will not open when you select it from the Insights menu. In these cases, error pages are displayed. The error messages on these pages can help you diagnose the problem.

Error page

The most common problems are:

1. The Citrix Virtual Desktops from which you are attempting to open the report has not been added to the ControlUp Monitor.
2. The ControlUp Monitor needs to be upgraded to a version that supports this report (version 7.1.1.162 and higher).

More details about Data Resolution in Insights Reports can be found here