Statistic plugin

We are introducing a new feature that provides server statistics including trending. This initial version includes statistics on device usage per vehicle tracker application. Additionally we now support Application Tag used for grouping applications.

Statistics are a way to gather information about the way customers use services. The statistics is accessible via SiteAdmin page only. Statistics are detailed per “application tag” and per “application”. Additionally we introduce application tags which are used to group applications.

This initial release dealing with device statistics provides information on:

  • Total devices
  • Active devices
  • Device usage
  • Number of logins
  • Accumulated login time

How to install or upgrade the plugin

  1. Log in to SiteAdmin.
  2. Go to the Plugins tab.
  3. Under My Plugins tab, make sure all plugins are up to date.
  4. Under Get More Plugins tab, make sure Statistic plugin is installed and up to date.

Initial Setup after Installation - Setting up Application Tags

If you are upgrading the feature and have already set up application tags, this section does not apply.
After the installation of the Statistic plugin an initial task is setup automatically, this task starts a command processing historical statistic data. Furthermore a nightly task is installed to process any missing statistic data. Under normal conditions the nightly task just processes yesterdays statistic.
The statistic feature uses the application tags to show statistics on group of applications. As there are no application tags setup by default you will have to define at least one application tag. The following guide will show you how to setup a application tag.

1. Login to SiteAdmin.

2. Go to Applications tab.

3. Select Applications tags.

4. You will now see the following page.

setup first application tag - empty application table

5. Press the “New Tag” button on the lower left.

You will now see the following page.

setup first application tag - new tag

6. Fill in a name for the tag.

Apply the tag to any application that shall belong to the tag group by via the associated check box.

Now it should look like this.

setup first application tag - new tag

Although you might choose all applications, we recommend not to do this if you have a huge number of applications. The reason for this is, that these tag groups are used within the statistic and the graphical view of the statistic data gets difficult to read with more than 10 Applications.

7. Press the save button.

You will now see the following page.

setup first application - first tag in application table

     The table now shows the new application tag “test”. As we assigned the tag to just one application “# Tagged applications” shows “1”.

You may setup as many application tags as you want. Application tags have unique names, that’s why the system will ask you to fill in another name if the name is already used by another application tag.

You can also modify and delete application tags at this page.

How to access Statistic data

1. Login to SiteAdmin.

2. Go to Statistic tab.

3. You will see the following page.

statistic page - statistic processing has not started yet

If you see the additional yellow note as displayed in the figure don’t hesitate, it just informs you that the initial statistic task has not started yet. Alternative there might be a note telling you that this task is currently running and processing is still going on.

When the statistic task has already run and you should see something similar like the following.

statistic page - with processed data

The statistic page consists of the sections ControlsDashboard and Detailed View.

Controls are used to setup the data to display.

You can choose which application tag to use, what the resolution of the data shall be and the start and end date of the statistic data. Application tag provides any application tag.

Resolution provides different time slices such as annually, weekly or daily. Any data will be displayed accumulated by the respective time slice. If the time slice can not cover the give start and end date fully the last data will be partial.

Start and End date let you choose the start and end point of the statistics. You can choose the date by a calendar popping up when you select them, by writing them directly into the input field or by pressing the left/right button. The left/right button will choose the next date in respect to the selected resolution.

Hint: If you want to use the right/left button to step to previous/next year, then choose the Resolution annually and press left/right button. Afterwards choose the resolution you want to view.

Dashboards show available statistics and a preview of the data selected by the Controls.
The preview is a cumulative view on the data of all applications of the selected application tag. The is a title on the bottom, it describes what the data is about. You see a graph showing how the data evolved. The background color of the dashboard might be green if the trend is going up or the color is red if the trend is going down. The up arrow shows the number of applications of the selected application tag with positive trend. The down arrow shows the number of applications of the selected application tag with negative trend. If the dashboard has a black boarder around it, that’s the selected dashboard for the Detailed View.

By clicking either a dashboard or one of the up/down arrows you select this data for the Detailed View. While clicking the dashboard will select all applications of the selected application tag, clicking the arrows will only select the applications with the respective trend.

Detailed View displays the data separate per application in Graph View and Table View. On graph view you can hover on different data points to the the values. On table view, see figure below, you get a tabular view that supports filtering, sorting and choose columns to be displayed.

statistic page - table view