Commit graph

57 commits

Author SHA1 Message Date
James Rodewig
8b49218dd0 [DOCS] Fix rollup API prereq wording 2021-01-28 11:13:20 -05:00
James Rodewig
e618327ff4
[DOCS] Add xrefs to rollup overview (#68119) (#68123) 2021-01-28 10:51:31 -05:00
James Rodewig
0c78b0da60 [DOCS] Reword rollup API reqs 2021-01-26 16:04:54 -05:00
James Rodewig
666eceadb2 [DOCS] Add rollup API prereqs 2021-01-25 13:41:50 -05:00
James Rodewig
b691543f46
[DOCS] Fix metric requirements in rollup V2 API docs (#67922) (#67933) 2021-01-25 12:06:33 -05:00
James Rodewig
885eaa6705
[DOCS] Add test subs for rollover API docs (#67615) (#67616) 2021-01-15 17:44:40 -05:00
James Rodewig
af6a05f55b
[DOCS] Minor reword (#67183) (#67184) 2021-01-07 14:19:37 -05:00
James Rodewig
c2521f2e74
[DOCS] Update rollup def (#66870) (#66871) 2020-12-29 14:41:43 -05:00
James Rodewig
7242c511cd
[DOCS] Add xref to agg metric double field type (#66831) (#66832) 2020-12-28 10:22:17 -05:00
James Rodewig
99ea3efa45
[DOCS] Update rollup xrefs (#66799) (#66800) 2020-12-23 14:25:16 -05:00
James Rodewig
43d0430cfe [DOCS] Fix typo 2020-12-22 13:36:28 -05:00
James Rodewig
45f3e181c1
[DOCS] Increment section blocks (#66751) (#66753) 2020-12-22 11:15:28 -05:00
James Rodewig
d732d792fb
[DOCS] Minor rewording (#66744) (#66748) 2020-12-22 09:41:12 -05:00
Tal Levy
abe37e0fc3 move rollup_index param out of RollupActionConfig (#66139)
This commit moves the ownership of tracking the rollup_index from
the RollupActionConfig to the RollupAction.Request.

This is cleaner since the config should not be concerned with the
source and rollup indices.

relates #42720.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2020-12-14 10:38:58 -08:00
James Rodewig
e6bdfe42a4
[DOCS] Add timeout param for rollup API (#65858) (#66049) 2020-12-08 13:02:35 -05:00
James Rodewig
06fade7133
[DOCS] Rollup V2: Fix rollup index def (#65770) (#66048) 2020-12-08 13:02:21 -05:00
James Rodewig
92dc24e4c2
[DOCS] Fix docs integ tests for release builds (#65761) (#65765) 2020-12-02 12:34:26 -05:00
James Rodewig
6a6b4d5100
[DOCS] Label legacy rollup APIs (#65518) (#65679) 2020-12-01 09:53:31 -05:00
James Rodewig
0085361041
[DOCS] Replace "time-series" with "time series" (#65620) (#65622) 2020-11-30 12:55:45 -05:00
James Rodewig
a29e95fd94
[DOCS] Clarify metrics is array of strings (#65611) (#65613) 2020-11-30 10:03:51 -05:00
David Kyle
9ab179617a
Mute rollup docs test (#65585) (#65588)
For #65544
2020-11-30 10:58:51 +00:00
James Rodewig
e0cd917ca3
[DOCS] Add rollup V2 security privileges (#65512) (#65516) 2020-11-25 16:31:01 -05:00
James Rodewig
ff454ff0d9
[DOCS] Add rollup V2 API docs (#65398) (#65508)
Changes:

* Documents new `<index>/_rollup` API
* Updates rollup APIs overview page
* Enables rollups V2 in docs integ tests
2020-11-25 11:36:02 -05:00
James Rodewig
aea83909d9
[DOCS] Fix case for 'Boolean' (#64299) (#64341) 2020-10-29 10:04:20 -04:00
James Rodewig
b302b09b85
[DOCS] Reformat snippets to use two-space indents (#59973) (#59994) 2020-07-21 15:49:58 -04:00
James Rodewig
db89764539
[DOCS] Add data streams to rollup APIs (#59423) (#59465) 2020-07-13 16:57:40 -04:00
Lisa Cawley
11afead21e [DOCS] Adds collapsible sections to rollup APIs (#54690) 2020-04-02 17:51:16 -07:00
Hendrik Muhs
7dcacf531f
[7.x][Transform][Rollup] add processing stats to record the ti… (#54027)
add 2 additional stats: processing time and processing total which capture the
time spent for processing results and how often it ran. The 2 new stats
correspond to the existing indexing and search stats. Together with indexing
and search this now allows the user to see the full picture, all 3 stages.
2020-03-24 09:22:02 +01:00
Lisa Cawley
ca895d3ad5 [DOCS] Merge rollup config details into API (#49412) 2019-11-22 08:39:49 -08:00
Lisa Cawley
0f15736687 [DOCS] Reformat rollup API docs (#49397) 2019-11-20 10:46:16 -08:00
Lisa Cawley
39ef795085
[DOCS] Cleans up links to security content (#47610) (#47703) 2019-10-07 15:23:19 -07:00
James Rodewig
e253ee6ba6
[DOCS] Change // CONSOLE comments to [source,console] (#46440) (#46494) 2019-09-09 12:35:50 -04:00
James Rodewig
f04573f8e8
[DOCS] [5 of 5] Change // TESTRESPONSE comments to [source,console-results] (#46449) (#46459) 2019-09-06 16:09:09 -04:00
James Rodewig
bb7bff5e30
[DOCS] Replace "// TESTRESPONSE" magic comments with "[source,console-result] (#46295) (#46418) 2019-09-06 09:22:08 -04:00
James Rodewig
a219a0f819 [DOCS] Replace placeholder anchors for create rollup job API docs. (#45712) 2019-08-20 10:45:28 -04:00
Lisa Cawley
bb22b2e45f [DOCS] Reformats get rollup jobs API (#45114) 2019-08-06 09:40:18 -07:00
Lisa Cawley
8fdcf28fac [DOCS] Reformats API parameter details (#44194) 2019-07-12 08:28:49 -07:00
Lisa Cawley
00b16e332d [DOCS] Reformat rollup APIs to use new API format (#44131) 2019-07-10 15:15:02 -07:00
Zachary Tong
6ae6f57d39
[7.x Backport] Force selection of calendar or fixed intervals (#41906)
The date_histogram accepts an interval which can be either a calendar
interval (DST-aware, leap seconds, arbitrary length of months, etc) or
fixed interval (strict multiples of SI units). Unfortunately this is inferred
by first trying to parse as a calendar interval, then falling back to fixed
if that fails.

This leads to confusing arrangement where `1d` == calendar, but
`2d` == fixed.  And if you want a day of fixed time, you have to
specify `24h` (e.g. the next smallest unit).  This arrangement is very
error-prone for users.

This PR adds `calendar_interval` and `fixed_interval` parameters to any
code that uses intervals (date_histogram, rollup, composite, datafeed, etc).
Calendar only accepts calendar intervals, fixed accepts any combination of
units (meaning `1d` can be used to specify `24h` in fixed time), and both
are mutually exclusive.

The old interval behavior is deprecated and will throw a deprecation warning.
It is also mutually exclusive with the two new parameters. In the future the
old dual-purpose interval will be removed.

The change applies to both REST and java clients.
2019-05-20 12:07:29 -04:00
James Rodewig
cfe85c73bf Fix typo in rollup_index definition (#40520) 2019-03-27 10:04:49 -04:00
Tal Levy
cb7e3708bc
Rollup jobs should be cleaned up before indices are deleted (#38930) (#39144)
Rollup jobs should be stopped + deleted before the indices are removed.
It's possible for an active rollup job to issue a bulk request, the test
ends and the cleanup code deletes all indices.  The in-flight bulk
request will then stall + error because the index no-longer exists...
but this process might take longer than the StopRollup timeout.

Which means the test fails, and often fails several other tests since
the job is still active (e.g. other tests cannot create the same-named
job, or fail to stop the job in their cleanup because it's still stalled).

This tends to knock over several tests before the bulk finally times
out and the job shuts down.

Instead, we need to simply stop jobs first.  Inflight bulks will resolve
quickly, and we can carry on with deleting indices after the jobs are
confirmed inactive.

stop-job.asciidoc tended to trigger this issue because it executed
an async stop API and then exited, which setup the above situation. In
can and did happen with other tests though.  As an extra precaution,
the doc test was modified to substitute in wait_for_completion
to help head off these issues too.
2019-02-20 11:12:01 -08:00
Lisa Cawley
44e83f30e2
[DOCS] Edits rollup API description (#37444) 2019-01-15 08:46:36 -08:00
lcawl
32bed098bb [DOCS] Synchs titles of X-Pack APIs 2018-12-20 10:27:24 -08:00
Nik Everett
03daad9812
Re-deprecate xpack rollup endpoints (#36451)
Redeprecates the `/_xpack/rollup` endpoints in favor of `/_rollup`.

When we cleanup the rollup in a cluster containing 6.x nodes we need to
use `/_xpack/rollup` instead of `/_rollup` because the 6.x nodes don't
know about `/_rollup`. In those cases we must ignore the deprecation
warnings that the 7.0 node will return for the end point.

Closes #36044
2018-12-11 19:43:17 -05:00
Nik Everett
ead2b9e08b
HLRC: Add rollup search (#36334)
Relates to #29827
2018-12-07 14:39:58 -05:00
Jim Ferenczi
18866c4c0b
Make hits.total an object in the search response (#35849)
This commit changes the format of the `hits.total` in the search response to be an object with
a `value` and a `relation`. The `value` indicates the number of hits that match the query and the
`relation` indicates whether the number is accurate (in which case the relation is equals to `eq`)
or a lower bound of the total (in which case it is equals to `gte`).
This change also adds a parameter called `rest_total_hits_as_int` that can be used in the
search APIs to opt out from this change (retrieve the total hits as a number in the rest response).
Note that currently all search responses are accurate (`track_total_hits: true`) or they don't contain
`hits.total` (`track_total_hits: true`). We'll add a way to get a lower bound of the total hits in a
follow up (to allow numbers to be passed to `track_total_hits`).

Relates #33028
2018-12-05 19:49:06 +01:00
Zachary Tong
61c2db5ebb Revert "Deprecate X-Pack centric rollup endpoints (#35962)"
This reverts commit b84f1f6a3a.
2018-11-29 12:58:23 -05:00
Jason Tedor
b84f1f6a3a
Deprecate X-Pack centric rollup endpoints (#35962)
This commit is part of our plan to deprecate and ultimately remove the
use of _xpack in the REST APIs.
2018-11-27 20:34:17 -05:00
Zachary Tong
48fa251812
[Rollup] Add more diagnostic stats to job (#35471)
* [Rollup] Add more diagnostic stats to job

To help debug future performance issues, this adds the
 min/max/avg/count/total latencies (in milliseconds) for search
and bulk phase.  This latency is the total service time including
transfer between nodes, not just the `took` time.

It also adds the count of search/bulk failures encountered during
runtime.  This information is also in the log, but a runtime counter
will help expose problems faster

* review cleanup

* Remove dead ParseFields
2018-11-27 15:46:10 -05:00
Zachary Tong
c346a0f027
[Rollup] Add wait_for_completion option to StopRollupJob API (#34811)
This adds a `wait_for_completion` flag which allows the user to block 
the Stop API until the task has actually moved to a stopped state, 
instead of returning immediately.  If the flag is set, a `timeout` parameter
can be specified to determine how long (at max) to block the API
call.  If unspecified, the timeout is 30s.

If the timeout is exceeded before the job moves to STOPPED, a
timeout exception is thrown.  Note: this is just signifying that the API
call itself timed out.  The job will remain in STOPPING and evenutally
flip over to STOPPED in the background.

If the user asks the API to block, we move over the the generic
threadpool so that we don't hold up a networking thread.
2018-11-13 16:37:17 -05:00