Users - Top Users Report
In large thin client farms or virtual desktop environments, keeping track of the user activity on the servers of the farm is a difficult task. Moreover it becomes too tedious to figure out which user is continuously engaged in the maximum utilization of the resources. The Top Users report provides a solution for this. Using this report, you can easily figure out the users who are consuming more resources on the server.
To generate the Users - Top Users report, do the following:
Follow the menu sequence: REPORTS BY FUNCTION -> Domain Specific Reports -> Citrix XenApp/ XenDesktop -> Users -> Top Users.
The USERS - TOP USERS page will then appear. To monitor the servers in a farm, select the Zone to which the servers in the farm have been added.
Then, for generating the report on users associated with a particular component type, select a Component Type.
Select the components for which the report is to be generated from the Component list box. By default, all components of the chosen Component Type will be selected from the Components list. If there are still too many components in the list to choose from, you can narrow your search further by using the Search text box. Specify the whole/part of the component name to search for in this text box, and click the
icon next to it. The Components list will then be populated with all component names that embed the specified search string. Select the component of your choice from this list. If the Components list consists of too many components, then viewing all the components and selecting the ones you need for report generation could require endless scrolling. To avoid this, you can click the
button next to the Components list. A Components pop up window will then appear using which you can view almost all the components in a single interface and Select the ones to be included in the top-n analysis easily.Next, select Graph from the Report Type field to generate a graphical report. For a data report, select the Data option. If Graph option is selected, then an additional Graph Type list box will appear. By default, Distribution option will be chosen from this list box.
If Graph option is chosen as the Report Type and the Timeline option is chosen from the Graph Type text box, then an additional Criteria list box will appear in the report configuration section. This implies that across all the servers of the chosen Component Type, the distribution of users will be represented graphically for the chosen Measure. Likewise, if Data option is chosen as the Report Type, then a Based On Criteria option will appear which implies that the generated report will be sorted in descending order by default, based on the chosen option.
Administrators of large IT infrastructures, which are characterized by hundreds of components, may find it difficult to pick and choose the components for which a report is to be generated; this is because, in such environments, the Components list in this page will be populated with a large number of components, which would naturally make component selection tough. To enable administrators of such environments to quickly locate the components of interest to them and swiftly generate the reports, eG Enterprise provides a Analyze By list that consists of a variety of filter options. By default, the Component option is chosen from this list - this indicates that all the managed components of a chosen type will be available for selection in the
Zone: If the components for which a report is to be generated is part of a zone, pick the Zone option from the Analyze By list. To include sub-zones also in your search for components, set the Include SubZones flag to Yes. Then, select the zone of interest to you from the Zone list. This will populate the Component Type list with the types of components that are part of the chosen zone. If you select a component type from the Component Type list, then, all components of that type, which are part of the chosen zone, will be displayed in the Components list for selection. If there are too many components in the list to choose from, you can narrow your search further by using the Search text box. Specify the whole/part of the component name to search for in this text box, and click the right-arrow button next to it. The Components list will then be populated with all component names that embed the specified search string. Select the component of your choice from this list. If the Components list consists of too many components, then viewing all the components and selecting the ones you need for report generation could require endless scrolling. To avoid this, you can click the
button next to the Component list. This will open the Components pop up window using which you can view almost all the components in a single interface and Select the ones for which the report is to be generated.
Specify the name of the user whose activity is to be monitored in the User text box. In large thin client environments where hundreds of users are prevalent, the administrators do not prefer to generate a report on the activity of a single user. In such a case, to generate a comprehensive report on the activity of all the users of the thin client farm, specify * in this text box.
By default, the report provides the details of only the Top-10 users' activity in the chosen Server. You can choose a different top-n / last-n option from the Show Top list, if need be.
Note:
By default, the values displayed in the Show list range from TOP-10 to LAST-10. This is because, the Showtop parameter in the [INFOS] section of the eg_report.ini file (in the <EG_INSTALL_DIR>\manager\config directory) is set to 10, by default. You can, if required, configure the Show list to display a different range of options. For this, specify a different number against the Showtop parameter, and save the eg_report.ini file.
Specify the report Timeline. You can either provide a fixed time line such as 1 hour, 2 days, etc., or select the Any option from the list to provide a From and To date/time for report generation.
Note:
For every user registered with the eG Enterprise system, the administrator can indicate the maximum timeline for which that user can generate a report. Once the maximum timeline is set for a user, then, whenever that user logs into eG Reporter and attempts to generate a report, the Timeline list box in the report page will display options according to the maximum timeline setting of that user. For instance, if a user can generate a report for a maximum period of 3 days only, then 3 days will be the highest option displayed in the Timeline list - i.e., 3 days will be the last option in the fixed Timeline list. Similarly, if the user chooses the Any option from the Timeline list and proceeds to provide a start date and end date for report generation using the From and To specifications, eG Enterprise will first check if the user's Timeline specification conforms to his/her maximum timeline setting. If not, report generation will fail. For instance, for a user who is allowed to generate reports spanning over a maximum period of 3 days only, the difference between the From and To dates should never be over 3 days. If it is, then, upon clicking the Run Report button a message box will appear, prompting the user to change the From and To specification.
In addition to the settings discussed above, this report comes with a set of default specifications. These settings are hidden by default. If you do not want to disturb these default settings, then you can proceed to generate the report by clicking the Run Report button soon after you pick an option from the Component list. However, if you want to view and then alter these settings (if required), click on the
button. The default settings will then appear in the More Options drop down window. The steps below discuss each of these settings and how they can be customized.Specify the start time and end time for report generation against the Time period field.
If the timeline specified for the report needs to exclude the data collected during the Weekends, then set Exclude weekends to Yes. If not, select No.
Note:
By default, the weekend constitutes Saturday and Sunday. To override this default setting, do the following:
Edit the eg_report.ini file in the <EG_INSTALL_DIR>\manager\config directory.
In the [MEASURE_GROUP] section of the file, the EXCLUDE_WEEKEND parameter is set to Saturday,Sunday by default. You can modify this by setting the EXCLUDE_WEEKEND parameter to a comma-separated list of other days of the week - say Friday,Saturday.
Save the file after making the required changes.
Using the Weighted Average flag, you can indicate how the Avg value is to be computed for a chosen measure for the purpose of this report. The status of the Weighted Average flag is relevant only if the Test chosen is a descriptor-based test, and the descriptors are dynamic in nature. For instance, the Citrix Users test in our example auto-discovers the users who are currently active on a Citrix XenApp farm. For each user who has logged into the Citrix XenApp, the test reports a variety of statistics. Unlike descriptors such as disk partitions or processors that rarely change, the users are dynamic descriptors, which may change often; in other words, a user who is logged in currently, may opt to log out and may not login at all during the next measurement period. The Citrix Users test will neither report metrics for the inactive descriptors nor display it in the eG monitoring console. This is why, users in the Citrix Users test are considered ‘dynamic descriptors’.
By default, this report compares the Avg value of the chosen measure across all selected descriptors. Since the Weighted Average flag is set to No by default, this Avg is computed as the ratio of the sum total of the measure values reported by a descriptor during the given timeline and the total number of times the test is executed during the same timeline. In case of dynamic descriptors however, the Avg values so computed may not reveal the ‘true picture of performance’. This is because, the test may not discover or report metrics for dynamic descriptors throughout a given timeline. For example, take the case of the Citrix Users test. Say, two users - namely, ‘A’ and ‘B’ have logged into the Citrix XenApp server. During its first measurement period; the CPU Utilization for a user session is registered as 2% and 8% respectively. Assume that the second time the Citrix Users test ran, it captured 5% as the CPU Utilization of user ‘A’. User ‘B’ however was inactive during the second measurement period, and hence, was not discovered at all. If the Weighted Average flag is set to No by default, then, this report will plot the Avg value of 4% (3+5=8/2=4) for user ‘A’ and 4% (8/2=4) again for user ‘B’. If you notice, unlike user ‘A’, where 8% of CPU was utilized over a period of time, in case of user ‘B’, 8% of CPU was utilized at one shot! Logically therefore, user ‘B’ has to be ranked above user ‘A’ in terms of CPU utilization. However, since the default Avg value computation does not clearly bring out this difference, both user ‘A’ and ‘B’ are treated at par in this report! This is why, in case of dynamic descriptors, you may want to set the Weighted Average flag to Yes. In this case, the eG Enterprise system expresses Avg as the ratio of the sum total of the measure values reported by a descriptor during a given timeline and the ‘total number of times that descriptor was active’ during the same timeline. This implies that if the Weighted Average flag is set to Yes in the example above, the Avg value for user ‘A’ will continue to be 4 (3+5=8/2=4), but the same for net flow ‘B’ will be 8 MB (8/1=8). In this report therefore, user ‘B’ will be placed above user ‘A’, thereby accurately pointing you to the top user who is consuming maximum CPU resources.
In large environments, reports generated using months of data can take a long time to complete. Administrators now have the option of generating reports on-line or in the background. When a report is scheduled for background generation, administrators can proceed with their other monitoring, diagnosis, and reporting tasks, while the eG manager is processing the report. This saves the administrator valuable time. To schedule background processing of a report, select the Background Save - PDF option from the Report Generation list. In this case, a Report Name text box will appear, where you would have to provide the name with which the report is to be saved in the background. To process reports in the foreground, select the Foreground Generation - HTML option from this list.
Note:
The Report Generation list will appear only if the EnableBackgroundReport flag in the [BACKGROUND_PROCESS] section of the eg_report.ini file (in the {EG_INSTALL_DIR}\manager\config directory) is set to Yes.
The default selection in the Report Generation list will change according to the Timeline specified for the report. If the Timeline set is greater than or equal to the number of days specified against the MinDurationForReport parameter in the [BACKGROUND_PROCESS] section of the eg_report.ini file, then the default selection in the Report Generation list will be Background. On the other hand, if the Timeline set for the report is lesser than the value of the MinDurationForReport parameter, then the default selection in the Report Generation list will be Foreground. This is because, the MinDurationForReport setting governs when reports are to be processed in the background. By default, this parameter is set to 2 weeks - this indicates that by default, reports with a timeline of 2 weeks and above will be processed in the background.
Finally, click the Run Report button. If Data option is chosen against the Report Type flag, the Thin Client User Activity report for a chosen server will now appear in a tabular format.
By default, for every user displayed in the report, the following metrics will be displayed:
The Avg CPU utilization
The AvgMemory utilization
The Avg latency
The Avg IO reads performed by the user and
The Avg IO Writes performed by the user
While these default metrics cannot be changed, you can, however, configure functions other than Avg to be executed on the values reported by these metrics. Similarly, additional metrics can also be configured for display in the report. Though the generated report is initially sorted based on the column selected from the Sort by list, the displayed report can once again be sorted based on any column. Simply clicking on the arrow button present in each column will ensure you that the report is sorted based on the chosen column.
Suppose if all components had been chosen instead of a particular Component, or all users have been chosen then an additional Aggregate across servers field will appear.
While monitoring the user activity on all the servers in a chosen Zone, you can indicate whether the measures to be displayed in the report are to be aggregated at the zone-level or the individual server-level. Selecting the Yes option against Aggregate across servers will ensure that the user activity determining metrics displayed in the report for the chosen server(s) is aggregated across all the components in the selected zone.
On the other hand, if you select No against the Aggregate across Servers flag, then the report will reflect the name of the user and the server on which the user is currently active in the selected zone - in other words, the report will display a different set of metrics for every server/user combination.
If Graph option is chosen from the Graph Type, then, upon clicking the Run Report button, a graphical report will appear. The first section of the graphical report is a pie chart that displays the distribution of users for the chosen measure. Suppose if the Citrix Users/Cpu usage for user's processes option is chosen from the Measure list box, then the pie chart will reveal the distribution of users based on the CPU usage of the user's processes.
The next section in the graphical report is a bar chart which displays the Avg percentage of CPU usage for the Top 5 users.
If Timeline option is chosen from the Graph type list box, then the graphical report will be generated for a chosen User. For every chosen user, this report will reveal the user activity in terms of the measures discussed in step 16 above.
On the other hand, If the Background Save - PDF option is chosen from the Report Generation list, then clicking on the Run Report button will not generate the report and display it in this page for your benefit. Instead, a message indicating that the report is being processed in the background will appear. This will be accompanied by a link, that will lead you to the page that lists all the reports that are being processed in the background, and their current status. If background report generation fails for a report, you can regenerate that report using this page, or can even delete that report if need be. On the other hand, if background processing successfully completes for your report, then, you can view a PDF of the report by clicking on the
icon in that page. Using the icons available at the right, top corner of the report, you can do the following:
PRINT the report
SAVE the report as a PDF file
MAIL the report to configured individuals
Save a Data report to a CSV file
Add the report as a FAVORITE
SCHEDULE the automatic mailing of the report at configured intervals to specific recipients