预测作业 API编辑

通过使用时间序列的历史行为来预测其未来的行为。

请求编辑

POST _ml/anomaly_detectors/<job_id>/_forecast

先决条件编辑

需要 manage_ml 集群权限。此权限包含在 machine_learning_admin 内置角色中。

描述编辑

您可以基于异常检测作业创建预测作业,以推断未来的行为。请参阅 预测未来预测限制 了解更多信息。

您可以使用 删除预测 API 删除预测。

  • 预测不支持执行总体分析的作业;如果您尝试为具有其配置中 over_field_name 属性的作业创建预测,则会发生错误。
  • 创建预测时,作业必须处于打开状态。否则,会发生错误。

路径参数编辑

<job_id>
(必填,字符串) 异常检测作业的标识符。

查询参数编辑

duration
(可选,时间单位) 指示预测未来多长时间的时期。例如,30d 对应 30 天。默认值为 1 天。预测从处理的最后一个记录开始。
expires_in
(可选,时间单位) 预测结果保留的时间段。预测过期后,结果将被删除。默认值为 14 天。如果设置为 0,则预测永远不会自动删除。
max_model_memory
(可选,字节值) 预测可以使用最大内存。如果预测需要使用超过提供的内存量,它将转储到磁盘。默认值为 20mb,最大值为 500mb,最小值为 1mb。如果设置为作业配置的内存限制的 40% 或更多,它将自动减少到低于该值。

请求正文编辑

您也可以在请求正文中指定查询参数(例如 durationexpires_in)。

示例编辑

POST _ml/anomaly_detectors/low_request_rate/_forecast
{
  "duration": "10d"
}

创建预测时,您将收到以下结果

{
  "acknowledged": true,
  "forecast_id": "wkCWa2IB2lF8nSE_TzZo"
}

随后,您可以在 Kibana 中的 单指标查看器 中查看预测。