Create Datafeeds API

This API enables you to instantiate a datafeed.

Request

PUT _xpack/ml/datafeeds/<feed_id>

Description

You must create a job before you create a datafeed. You can associate only one datafeed to each job.

Path Parameters

feed_id (required)
(string) A numerical character string that uniquely identifies the datafeed.

Request Body

aggregations
(object) If set, the datafeed performs aggregation searches. For more information, see Datafeed Resources.
chunking_config
(object) Specifies how data searches are split into time chunks. See Chunking Configuration Objects.
frequency
(time units) The interval at which scheduled queries are made while the datafeed runs in real time. The default value is either the bucket span for short bucket spans, or, for longer bucket spans, a sensible fraction of the bucket span. For example: 150s.
indices (required)
(array) An array of index names. Wildcards are supported. For example: ["it_ops_metrics", "server*"].
job_id (required)
(string) A numerical character string that uniquely identifies the job.
query
(object) The Elasticsearch query domain-specific language (DSL). This value corresponds to the query object in an Elasticsearch search POST body. All the options that are supported by Elasticsearch can be used, as this object is passed verbatim to Elasticsearch. By default, this property has the following value: {"match_all": {"boost": 1}}.
query_delay
(time units) The number of seconds behind real time that data is queried. For example, if data from 10:04 a.m. might not be searchable in Elasticsearch until 10:06 a.m., set this property to 120 seconds. The default value is 60s.
script_fields
(object) Specifies scripts that evaluate custom expressions and returns script fields to the datafeed. The detector configuration objects in a job can contain functions that use these script fields. For more information, see Script Fields.
scroll_size
(unsigned integer) The size parameter that is used in Elasticsearch searches. The default value is 1000.
types
(array) A list of types to search for within the specified indices. For example: []. This property is provided for backwards compatibility with releases earlier than 6.0.0. For more information, see Removal of mapping types.

For more information about these properties, see Datafeed Resources.

Authorization

You must have manage_ml, or manage cluster privileges to use this API. For more information, see Security Privileges.

Security Integration

When X-Pack security is enabled, your datafeed will remember which roles the user who created it had at the time of creation, and run the query using those same roles.

Examples

The following example creates the datafeed-total-requests datafeed:

PUT _xpack/ml/datafeeds/datafeed-total-requests
{
  "job_id": "total-requests",
  "indices": ["server-metrics"]
}

When the datafeed is created, you receive the following results:

{
  "datafeed_id": "datafeed-total-requests",
  "job_id": "total-requests",
  "query_delay": "83474ms",
  "indices": [
    "server-metrics"
  ],
  "types": [],
  "query": {
    "match_all": {
      "boost": 1.0
    }
  },
  "scroll_size": 1000,
  "chunking_config": {
    "mode": "auto"
  }
}