Start PingIntelligence Dashboard in fast-forward mode to populate the Dashboard with historical data. Possible scenarios in which running Dashboard in fast-forward mode is useful are:

  • Elasticsearch data was accidentally deleted, and you want to repopulate the Dashboard.
  • The Dashboard was not available for a specific duration of time, and you wish to fetch the data for that time duration.
  • The Dashboard was installed after the other PingIntelligence components were deployed, and you want to populate the Dashboard with data from when PingIntelligence was first started.

The following diagrams summarize the use case for Dashboard's fast-forward mode:

When you run Dashboard in fast-forward mode, it fetches data from a time frame you define in YYYY-MM-DDTHH:mm format in the dashboard.properties file. For example, if you want to fetch data from January 1, 2019 01:00 to March 31, 2019 23:00 , then earlier-date in dashboard.properties would be 2019-01-01T01:00 and later-date would be 2019-03-31T23:00.

Dashboard stops querying the AI engine when its query reaches the later date. The Dashboard stopping time is logged in the logs/dashboard_fastforward.log file along with the other Dashboard activities. The logs/dashboard_fastforward.log file is rotated every 24-hours. You can see the data visualization of the specified period in the Dashboard UI already running.

Attention: If your current Dashboard engine is running in /opt/pingidentity/dashboard/, make sure that you use a different directory to run Dashboard in fast-forward mode, for example, /opt/pingidentity/dashboard_fast_forward/.

Copy the Dashboard binary and configure the dashboard.properties file with earlier-date and later-date in the Fastforward section of the properties file. The following table shows the available parameters for Dashboard fast-forward mode.

Parameter Description
dashboard.fastforward.earlier_time The query start date and time in YYYY-DD-MMTHH:mm format.
dashboard.fastforward.later_time The query end date and time in YYYY-DD-MMTHH:mm format.
dashboard.fastforward.query.range The time in minutes that Dashboard queries the AI engine in a single pass.
dashboard.fastforward.query.cooling_period The time in seconds between two Dashboard queries to the AI engine. The minimum and the default value is 60 seconds.

The following is an example of the Fastforward section of the dashboard.properties file.

## Fastforward. Only applicable if dashboard is started with 'start.sh --fast-forward'

# earlier time. format YYYY-MM-DDTHH:mm
# E.g 2019-07-12T10:00
dashboard.fastforward.earlier_time=2019-07-12T10:00

# later time. format YYYY-MM-DDTHH:mm
# E.g 2019-11-13T23:50
dashboard.fastforward.later_time=2019-11-13T23:50

# query range in minutes. It should be multiple of 10
# minimum value is 10
dashboard.fastforward.query.range=60

# cooling period between each query polling batch in seconds
dashboard.fastforward.query.cooling_period=60

Start dashboard engine in fast-forward mode

Install a new instance of dashboard binary in a different directory in /opt/pingidentity/, for example, /opt/pingidentity/dashboard_fast_forward. Enter the following command to start Dashboard in fast-forward mode:

# /opt/pingidentity/dashboard_fast_forward/bin/start.sh --fast-forward
starting Dashboard Fastforward 4.1