forked from elastic/elasticsearch
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into fips_enforce_provider
- Loading branch information
Showing
150 changed files
with
4,131 additions
and
1,237 deletions.
There are no files selected for viewing
Validating CODEOWNERS rules …
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
pr: 102798 | ||
summary: Hot-reloadable remote cluster credentials | ||
area: Security | ||
type: enhancement | ||
issues: [] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
pr: 103032 | ||
summary: "x-pack/plugin/apm-data: Map some APM fields as flattened and fix error.grouping_name script" | ||
area: Data streams | ||
type: enhancement | ||
issues: [] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
pr: 103135 | ||
summary: Use deduced mappings for determining proper fields' format even if `deduce_mappings==false` | ||
area: Transform | ||
type: bug | ||
issues: | ||
- 103115 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
pr: 103325 | ||
summary: Added Duplicate Word Check Feature to Analysis Nori | ||
area: Search | ||
type: feature | ||
issues: | ||
- 103321 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
pr: 103340 | ||
summary: Avoid humongous blocks | ||
area: ES|QL | ||
type: enhancement | ||
issues: [] |
76 changes: 76 additions & 0 deletions
76
docs/reference/connector/apis/check-in-connector-api.asciidoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
[[check-in-connector-api]] | ||
=== Check in connector API | ||
|
||
preview::[] | ||
|
||
++++ | ||
<titleabbrev>Check in a connector</titleabbrev> | ||
++++ | ||
|
||
Updates the `last_seen` field of a connector with current timestamp. | ||
|
||
[[check-in-connector-api-request]] | ||
==== {api-request-title} | ||
|
||
`PUT _connector/<connector_id>/_check_in` | ||
|
||
[[check-in-connector-api-prereq]] | ||
==== {api-prereq-title} | ||
|
||
* To sync data using connectors, it's essential to have the Elastic connectors service running. | ||
* The `connector_id` parameter should reference an existing connector. | ||
|
||
[[check-in-connector-api-path-params]] | ||
==== {api-path-parms-title} | ||
|
||
`<connector_id>`:: | ||
(Required, string) | ||
|
||
|
||
[[check-in-connector-api-response-codes]] | ||
==== {api-response-codes-title} | ||
|
||
`200`:: | ||
Connector `last_seen` field was successfully updated with a current timestamp. | ||
|
||
`400`:: | ||
The `connector_id` was not provided. | ||
|
||
`404` (Missing resources):: | ||
No connector matching `connector_id` could be found. | ||
|
||
[[check-in-connector-api-example]] | ||
==== {api-examples-title} | ||
|
||
The following example updates the `last_seen` property with current timestamp for the connector with ID `my-connector`: | ||
|
||
//// | ||
[source, console] | ||
-------------------------------------------------- | ||
PUT _connector/my-connector | ||
{ | ||
"index_name": "search-google-drive", | ||
"name": "My Connector", | ||
"service_type": "google_drive" | ||
} | ||
-------------------------------------------------- | ||
// TESTSETUP | ||
[source,console] | ||
-------------------------------------------------- | ||
DELETE _connector/my-connector | ||
-------------------------------------------------- | ||
// TEARDOWN | ||
//// | ||
|
||
[source,console] | ||
---- | ||
PUT _connector/my-connector/_check_in | ||
---- | ||
|
||
[source,console-result] | ||
---- | ||
{ | ||
"result": "updated" | ||
} | ||
---- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
77 changes: 77 additions & 0 deletions
77
docs/reference/connector/apis/set-connector-sync-job-stats-api.asciidoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,77 @@ | ||
[[set-connector-sync-job-stats-api]] | ||
=== Set connector sync job stats API | ||
++++ | ||
<titleabbrev>Set connector sync job stats</titleabbrev> | ||
++++ | ||
|
||
Sets connector sync job stats. | ||
|
||
[[set-connector-sync-job-stats-api-request]] | ||
==== {api-request-title} | ||
`PUT _connector/_sync_job/<connector_sync_job_id>/_stats` | ||
|
||
[[set-connector-sync-job-stats-api-prereqs]] | ||
==== {api-prereq-title} | ||
|
||
* To sync data using connectors, it's essential to have the Elastic connectors service running. | ||
* The `connector_sync_job_id` parameter should reference an existing connector sync job. | ||
|
||
[[set-connector-sync-job-stats-api-desc]] | ||
==== {api-description-title} | ||
|
||
Sets the stats for a connector sync job. | ||
Stats include: `deleted_document_count`, `indexed_document_count`, `indexed_document_volume` and `total_document_count`. | ||
`last_seen` can also be updated using this API. | ||
This API is mainly used by the connector service for updating sync job information. | ||
|
||
[[set-connector-sync-job-stats-api-path-params]] | ||
==== {api-path-parms-title} | ||
|
||
`<connector_sync_job_id>`:: | ||
(Required, string) | ||
|
||
[role="child_attributes"] | ||
[[set-connector-sync-job-stats-api-request-body]] | ||
==== {api-request-body-title} | ||
|
||
`deleted_document_count`:: | ||
(Required, int) The number of documents the sync job deleted. | ||
|
||
`indexed_document_count`:: | ||
(Required, int) The number of documents the sync job indexed. | ||
|
||
`indexed_document_volume`:: | ||
(Required, int) The total size of the data (in MiB) the sync job indexed. | ||
|
||
`total_document_count`:: | ||
(Optional, int) The total number of documents in the target index after the sync job finished. | ||
|
||
`last_seen`:: | ||
(Optional, instant) The timestamp to set the connector sync job's `last_seen` property. | ||
|
||
[[set-connector-sync-job-stats-api-response-codes]] | ||
==== {api-response-codes-title} | ||
|
||
`200`:: | ||
Indicates that the connector sync job stats were successfully updated. | ||
|
||
`404`:: | ||
No connector sync job matching `connector_sync_job_id` could be found. | ||
|
||
[[set-connector-sync-job-stats-api-example]] | ||
==== {api-examples-title} | ||
|
||
The following example sets all mandatory and optional stats for the connector sync job `my-connector-sync-job`: | ||
|
||
[source,console] | ||
---- | ||
PUT _connector/_sync_job/my-connector-sync-job/_stats | ||
{ | ||
"deleted_document_count": 10, | ||
"indexed_document_count": 20, | ||
"indexed_document_volume": 1000, | ||
"total_document_count": 2000, | ||
"last_seen": "2023-01-02T10:00:00Z" | ||
} | ||
---- | ||
// TEST[skip:there's no way to clean up after creating a connector sync job, as we don't know the id ahead of time. Therefore, skip this test.] |
86 changes: 86 additions & 0 deletions
86
docs/reference/connector/apis/update-connector-error-api.asciidoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,86 @@ | ||
[[update-connector-error-api]] | ||
=== Update connector error API | ||
|
||
preview::[] | ||
|
||
++++ | ||
<titleabbrev>Update connector error</titleabbrev> | ||
++++ | ||
|
||
Updates the `error` field of a connector. | ||
|
||
[[update-connector-error-api-request]] | ||
==== {api-request-title} | ||
|
||
`PUT _connector/<connector_id>/_error` | ||
|
||
[[update-connector-error-api-prereq]] | ||
==== {api-prereq-title} | ||
|
||
* To sync data using connectors, it's essential to have the Elastic connectors service running. | ||
* The `connector_id` parameter should reference an existing connector. | ||
|
||
[[update-connector-error-api-path-params]] | ||
==== {api-path-parms-title} | ||
|
||
`<connector_id>`:: | ||
(Required, string) | ||
|
||
[role="child_attributes"] | ||
[[update-connector-error-api-request-body]] | ||
==== {api-request-body-title} | ||
|
||
`error`:: | ||
(Required, string) A messaged related to the last error encountered by the connector. | ||
|
||
|
||
[[update-connector-error-api-response-codes]] | ||
==== {api-response-codes-title} | ||
|
||
`200`:: | ||
Connector `error` field was successfully updated. | ||
|
||
`400`:: | ||
The `connector_id` was not provided or the request payload was malformed. | ||
|
||
`404` (Missing resources):: | ||
No connector matching `connector_id` could be found. | ||
|
||
[[update-connector-error-api-example]] | ||
==== {api-examples-title} | ||
|
||
The following example updates the `error` field for the connector with ID `my-connector`: | ||
|
||
//// | ||
[source, console] | ||
-------------------------------------------------- | ||
PUT _connector/my-connector | ||
{ | ||
"index_name": "search-google-drive", | ||
"name": "My Connector", | ||
"service_type": "google_drive" | ||
} | ||
-------------------------------------------------- | ||
// TESTSETUP | ||
[source,console] | ||
-------------------------------------------------- | ||
DELETE _connector/my-connector | ||
-------------------------------------------------- | ||
// TEARDOWN | ||
//// | ||
|
||
[source,console] | ||
---- | ||
PUT _connector/my-connector/_error | ||
{ | ||
"error": "Houston, we have a problem!" | ||
} | ||
---- | ||
|
||
[source,console-result] | ||
---- | ||
{ | ||
"result": "updated" | ||
} | ||
---- |
Oops, something went wrong.