Forecast：趋势预测

功能描述

趋势预测功能模块主要实现基于历史时序数据预测未来时序变化趋势。该模块框架解耦，可以实现不同预测算法的灵活替换，并且该模块功能可以实现不同特征时序的算法自动选择，支持线性特征时序预测LR回归算法和非线性特征预测ARIMA算法。目前该模块可以覆盖线性时序、非线性时序和周期时序的准确预测。

注意事项

使用该功能，exporter指标采集系统（即openGauss exporter、reprocessing exporter以及node exporter）必须运行正常，exporter指标采集系统部署请参考Prometheus Exporter组件。
综合实际业务与模型预测效果考虑，趋势预测时长建议不要太短，建议大于3600秒（如果指标采集周期为15秒，则数据量为240个），否则预测效果会变差，并且数据量极小时，服务会异常，因此默认配置为3600秒。
配置文件中的参数重新设置后，需要重新启动服务进程才能生效。

语法格式

gs_dbmind component forecast --help

显示如下帮助信息：

usage:  [-h] -c DIRECTORY [--metric-name METRIC_NAME] [--host HOST] [--start-time TIMESTAMP_IN_MICROSECONDS] [--end-time TIMESTAMP_IN_MICROSECONDS] [--retention-days DAYS]
        {show,clean}

Workload Forecasting: Forecast monitoring metrics

positional arguments:
  {show,clean}          choose a functionality to perform

optional arguments:
  -h, --help            show this help message and exit
  -c DIRECTORY, --conf DIRECTORY
                        set the directory of configuration files
  --metric-name METRIC_NAME
                        set a metric name you want to retrieve
  --host HOST           set a host you want to retrieve
  --start-time TIMESTAMP_IN_MICROSECONDS
                        set a start time of for retrieving
  --end-time TIMESTAMP_IN_MICROSECONDS
                        set a end time of for retrieving
  --retention-days DAYS
                        clear historical diagnosis results and set the maximum number of days to retain data

参数说明

参数	参数说明	取值范围
-h, --help	帮助命令。	-
action	动作参数。	show：结果展示 clean：清理结果
-c,--conf	配置目录。	-
--metric-name	指定显示指标名，用于过滤。	-
--host	指定服务IP和端口号，用于过滤。	-
--start-time	显示开始时间的时间戳，单位毫秒。	非负实数
--end-time	显示结束时间的时间戳，单位毫秒。	非负实数
--retention-days	保留结果天数。	非负实数

使用示例

假设用户已经初始化配置文件目录confpath，则可以通过下述命令实现本特性的功能：

仅启动趋势预测功能，启动命令如下（更多用法参考对service子命令的说明）。
```
gs_dbmind service start -c confpath --only-run forecast
```

用户交互式趋势预测，查看timestamps0到timestamps1时间段内的预测结果。

gs_dbmind component forecast show -c confpath --start-time timestamps0 --end-time timestamps1

例如：

gs_dbmind component forecast show -c confpath --start-time '2023-02-21 00:00:00' --end-time '2023-02-21 12:00:00' --host 172.16.101.34:5732

手动清理历史预测结果。

gs_dbmind component forecast clean -c confpath --retention-days DAYS

停止已启动的服务。
```
gs_dbmind service stop -c confpath
```