Get rollup job information
- GET /_rollup/job/{id}
- GET /_rollup/job
Get the configuration, stats, and status of rollup jobs.
NOTE: This API returns only active (both STARTED and STOPPED) jobs.
If a job was created, ran for a while, then was deleted, the API does not return any details about it.
For details about a historical rollup job, the rollup capabilities API may be more useful.
- Cluster privileges:
monitor_rollup
Path Parameters
-
idstring Idoptional -
Identifier for the rollup job. If it is
_allor omitted, the API returns all rollup jobs.Leave it out to use
/_rollup/job.
Response
-
jobsRollupJobrequired -
configRollupJobConfigurationrequired -
The rollup job configuration.
-
cronstringrequired -
groupsGroupingsrequired -
date_histogramDateHistogramGrouping -
A date histogram group aggregates a date field into time-based buckets. This group is mandatory; you currently cannot roll up documents without a timestamp and a
date_histogramgroup. -
delaystring Duration -
How long to wait before rolling up new documents. By default, the indexer attempts to roll up all data that is available. However, it is not uncommon for data to arrive out of order. The indexer is unable to deal with data that arrives after a time-span has been rolled up. You need to specify a delay that matches the longest period of time you expect out-of-order data to arrive.
-
fieldstring Fieldrequired -
The date field that is to be rolled up.
-
formatstring -
intervalstring Duration -
calendar_intervalstring Duration -
The interval of time buckets to be generated when rolling up.
-
fixed_intervalstring Duration -
The interval of time buckets to be generated when rolling up.
-
time_zonestring -
Defines what
time_zonethe rollup documents are stored as. Unlike raw data, which can shift timezones on the fly, rolled documents have to be stored with a specific timezone. By default, rollup documents are stored inUTC. -
histogramHistogramGrouping -
The histogram group aggregates one or more numeric fields into numeric histogram intervals.
-
fieldsstring Fieldsrequired -
The set of fields that you wish to build histograms for. All fields specified must be some kind of numeric. Order does not matter.
-
intervalnumberrequired -
The interval of histogram buckets to be generated when rolling up. For example, a value of
5creates buckets that are five units wide (0-5,5-10, etc). Note that only one interval can be specified in the histogram group, meaning that all fields being grouped via the histogram must share the same interval. -
termsTermsGrouping -
The terms group can be used on keyword or numeric fields to allow bucketing via the terms aggregation at a later point. The indexer enumerates and stores all values of a field for each time-period. This can be potentially costly for high-cardinality groups such as IP addresses, especially if the time-bucket is particularly sparse.
-
fieldsstring Fieldsrequired -
The set of fields that you wish to collect terms for. This array can contain fields that are both keyword and numerics. Order does not matter.
-
idstring Idrequired -
index_patternstringrequired -
metricsFieldMetricrequired -
page_sizenumberrequired -
rollup_indexstring IndexNamerequired -
timeoutstring Durationrequired -
statsRollupJobStatsrequired -
Transient statistics about the rollup job, such as how many documents have been processed and how many rollup summary docs have been indexed. These stats are not persisted. If a node is restarted, these stats are reset.
-
documents_processednumberrequired -
index_failuresnumberrequired -
index_time_in_msDurationValueUnitMillisrequired -
index_totalnumberrequired -
pages_processednumberrequired -
rollups_indexednumberrequired -
search_failuresnumberrequired -
search_time_in_msDurationValueUnitMillisrequired -
search_totalnumberrequired -
trigger_countnumberrequired -
processing_time_in_msDurationValueUnitMillisrequired -
processing_totalnumberrequired -
statusRollupJobStatusrequired -
The current status of the indexer for the rollup job.
-
current_positionmap string to object -
job_stateIndexingJobStaterequired -
Values:
startedindexingstoppingstoppedaborting -
upgraded_doc_idboolean