Usage Statistics

Usage statistics offer the JMap administrator information on the usage of projects, layers, and contexts. JMap Server records some of the users’ activity and allows you to generate reports, which contain statistics on the use of resources in JMap Pro, JMap NG and JMap Web applications. This data can be useful to assess the relevance of projects or layers that are seldom or never used.

In order for usage data to be recorded, you must select the Usage statistics option when creating or editing a project. For more details on this topic, refer to the Creating Projects section. When exporting or importing your project, your choice will be saved in the exported configuration.

Thus, whenever a user opens a project, views a layer, or views or creates a context in a JMap Pro, JMap NG or JMap Web application, this activity will be automatically recorded in a temporal table of the System database.

Every night, at a set time, the data will be aggregated into two tables (JMAP_STATISTICS_MONTHLY and JMAP_STATISTICS_YEARLY), and it will then be displayed in this section of JMap Admin.

The data aggregation frequency can be configured in JMap’s settings. To do so, you must modify the server.statistics.config.cron variable in the jmapserver.properties file that is found in the JMap_HOME/conf folder. If server.statistics.config.cron variable is not in the jmapserver.properties file, by default the aggregation frequency is every day at 2 am (server.statistics.config.cron=0 2 * * *). If you want to change the aggregation frequency the server.statistics.config.cron variable needs to be manually added in the properties file. This page http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html offers details about cron expressions.

Information about the activity of users who were deleted is recorded in both tables. The details of the aggregation functions are found in JMap Admin’s REST API.

Information entered in the temporal table will differ slightly between JMap Pro and JMap Web applications. Usage data originating from JMap Pro will be saved when the JMap Pro application is closed, or when the project is closed because the user has switched to another project.

Calculating statistics

Project statistics
From	Select the start date of the period for which the statistics will be calculated.
To	Select the end date of the period for which the statistics will be calculated.
User	Select the user whose statistics you want to obtain. If the user who opened the project was eliminated from JMap, his or her usage statistics will be added to the System user and displayed under this user.
Project name	Enter the name of the project for which you want to obtain statistics. You can enter part of the project’s name, and all the projects whose names coincide in part with the name you entered will be displayed.
Open count	The result indicates the number of times that the user opened the project in a JMap Pro, JMap NG or JMap Web application. Note that the data originating from JMap Pro will be saved when the application is closed, or when the project is closed because the user has switched to another project.

Click on Apply to generate the statistics by project. Click on Reset to delete the statistics.

Layer statistics
From	Select the start date of the period for which the statistics will be calculated.
To	Select the end date of the period for which the statistics will be calculated.
Project name	Select the project that contains the layer(s) whose statistics you want to calculate.
User	Select the user whose statistics you want to obtain. If the user who opened the project was eliminated from JMap, his or her usage statistics will be added to the System user and displayed under this user.
Layer name	Enter the name or part of the name of the layer(s) whose statistics you want to calculate.
View count	The result indicates the number of times the user viewed the layer(s) in a JMap Pro, JMap NG or JMap Web application. One view will be counted for each user session. When the layer is visible in the map, one view is counted. If the user disables the layer’s visibility and enables it again during a session, only one view will be counted. Note that the data originating from JMap Pro will be saved when the application is closed, or when the project is closed because the user has switched to another project.

Click on Apply to generate the statistics by layer. Click on Reset to delete the statistics.

Statistics on public contexts
From	Select the start date of the period for which the statistics will be calculated.
To	Select the end date of the period for which the statistics will be calculated.
Filter	Three filters allow you to calculate various statistics. Created by user: Calculates the number of contexts created by the user for a given project. Used by project: Calculates the number of times a public context is opened by all JMap Pro users for a given project. Used by project and user: Calculates the number of times a public context is opened by a JMap Pro user for a given project. JMap Web and JMap NG contexts are private. JMap only calculates the statistics for public contexts, used in JMap Pro applications.
User	Select the user whose statistics you want to obtain. If the user who opened the project was eliminated from JMap, his or her usage statistics will be added to the System user and displayed under this user.
Project name	Enter the name of the project for which you wish to obtain statistics on the contexts.
Create count	Calculates the number of contexts created during the selected period for the user and project selected in JMap Web, JMap NG and JMap Pro applications.
Context name	Enter the name of the public context for which you wish to obtain statistics.
Use count	Indicates the number of times the public context was opened, either by all users of a project in a JMap Pro application, or by a specific user of a project in a JMap Pro application.

Select the filter you wish to use and click on Apply to display the settings used to define the calculation. Once the settings have been completed, click on Apply again to produce the statistics. Click on Reset to delete the statistics.

Exporting reports

You can export the generated report in Excel or PDF format. To do so, once the statistics have been calculated, click on Excel or PDF to automatically download a file in the selected format.