Analyzing Usage Statistics

Usage statistics logs are conveniently saved in .csv format for quick analysis in a spreadsheet or for importing to a database. We recommend copying them from the server onto a local machine for analysis.

These detailed logs include the following columns of information.


Column Name	Description
Date of request	Date format is `dd-mmm-yy`
Time of request	Time format is `hh:mm:ss`
Originating IP (of client browser)	IP Address of the internet browser for Spectrum Spatial™ Analyst.
User Agent (of client browser)	This identifies the browser and version in use. The exact format of information varies between browsers.
Tenant (always analyst)	Always set to `analyst`.
Current Map Project	The name of map project in use at the time of the request.
Operation	Identifies the name of the action that the user was taking that caused Spectrum Spatial™ Analyst to make a server-side request. See list in next table.
Base URL	The URL to the map and layers in the request or query.
URL Parameters	URL parameters sent by Spectrum Spatial™ Analyst as part of the request. Only some of the requests made have parameters. For example, `Getmap` has parameters that identify the layers requested when rendering maps.
User Name	The user name as defined in Spectrum Spatial™ Manager.
Session ID (unique for each user session)	Spectrum Spatial™ Analyst generates this value to identify a unique user session and the activity between login and time out (such as how long Spectrum Spatial™ Analyst was in use and how many map requests were made). This ID is specific to Spectrum Spatial™ Analyst, it is not used by Spectrum.
HTTP Response Status Code	The standard HTTP response code as defined in Wikipedia "List of HTTP status codes" https://en.wikipedia.org/wiki/List_of_HTTP_status_codes). The most common codes are 200 (ok), 404 (not found), and 403 (forbidden).
Response Size (bytes)	Query response size in bytes.
Response Time (ms)	Query response time in milliseconds.

Operation Column Properties

The following table lists the possible entries in the Operations column of a Usage Statistics log file. These identify the name of the action that the user was taking that caused Spectrum Spatial™ Analyst to make a request to the server. Operations are not case sensitive.


Property	Description
`AccessControlService`	Renders information from the Access Control Service.
`checkApplicationLinking`	Indicates if application linking is enabled or not.
`checkExtensibility`	Indicates if extensibility is enabled for this Spectrum Spatial™ Analyst instance.
`config`	Describes the template mapping configuration.
`dataBindList`	Lists all data binds, which are defined for layers. A data bind lets Spectrum Spatial™ Analyst get attribute data for a feature from an external data source (such as a non spatial table).
`delete`
`distinctRecords`	Lists the distinct records for a selected column (the maximum number of records is 999). When the query returns fewer than 50 records, Spectrum Spatial™ Analyst displays them in a selection list to use when creating a custom query.
`featureEditTemplateList`	Lists the Feature Editing templates.
`featureService`	Lists attribute data about the map features from the Spatial Feature Service.
`functionalityProfileList`	Lists the functionality profiles that were accessed.
`genericProxy`	Provides basic (generic) proxy information for the service being accessed.
`getAuthMapConfigs`	Provides the configuration information about the authenticated map.
`getDeployedProfile`	Provides information about the Spectrum Spatial™ Analyst installation.
`getFeatureEditTemplates`	Provides a list of the Feature Edit templates in use.
`getinfo`	Provides a logged-in user’s information.
`getmap`	Renders information about the map request from the Spatial Mapping Service.
`getQueryMap`	Provides information about the map query result.
`getTile`	Provides information about the tile from the Spatial Tile Service.
`getWMS`	Renders information about the map from a third-party Web Mapping Service.
`getQueryMap`	Provides the map query made by the user.
`infoTemplateList`	Lists the information template that is in use.
`listRoles`	Lists a logged-in user’s roles.
`MappingService`	Renders information, such as a legend or map description, from the Spatial Mapping Service.
`map-project`	Lists the map project that the user is accessing.
`mapProjectList`	Lists the map projects.
`MapTilingService`	Renders information, such as map tiles, from the Map Tiling Service.
`queryDataLoad`	Provides information about the number of transactions being processed by the request.
`resources`	Lists all of the named resources accessed by the request.
`singleLine`	Searches an address from the Spectrum Spatial™ Analyst Locate Service and displays the search address in the parameters column.
`tables`	Lists all of the tables that the request accessed.

Tracking Address Searches

Usage statistics logs include all searches made to the Spectrum Spatial™ Analyst locator service. You can query a copy of the log files to analyze this information.

If a region requires a royalty payment (such as a per click price) for searching address postcode, you would filter the log files for the singleLine entry in the Operation column. The search result would provide the date and time of each request and the search term.