Common analysis issues and solutions

Common issues you may encounter in ArcGIS Velocity when performing analysis in real-time and big data 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.

1. In a web browser, open the Velocity app.
2. Sign in with your ArcGIS organization credentials.
3. From the Velocity Home page, click the information button next to Subscription Utilization.
4. 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.

5. Click Delete to delete the existing refresh token.

   A window appears confirming the existing token was deleted.

6. Sign in again using the same ArcGIS organization account credentials to retrieve and register a new token.
7. Click Close once a new token is successfully registered.
8. 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 either a real-time or big data 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 Journeys, Calculate Motion Statistics, and others 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.

Big data analytics errors

The big data analytics errors along with recommended solutions are described below.

Big data analytics error	Recommended solution
Recurring big data analytic task took longer to run than the set recurrence interval. The next job will be skipped.	Big data analytics can be scheduled and configured to run periodically, run periodically within a time frame, or to run at a recurring time. This message is written to the logs if an analytic is still running at the time of another scheduled run—for example, if an analytic is configured to run every one minute but took roughly three minutes to complete. If this message appears frequently in the logs of a big data analytic, address this by either allocating additional resources in the run settings so the analytic completes faster or adjust the recurrence interval so the analytic can finish before the next scheduled run.
The recurring big data analytic failed because insufficient resources were available in the Velocity environment.	When a big data analytic is scheduled to run at a certain time or to recur repeatedly, sufficient resources must be available in the Velocity environment to fulfill each run at the time it runs. If the Velocity environment does not have sufficient resources for the recurring big data analytic to perform its processing at the time of the run, each run is skipped until sufficient resources are available. Velocity keeps attempting to run the big data analytic each time it is scheduled to run or recur.
Analytic failed, log message encountered: "Big data analytic task {id} ran out of memory during execution. Adjust the configuration to avoid failures."	When certain tools are present in an analytic and large volumes of data are being processed, additional run settings resources may need to be provided to ensure a successful run. If you encounter this log message, adjust the analytic run settings and change from a default plan to a large or extra large plan. If you increased your run settings resources and are still encountering this error, contact Esri Technical Support.
Analytic failed, status ToolTip or log message encountered: "The analytic failed with the reason OOMKilled (out of memory killed) for the driver pod. Please increase run setting resources and run again."	When certain tools are present in an analytic and large volumes of data are being processed, additional run settings resources may need to be provided to ensure a successful run. If you encounter this log message, adjust the analytic run settings and change from a default plan to a large or extra large plan. If you increased your run settings resources and are still encountering this error, contact Esri Technical Support. Future enhancements will automatically increase the relevant resources to ensure a successful analytic run as part of a retry policy.

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. For example, the Calculate Density tool can only process data that is in a 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.