Start PingIntelligence Dashboard in fast-forward mode to populate the Dashboard with historical data.
Possible scenarios in which running the 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 the 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.
The 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.
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 the Dashboard
fast-forward mode.
Parameter | Description |
---|---|
dashboard.fastforward.earlier_time |
The query start date and time in
|
dashboard.fastforward.later_time |
The query end date and time in
|
dashboard.fastforward.query.range |
The time in minutes that the 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
You can install a new instance of dashboard binary in a different directory in /opt/pingidentity/, for example: /opt/pingidentity/dashboard_fast_forward. You can enter the following command to start the Dashboard in fast-forward mode:
# /opt/pingidentity/dashboard_fast_forward/bin/start.sh --fast-forward
starting Dashboard Fastforward 4.1