Merge branch 'master' of github.com:elastic/kibana into rbac_search_s…

…trategy

.gitignore

@@ -19,6 +19,9 @@ target
 *.iml
 *.log
 
+# Ignore example plugin builds
+/examples/*/build
+
 # Ignore certain functional test runner artifacts
 /test/*/failure_debug
 /test/*/screenshots/diff
@@ -76,6 +79,6 @@ report.asciidoc
 .yarn-local-mirror
 
 # Bazel
-bazel
-bazel-*
+/bazel
+/bazel-*
 .bazelrc.user

.i18nrc.json

@@ -19,6 +19,7 @@
     "expressions": "src/plugins/expressions",
     "expressionError": "src/plugins/expression_error",
     "expressionImage": "src/plugins/expression_image",
+    "expressionMetric": "src/plugins/expression_metric",
     "expressionRepeatImage": "src/plugins/expression_repeat_image",
     "expressionRevealImage": "src/plugins/expression_reveal_image",
     "expressionShape": "src/plugins/expression_shape",

api_docs/alerting.json

@@ -701,7 +701,7 @@
             "description": [],
             "signature": [
               "() => Set<",
-              "RegistryAlertType",
+              "RegistryRuleType",
               ">"
             ],
             "source": {
@@ -1330,7 +1330,7 @@
             "description": [],
             "signature": [
               "() => Set<",
-              "RegistryAlertType",
+              "RegistryRuleType",
               ">"
             ],
             "source": {

api_docs/triggers_actions_ui.json

@@ -2187,10 +2187,10 @@
           },
           {
             "parentPluginId": "triggersActionsUi",
-            "id": "def-public.TriggersAndActionsUiServices.alertTypeRegistry",
+            "id": "def-public.TriggersAndActionsUiServices.ruleTypeRegistry",
             "type": "Object",
             "tags": [],
-            "label": "alertTypeRegistry",
+            "label": "ruleTypeRegistry",
             "description": [],
             "signature": [
               "{ get: (id: string) => ",
@@ -2535,10 +2535,10 @@
       },
       {
         "parentPluginId": "triggersActionsUi",
-        "id": "def-public.AlertTypeRegistryContract",
+        "id": "def-public.RuleTypeRegistryContract",
         "type": "Type",
         "tags": [],
-        "label": "AlertTypeRegistryContract",
+        "label": "RuleTypeRegistryContract",
         "description": [],
         "signature": [
           "{ get: (id: string) => ",
@@ -3623,10 +3623,10 @@
         },
         {
           "parentPluginId": "triggersActionsUi",
-          "id": "def-public.TriggersAndActionsUIPublicPluginSetup.alertTypeRegistry",
+          "id": "def-public.TriggersAndActionsUIPublicPluginSetup.ruleTypeRegistry",
           "type": "Object",
           "tags": [],
-          "label": "alertTypeRegistry",
+          "label": "ruleTypeRegistry",
           "description": [],
           "signature": [
             "TypeRegistry",
@@ -3684,10 +3684,10 @@
         },
         {
           "parentPluginId": "triggersActionsUi",
-          "id": "def-public.TriggersAndActionsUIPublicPluginStart.alertTypeRegistry",
+          "id": "def-public.TriggersAndActionsUIPublicPluginStart.ruleTypeRegistry",
           "type": "Object",
           "tags": [],
-          "label": "alertTypeRegistry",
+          "label": "ruleTypeRegistry",
           "description": [],
           "signature": [
             "TypeRegistry",

docs/apm/correlations.asciidoc

@@ -1,73 +1,73 @@
 [role="xpack"]
 [[correlations]]
-=== Find latency and error correlations
+=== Find transaction latency and failure correlations
 
-**Correlations** surface attributes of your data that are potentially correlated with high-latency or erroneous transactions.
-By default, a number of attributes commonly known to cause performance issues, like version,
-infrastructure, and location, are included, but all are completely customizable to your APM data.
-Find something interesting? A quick click of a button will auto-query your data as you work to resolve the underlying issue.
+Correlations surface attributes of your data that are potentially correlated
+with high-latency or erroneous transactions. For example, if you are a site
+reliability engineer who is responsible for keeping production systems up and
+running, you want to understand what is causing slow transactions. Identifying
+attributes that are responsible for higher latency transactions can potentially
+point you toward the root cause. You may find a correlation with a particular
+piece of hardware, like a host or pod. Or, perhaps a set of users, based on IP
+address or region, is facing increased latency due to local data center issues.
 
-For example, a site reliability engineer, who is responsible for keeping production systems up and running,
-notices an increase in latency in certain transactions.
-Analyzing metadata or tags that exist in high-latency transactions but not in lower-latency transactions
-can potentially point towards the root cause.
-They may find that a particular piece of hardware, like a host or pod, has failed, increasing latency.
-Or, perhaps set of users, based on IP address or region, is facing increased latency due to local data center issues.
+To find correlations, select a service on the *Services* page in the {apm-app}
+and click **View correlations**.
 
-[discrete]
-[[view-correlations]]
-===  View correlations
-
-With a service selected, click **View correlations**:
-
-[role="screenshot"]
-image::apm/images/correlations.png[Correlations]
-
-Queries within the APM app apply to the correlations shown in the correlations fly-out.
-
-If a correlated field seems noteworthy, use the **Filter** quick links:
-
-* `+` creates a new query in the APM app for filtering transactions containing the selected value.
-* `-` creates a new query in the APM app to filter out transactions containing the selected value.
+NOTE: Queries within the {apm-app} are also applied to the correlations.
 
 [discrete]
 [[correlations-latency]]
-==== Find high-latency correlations
-
-Correlations help you discover which fields are contributing to increased service latency.
-
-A latency distribution chart visualizes the overall latency of the selected service's transactions.
-Correlated attributes are sorted by _Impact_–a visual representation of the
-{ref}/search-aggregations-bucket-significantterms-aggregation.html[significant terms aggregation]
-score that powers correlations.
-Attributes with a high impact, or attributes present in a large percentage of slow transactions,
-may contribute to increased latency.
-
-To find high-latency correlations, hover over each potentially correlated attribute to
-compare the latency distribution of transactions with and without the selected attribute.
+==== Find high transaction latency correlations
 
-For example, in the screenshot below, the field `user_agent.name` and value `HeadlessChrome`
-exists primarily in higher-latency transactions between 3.7 and 8.7 seconds.
+The correlations on the *Latency* tab help you discover which attributes are
+contributing to increased transaction latency. 
 
 [role="screenshot"]
-image::apm/images/correlations-hover.png[Correlations hover effect]
-
-Select the `+` filter to create a new query in the APM app for transactions with
-`user_agent.name: HeadlessChrome`. With the "noise" now filtered out,
-you can begin viewing sample traces to continue your investigation.
-
-As you sift through high-latency transactions, you'll likely notice other interesting attributes.
-Return to the correlations fly-out and select *Customize fields* to search on these new attributes.
-You may need to do this a few times–each time filtering out more and more noise and bringing you
-closer to a diagnosis.
+image::apm/images/correlations-hover.png[Latency correlations]
+
+The progress bar indicates the status of the asynchronous analysis, which
+performs statistical searches across a large number of attributes. For large
+time ranges and services with high transaction throughput this might take some
+time. To improve performance, reduce the time range on the service overview
+page.
+
+The latency distribution chart visualizes the overall latency of the
+transactions in the service. If there are attributes that have a statistically
+significant correlation with slow response times, they are listed in a table
+below the chart. The table is sorted by correlation coefficients that range from
+0 to 1. Attributes with higher correlation values are more likely to contribute
+to high latency transactions. By default, the attribute with the highest
+correlation value is added to the chart. To see the latency distribution for
+other attributes, hover over their row in the table.
+
+If a correlated attribute seems noteworthy, use the **Filter** quick links:
+
+* `+` creates a new query in the {apm-app} for filtering transactions containing
+the selected value.
+* `-` creates a new query in the {apm-app} to filter out transactions containing
+the selected value.
+
+In this example screenshot, transactions with the field
+`labels.orderPriceRange` and value `large` are skewed to the right with slower
+response times than the overall latency distribution. If you select the `+`
+filter in the appropriate row of the table, it creates a new query in the
+{apm-app} for transactions with this attribute. With the "noise" now filtered
+out, you can begin viewing sample traces to continue your investigation.
 
 [discrete]
 [[correlations-error-rate]]
-==== Find error rate correlations
+==== Find failed transaction correlations
+
+The correlations on the *Error rate* tab help you discover which fields are
+contributing to failed transactions.
 
-Correlations help you discover which fields are contributing to failed transactions.
+By default, a number of attributes commonly known to cause performance issues,
+like version, infrastructure, and location, are included, but all are completely
+customizable to your APM data. Find something interesting? A quick click of a 
+button will auto-query your data as you work to resolve the underlying issue.
 
-The Error rate over time chart visualizes the change in error rate over the selected time frame.
+The error rate over time chart visualizes the change in error rate over the selected time frame.
 Correlated attributes are sorted by _Impact_–a visual representation of the
 {ref}/search-aggregations-bucket-significantterms-aggregation.html[significant terms aggregation]
 score that powers correlations.
@@ -83,7 +83,7 @@ existed in 100% of failed transactions between 6:00 and 10:30.
 [role="screenshot"]
 image::apm/images/error-rate-hover.png[Correlations errors hover effect]
 
-Select the `+` filter to create a new query in the APM app for transactions with
+Select the `+` filter to create a new query in the {apm-app} for transactions with
 `url.original: http://localhost:3100...`. With the "noise" now filtered out,
 you can begin viewing sample traces to continue your investigation.
 
@@ -94,16 +94,14 @@ closer to a diagnosis.
 
 [discrete]
 [[correlations-customize-fields]]
-====  Customize fields
+=====  Customize fields
 
-Correlations are only as good as the data they're searching for.
-By default, a handful of attributes commonly known to cause performance issues are included.
-During the course of an investigation however, you may to need to add and remove fields from
-this list multiple times as you narrow in on a diagnosis.
+By default, a handful of attributes commonly known to cause performance issues
+are included in the analysis on the *Error rate* tab. You can add and remove
+fields under the **Customize fields** dropdown.
 
-Add and remove fields under the **Customize fields** dropdown.
-The following fields are selected by default.
-To keep the default list manageable, only the first six matching fields with wildcards are used.
+The following fields are selected by default. To keep the default list
+manageable, only the first six matching fields with wildcards are used.
 
 **Frontend (RUM) agent:**
 
@@ -120,4 +118,9 @@ To keep the default list manageable, only the first six matching fields with wil
 * `service.node.name`
 * `service.version`
 
-TIP: Want to start over? Select **reset** to clear your customizations.
+[TIP]
+====
+* Want to start over? Select **reset** to clear your customizations.
+* The *Latency* tab does not have a **Customize fields** dropdown, since it
+automatically considers all relevant fields in the transactions.
+====

docs/developer/advanced/development-basepath.asciidoc

@@ -3,9 +3,9 @@
 
 In dev mode, {kib} by default runs behind a proxy which adds a random path component to its URL.
 
-You can set this explicitly using `server.basePath` in <<settings>>. 
+You can set this explicitly using <<server-basePath,`server.basePath`>>. This setting cannot end in a slash (/).
 
-Use the server.rewriteBasePath setting to tell {kib} if it should remove the basePath from requests it receives, and to prevent a deprecation warning at startup. This setting cannot end in a slash (/).
+Use <<server-rewriteBasePath,`server.rewriteBasePath`>> to tell {kib} if it should remove the basePath from requests it receives, and to prevent a deprecation warning at startup. 
 
 If you want to turn off the basepath when in development mode, start {kib} with the `--no-base-path` flag
 
@@ -15,4 +15,3 @@ yarn start --no-base-path
 ----
 
 
-

docs/developer/plugin-list.asciidoc

@@ -80,6 +80,10 @@ This API doesn't support angular, for registering angular dev tools, bootstrap a
 |Expression Image plugin adds an image renderer to the expression plugin. The renderer will display the given image.
 
 
+|{kib-repo}blob/{branch}/src/plugins/expression_metric/README.md[expressionMetric]
+|Expression Metric plugin adds a metric renderer and function to the expression plugin.
+
+
 |{kib-repo}blob/{branch}/src/plugins/expression_repeat_image/README.md[expressionRepeatImage]
 |Expression Repeat Image plugin adds a repeatImage function to the expression plugin and an associated renderer. The renderer will display the given image in mutliple instances.
 

docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.md

@@ -18,6 +18,6 @@ export interface KibanaExecutionContext
 |  [description](./kibana-plugin-core-public.kibanaexecutioncontext.description.md) | <code>string</code> | human readable description. For example, a vis title, action name |
 |  [id](./kibana-plugin-core-public.kibanaexecutioncontext.id.md) | <code>string</code> | unique value to identify the source |
 |  [name](./kibana-plugin-core-public.kibanaexecutioncontext.name.md) | <code>string</code> | public name of a user-facing feature |
-|  [type](./kibana-plugin-core-public.kibanaexecutioncontext.type.md) | <code>string</code> | Kibana application initated an operation. Can be narrowed to an enum later. |
+|  [type](./kibana-plugin-core-public.kibanaexecutioncontext.type.md) | <code>string</code> | Kibana application initated an operation. |
 |  [url](./kibana-plugin-core-public.kibanaexecutioncontext.url.md) | <code>string</code> | in browser - url to navigate to a current page, on server - endpoint path, for task: task SO url |
 

docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md

@@ -4,7 +4,7 @@
 
 ## KibanaExecutionContext.type property
 
-Kibana application initated an operation. Can be narrowed to an enum later.
+Kibana application initated an operation.
 
 <b>Signature:</b>
 

docs/development/core/server/kibana-plugin-core-server.md

@@ -329,6 +329,7 @@ The plugin integrates with the core system via lifecycle events: `setup`<!-- -->
 |  [SavedObjectsImportHook](./kibana-plugin-core-server.savedobjectsimporthook.md) | A hook associated with a specific saved object type, that will be invoked during the import process. The hook will have access to the objects of the registered type.<!-- -->Currently, the only supported feature for import hooks is to return warnings to be displayed in the UI when the import succeeds. The only interactions the hook can have with the import process is via the hook's response. Mutating the objects inside the hook's code will have no effect. |
 |  [SavedObjectsImportWarning](./kibana-plugin-core-server.savedobjectsimportwarning.md) | Composite type of all the possible types of import warnings.<!-- -->See [SavedObjectsImportSimpleWarning](./kibana-plugin-core-server.savedobjectsimportsimplewarning.md) and [SavedObjectsImportActionRequiredWarning](./kibana-plugin-core-server.savedobjectsimportactionrequiredwarning.md) for more details. |
 |  [SavedObjectsNamespaceType](./kibana-plugin-core-server.savedobjectsnamespacetype.md) | The namespace type dictates how a saved object can be interacted in relation to namespaces. Each type is mutually exclusive: \* single (default): This type of saved object is namespace-isolated, e.g., it exists in only one namespace. \* multiple: This type of saved object is shareable, e.g., it can exist in one or more namespaces. \* multiple-isolated: This type of saved object is namespace-isolated, e.g., it exists in only one namespace, but object IDs must be unique across all namespaces. This is intended to be an intermediate step when objects with a "single" namespace type are being converted to a "multiple" namespace type. In other words, objects with a "multiple-isolated" namespace type will be \*share-capable\*, but will not actually be shareable until the namespace type is changed to "multiple". \* agnostic: This type of saved object is global. |
+|  [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) | If defined, allows a type to run a search query and return a query filter that may match any documents which may be excluded from the next migration upgrade process. Useful for cleaning up large numbers of old documents which are no longer needed and may slow the migration process.<!-- -->If this hook fails, the migration will proceed without these documents having been filtered out, so this should not be used as a guarantee that these documents have been deleted.<!-- -->Experimental and subject to change |
 |  [SavedObjectUnsanitizedDoc](./kibana-plugin-core-server.savedobjectunsanitizeddoc.md) | Describes Saved Object documents from Kibana &lt; 7.0.0 which don't have a <code>references</code> root property defined. This type should only be used in migrations. |
 |  [ScopeableRequest](./kibana-plugin-core-server.scopeablerequest.md) | A user credentials container. It accommodates the necessary auth credentials to impersonate the current user.<!-- -->See [KibanaRequest](./kibana-plugin-core-server.kibanarequest.md)<!-- -->. |
 |  [ServiceStatusLevel](./kibana-plugin-core-server.servicestatuslevel.md) | A convenience type that represents the union of each value in [ServiceStatusLevels](./kibana-plugin-core-server.servicestatuslevels.md)<!-- -->. |

docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-core-server](./kibana-plugin-core-server.md) &gt; [SavedObjectsType](./kibana-plugin-core-server.savedobjectstype.md) &gt; [excludeOnUpgrade](./kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md)
+
+## SavedObjectsType.excludeOnUpgrade property
+
+If defined, allows a type to exclude unneeded documents from the migration process and effectively be deleted. See [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) for more details.
+
+<b>Signature:</b>
+
+```typescript
+excludeOnUpgrade?: SavedObjectTypeExcludeFromUpgradeFilterHook;
+```