Product Documentation

Viewing Reports

Oct 20, 2015

The Device Manager server repository database keeps a log of connections and data exchanges between each mobile device and the Device Manager server (logs). Device Manager reporting provides detailed information, sorted, for example, by tunnel or by user. Device Manager reports are available through an integrated set of reports.

The Display a Report collection provides the following reports that help you understand and manage devices:

  • Session report (connection logs)
  • Administrator options
  • Groups, users, and roles summary
  • Device software Report
  • Hardware inventory
  • Deployment Rule Report per device
  • Deployment Rule Report per package
  • Jailbroken or rooted devices
  • Inactive devices
  • Device enrollment
  • Distribution of devices
  • Blacklis /whitelist application compliance report
  • Device events
  • Terms and conditions

You can also export reports to a Microsoft Excel .csv file and delete reports from Device Manager by using the Manage Historical Data Collection. When you export the report as a .csv file, Device Manager creates a text file containing all of the activity report data for the specified range of dates.

The Delete option removes data logged before a specified date from Device Manager. Use this option carefully; it cannot be undone.

Navigating Reports

Each report uses a navigation bar to aid in moving through the report and its sections. The navigation bar allows you to export the report data, print the report, hide and reveal subsections of the report, page throughout the report, search for a specific string, and set a zoom level for the rendered data.

Many Device Manager reports present data by using a summary page, followed by one or more subsections that provide detailed information. You can use the Group Tree icon in the report navigation bar to view the subsections and open the subsection page.

Additionally, you can use the drop-down list in the navigation bar to go to a particular subsection.

Some Device Manager reports require parameters to run; parameters are supplied to a report from pop-up windows.

Report Types

You can view the following report types in Device Manager.

Session Reports (Connection Logs)

This report is a summary of mobile device activity. It includes total usage per user and overall data compression ratio.

The connection logs can contain a large amount of data. The date is created over a period of time by the Device Manager server and it is stored in the Device Manage repository database. Citrix recommends that you limit the use of connection logs to processing of small datasets to avoid impacting the performance of the Device Manager server.

Content reports, which are part of session reports, provide a summary of total data usage for a specified period of time. You create this report by using a custom date range. The report includes:

  • List of users connected to the Device Manager server. You can view details of a specific user in the list.
  • Real volume passing through the Device Manager server.
  • Data traffic optimized by the Device Manager server.
  • Percentage of data compression achieved by the Device Manager server or agent for all data streams (incoming raw data as opposed to actual data transmitted over the air).

Other Reports

In addition to session reports, you can also view the following reports:

  • Administrator operations. Summarizes administrator activity, including insertions, updates, and deletions of any resources in database.
  • Groups, users, and roles summary. Summarizes the list of groups, roles, and users defined in the Device Manager server, and reports the modification and creation dates of these elements. This report provides an administrative overview of all users, roles, and groups creation and modification data, and is meant to assist in the administrative side of your mobile IT infrastructure.
  • Device software report. Provides a summary of the installed applications within the mobile device environment.
  • Hardware inventory report. This report summarizes the mobile device asset base by hardware property - such as operating system, operating system version, platform, or device type.
  • Deployment rule report per device. This report summarizes package deployments for each device. State refers to the deployment state; specify All states, Pending, Successful, Failed, or Not applicable.
  • Deployment rule report per package. This report summarizes package deployments for each package. State refers to the deployment state; specify All states, Pending, Successful, Failed, or Not applicable.
  • Jailbroken or rooted revices. Lists jailbroken iOS devices and rooted Windows, Android, and Symbian devices.
  • Inactive devices. Lists devices that are inactive.
  • Device enrollment. Lists devices enrolled during a specified period of time.
  • Device distribution. List of devices owned by employees or by your organization.
  • Blacklist and whitelist application compliance report. This report provides three options for device compliance reporting:
    • Blacklisted apps shows devices with apps that are not allowed and are installed on the user device.
    • Non-whitelisted apps shows devices with apps installed on the device that are not on the whitelist.
    • Missing whitelisted apps shows devices that do not have all the whitelisted apps present.

Adding User-Defined Reports

Reports must be in Crystal Report .rpt format.

When you configure the reports, the property fields can have the following values:

  • reportFilename. My_report.rpt is the personalized report in the Crystal Report.
  • format name. The text that appears on the Device Manager console tab when you click Click here for my report.
  • linkLabel. The hypertext used to generate the report.
  • description. The help that appears below the hypertext.

The link of the new user-defined report appears under the User-defined reports section on the Reports tab.

To add user-defined reports

  1. Stop the Device Manager Server service.
  2. Open the WEB-INF/classes/external-reports.xml file with a text editor that can read and write UTF-8 files, such as Notepad.
  3. In the file, locate the tags <list></list> and add the following parameters:

    <bean class="com.sparus.nps.reports.EWCrystalReport"> 
    <property name="reportFilename" value="my_report.rpt"/> 
    <property name="name" value="my_report"/> 
    <property name="linkLabel" value="Click here for my_report"/> 
    <property name="description" value="Description of my report"/> 
  4. Save the file in UTF-8 format.
  5. Add the custom reports .rpt file to the following location on the Device Manager server:

    C:\Program Files (x86)\Citrix\XenMobile Device Manager\tomcat\webapps\zdm\reports\

  6. Restart the Device Manager server service.