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.