Common analysis issues and solutions

Common issues you may encounter in ArcGIS Velocity when performing analysis in real-time analytics are described as well as recommended solutions. If you encounter an issue that is not addressed below, check the Esri Community and contact Esri Technical Support.

Note:

For issues and solutions related to accessing the Velocity app, signing in, or creating and starting items, refer to the troubleshooting topic.

Username error

Velocity sets a refresh token for each user the first time a feed or analytic is started. This refresh token is used to generate access tokens as needed to access online items. In some cases, there could be an issue with the refresh token, such as if a user changes their password.

To resolve refresh token issues in the logs such as Could not find a refresh token for user or any other error related to refresh tokens, follow the steps below.

In a web browser, open the Velocity app.
Sign in with your ArcGIS organization credentials.
From the Velocity Home page, click the information button next to Resource Utilization.
On the subscription information page, click Reset Refresh Token.

A window appears to ensure you want to delete your current token and register a new one.
Click Delete to delete the existing refresh token.

A window appears confirming the existing token was deleted.
Sign in again using the same ArcGIS organization account credentials to retrieve and register a new token.
Click Close once a new token is successfully registered.
Restart your feeds and analytics.

Data configuration errors

The data configuration errors along with recommended solutions are described below.


Data configuration error	Recommended solution
No time is defined or the operation requires the features to have time	Many tools—including track-based tools, temporal filters or joins, and tools performing time step analysis—require the input data to have time specified. Time is specified on data by identifying the `Start Time` or `End Time` key fields. For more information on how to specify start and end times, refer to configuring input data. If the `Start Time` or `End Time` fields are not identified, tools requiring features to have time report an error such as Dataset is invalid: operation requires the features to have time or Dataset is invalid: no time is defined.
Inbound features do not have geometry specified	Many of the analytic tools in a real-time analytic require that the input dataset have geometry specified. You can configure geometry for features in one of four ways: On the * Identify Key Fields* page of feed or source configuration, by doing one of the following: Specifying a Single geometry field Specifying X/Y fields Setting the geometry to be automatically identified for feature layer, stream layer, or shapefile feeds or sources Using the Calculate Fields or Map Fields tools to configure an Arcade expression that generates a geometry object using geometry functions
At least one valid TRACK_ID field needs to be selected or Dataset is invalid: operation requires TRACK_ID tag set errors	Many track-based analytic tools, such as Calculate Motion Statistics, require the input data to have a track ID key field specified. A track ID is a field in an incoming message or dataset that relates observations to specific entities. For example, a truck may be identified by its license plate number or an aircraft by an assigned flight number. These identifiers can be used as track IDs to track the events associated with a particular real-world entity or set of incidents. A track ID is specified as part of a feed or data source schema. For more information, refer to configuring input data. If a track ID is not specified, track-based analytic tools report an error such as At least one valid TRACK_ID field needs to be selected.

Coordinate systems errors

The coordinate systems errors along with recommended solutions are described below:


Coordinate systems error	Recommended solution
The input dataset is in a geographic coordinate system, but this operation requires a projected coordinate system.	Several analytic tools only work with data in either a geographic or projected coordinate system. The solution is to first configure the Project tool to convert the data to a projected coordinate system such as the well-known ID (WKID) 102100, which refers to WGS 1984 Web Mercator Auxiliary Sphere.
Planar and geodesic spatial relationships	When configuring spatial relationships such as near planar or near geodesic in analytic tools, you must choose the correct spatial relationship respective to the coordinate system of the input data for the tool. Specifically when configuring near planar spatial relationships, the spatial reference of both the target and join datasets must be a projected coordinate system. To address this, either use a near geodesic spatial relationship or use the Project tool to alter the target or join datasets to be in a projected coordinate system.