Welcome to TERN Knowledge Base

How to use usage reports for Geoserver

Owned by Mosheh Eliyahu
Last updated: 17 Jan 2024
6 min read

The following reports show various statistical information from the data downloaded from the TERN Geoserver server (a repository for geographic map layers). The reports are accessible from the Kibana Geoserver Dashboard.

Furthermore, we will describe the following:

  • How to view the reports.

  • How to display reports based on dates.

  • How to download a report in CSV format for further analysis.

How to view the reports

The reports can either be viewed in normal mode or full-screen mode in the dashboard.

Norma Mode

Normal mode is the default viewing mode which is engaged when landing on the Kibana report page.

Full-Screen Mode

The full-screen mode can be engaged by clicking the Full-screen link. Full-screen mode is useful when doing a presentation.

Figure 1 (engage full-screen mode)

To disengage full-screen mode click the Exit full-screen button at the bottom left of the screen.

Figure 2 (exit full-screen mode)

How to display reports based on dates

By default, the period (date range) of data displayed in the reports is set in the initial design of the reports. For example, the data showing on reports might be based on a period from Jan 13, 2009 @ 00.00.00.000 to now(see Figure 3).

The date range can be changed to whatever date range is desired.

To change the from date, click on the value on the left (Figure 4) to change the starting date of the data. A date picker will show. From the date picker, you can choose either Absolute (for absolute start date) or Relative (figure 5) for relative period. Select the desired start day, month, year, and time (see Figure 4). Then click Update to re-render the reports based on the new starting period

The to date can be changed similarly to changing the from date. So the instructions here pertain to both dates.

 

Alternatively, you can use the Relative option as a start period to display report data based on some years, months, weeks, hours ago, etc (see Figure 5). For example: Generate reports for data starting 2 years ago (without being specific about a starting date). Click the Update button to display the report for the new period.

Some dates may yield no results. This simply means that there was no data during the selected dates. Please adjust your date range selection.

 

How to download a report in CSV format

Most reports can be downloaded in CSV format (good for further analysis or to email the report to another party).

Here we describe how the reports can be downloaded in CSV format.

All reports have an options menu on the top right-hand corner (see Figure 6) - 3 dots. To download the report in CSV format, click on the 3 dots to open the options menu.

In the Options menu, select More (figure 7)

Select the Download as CSV option (figure 8).

The report will be downloaded in a CSV format (figure 9)

TERN Geoserver usage reports

The following section describes each report of the TERN Geoserver server. Each report reveals specific metrics on the data usage from the TERN Geoserver server.

 

For each report values are based on the date range selected (see: How to display reports based on dates section above)

Downloaded

This report (figure 11) shows the total size in bytes of the data downloaded for all datasets (i.e. downloads during the selected date range)

Number of downloads

This report (figure 12) shows the total number of downloads on all datasets.

Number of users

This report (figure 13) shows the number of unique users who have downloaded the data.

Unique datasets accessed

This report (figure 14) shows the number of datasets which have been downloaded

Users and downloads per dataset

This report (figure 15) shows the dataset (geographic layer), the number of users who have downloaded that layer, and the number of times a layer has been downloaded.

Downloads by country and city

This report (figure 16) shows the number of downloads by country and city.

Downloads by region

This report (figure 17) shows the number of downloads by region

Number of users by city

This report (figure 18) shows the number of users by city who downloaded data.

Number of users by region

This report (figure 19) shows the number of users who downloaded data by region.

Downloads by country

This report (figure 20) shows the number of data downloads by country.

Users by country

This report (figure 21) shows the number of users who downloaded data by the country the users are from.

Users by state or region

This report (figure 22) shows the number of users who downloaded data by the geographical state/region the users are from.

 

End.

 

Provide your feedback about the experience with Knowledge base