-
Notifications
You must be signed in to change notification settings - Fork 8.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into cron_focus
- Loading branch information
Showing
785 changed files
with
21,343 additions
and
7,533 deletions.
There are no files selected for viewing
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
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
Empty file.
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
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,113 @@ | ||
[[upgrade-assistant-api-default-field]] | ||
=== Add default field API | ||
++++ | ||
<titleabbrev>Add default field</titleabbrev> | ||
++++ | ||
|
||
experimental[] In {es} 7.0 and later, some query types, such as Simple Query String, have a limit to the number of fields they can query against. | ||
To configure the cap in {es}, set the `indices.query.bool.max_clause_count` cluster setting, which is 1024 by default. | ||
|
||
For indices with more fields than the cap, add the `index.query.default_field` index setting to inform {es} which | ||
fields to use by default when no field is specified for a query. Use the add default field API to add the `index.query.default_field` setting to an {es} index. | ||
|
||
[[upgrade-assistant-api-default-field-request]] | ||
==== Request | ||
|
||
To add the `index.query.default_field` setting to an {es} index, submit a POST request to `/api/upgrade_assistant/add_query_default_field/<index>`: | ||
|
||
[source,js] | ||
-------------------------------------------------- | ||
GET /api/upgrade_assistant/add_query_default_field/myIndex | ||
{ | ||
"fieldTypes": ["text", "keyword"], <1> | ||
"otherFields": ["myField.*"] <2> | ||
} | ||
-------------------------------------------------- | ||
// KIBANA | ||
|
||
<1> A required array of {es} field types that generate the list of fields. | ||
<2> An optional array of additional field names, dot-deliminated. | ||
|
||
To add the `index.query.default_field` index setting to the specified index, {kib} generates an array of all fields from the index mapping. | ||
The fields contain the types specified in `fieldTypes`. {kib} appends any other fields specified in `otherFields` to the array of default fields. | ||
|
||
[[upgrade-assistant-api-default-field-response-codes]] | ||
==== Response codes | ||
|
||
`200`:: | ||
Indicates a successful call. | ||
|
||
`400`:: | ||
Indicates that the index already has the `index.query.default_field` setting. No changes are made to the index. | ||
|
||
[[upgrade-assistant-api-default-field-response-body]] | ||
==== Response body | ||
|
||
The response body contains a JSON structure, similar to the following: | ||
|
||
[source,js] | ||
-------------------------------------------------- | ||
{ | ||
"acknowledged": true | ||
} | ||
-------------------------------------------------- | ||
|
||
[[upgrade-assistant-api-default-field-example]] | ||
==== Example | ||
|
||
Your index contains following mappings: | ||
|
||
[source,js] | ||
-------------------------------------------------- | ||
GET /myIndex/_mappings | ||
{ | ||
"myIndex": { | ||
"mappings": { | ||
"properties": { | ||
"field1": { "type": "text" }, | ||
"field2": { "type": "float" }, | ||
"nestedfield": { | ||
"properties": { | ||
"field3": { "type": "keyword" }, | ||
"field4": { "type": "long" }, | ||
} | ||
} | ||
} | ||
} | ||
} | ||
} | ||
-------------------------------------------------- | ||
// CONSOLE | ||
|
||
Make the following request to {kib}: | ||
|
||
[source,js] | ||
-------------------------------------------------- | ||
GET /api/upgrade_assistant/add_query_default_field/myIndex | ||
{ | ||
"fieldTypes": ["text", "long"], | ||
"otherFields": ["field2"] | ||
} | ||
-------------------------------------------------- | ||
// KIBANA | ||
|
||
The API returns the following: | ||
|
||
[source,js] | ||
-------------------------------------------------- | ||
GET /myIndex/_settings?flat_settings=true | ||
{ | ||
"myIndex": { | ||
"settings": { | ||
"index.query.default_field": [ | ||
"field1", | ||
"nestedfield.field4", | ||
"field2", | ||
] | ||
} | ||
} | ||
} | ||
-------------------------------------------------- | ||
// CONSOLE | ||
|
||
{kib} generates the `field1` and `nestedfield.field4` values based on the specified `fieldTypes`, then appends the `otherFields` to the array. |
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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
43 changes: 43 additions & 0 deletions
43
docs/development/core/public/kibana-plugin-core-public.app.meta.md
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,43 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [App](./kibana-plugin-core-public.app.md) > [meta](./kibana-plugin-core-public.app.meta.md) | ||
|
||
## App.meta property | ||
|
||
Meta data for an application that represent additional information for the app. See [AppMeta](./kibana-plugin-core-public.appmeta.md) | ||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
meta?: AppMeta; | ||
``` | ||
|
||
## Remarks | ||
|
||
Used to populate navigational search results (where available). Can be updated using the [App.updater$](./kibana-plugin-core-public.app.updater_.md) observable. See [PublicAppSearchDeepLinkInfo](./kibana-plugin-core-public.publicappsearchdeeplinkinfo.md) for more details. | ||
|
||
## Example | ||
|
||
|
||
```ts | ||
core.application.register({ | ||
id: 'my_app', | ||
title: 'Translated title', | ||
meta: { | ||
keywords: ['translated keyword1', 'translated keyword2'], | ||
searchDeepLinks: [ | ||
{ id: 'sub1', title: 'Sub1', path: '/sub1', keywords: ['subpath1'] }, | ||
{ | ||
id: 'sub2', | ||
title: 'Sub2', | ||
searchDeepLinks: [ | ||
{ id: 'subsub', title: 'SubSub', path: '/sub2/sub', keywords: ['subpath2'] } | ||
] | ||
} | ||
], | ||
}, | ||
mount: () => { ... } | ||
}) | ||
|
||
``` | ||
|
42 changes: 0 additions & 42 deletions
42
docs/development/core/public/kibana-plugin-core-public.app.searchdeeplinks.md
This file was deleted.
Oops, something went wrong.
13 changes: 13 additions & 0 deletions
13
docs/development/core/public/kibana-plugin-core-public.appmeta.keywords.md
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,13 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [AppMeta](./kibana-plugin-core-public.appmeta.md) > [keywords](./kibana-plugin-core-public.appmeta.keywords.md) | ||
|
||
## AppMeta.keywords property | ||
|
||
Keywords to represent this application | ||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
keywords?: string[]; | ||
``` |
23 changes: 23 additions & 0 deletions
23
docs/development/core/public/kibana-plugin-core-public.appmeta.md
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,23 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [AppMeta](./kibana-plugin-core-public.appmeta.md) | ||
|
||
## AppMeta interface | ||
|
||
Input type for meta data for an application. | ||
|
||
Meta fields include `keywords` and `searchDeepLinks` Keywords is an array of string with which to associate the app, must include at least one unique string as an array. `searchDeepLinks` is an array of links that represent secondary in-app locations for the app. | ||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
export interface AppMeta | ||
``` | ||
|
||
## Properties | ||
|
||
| Property | Type | Description | | ||
| --- | --- | --- | | ||
| [keywords](./kibana-plugin-core-public.appmeta.keywords.md) | <code>string[]</code> | Keywords to represent this application | | ||
| [searchDeepLinks](./kibana-plugin-core-public.appmeta.searchdeeplinks.md) | <code>AppSearchDeepLink[]</code> | Array of links that represent secondary in-app locations for the app. | | ||
|
13 changes: 13 additions & 0 deletions
13
docs/development/core/public/kibana-plugin-core-public.appmeta.searchdeeplinks.md
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,13 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [AppMeta](./kibana-plugin-core-public.appmeta.md) > [searchDeepLinks](./kibana-plugin-core-public.appmeta.searchdeeplinks.md) | ||
|
||
## AppMeta.searchDeepLinks property | ||
|
||
Array of links that represent secondary in-app locations for the app. | ||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
searchDeepLinks?: AppSearchDeepLink[]; | ||
``` |
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
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
Oops, something went wrong.