Elasticsearch Service supports most of the standard Kibana and X-Pack settings. Through a YAML editor in the console, you can append Kibana properties to the
kibana.yml file. Your changes to the configuration file are read on startup.
Be aware that some settings that could break your cluster if set incorrectly and that the syntax might change between major versions. Before upgrading, be sure to review the full list of the latest Kibana settings and syntax.
To change Kibana settings:
- Log into the Elasticsearch Service Console.
On the Deployments page, select your deployment.
Narrow your deployments by name, ID, or choose from several other filters. To customize your view, use a combination of filters, or change the format from a grid to a list.
- From your deployment menu, go to the Edit page.
- At the bottom of the Kibana instance, expand the User settings overrides caret.
- Update the user settings.
- Click Save changes.
Saving your changes initiates a configuration plan change that restarts Kibana automatically for you.
If a setting is not supported by Elasticsearch Service, you will get an error message when you try to save.
- Specifies the time in milliseconds to wait for autocomplete suggestions from Elasticsearch. The default is 1000. Allowed values are between 1 and 1200000. Available on Kibana 7.3 and higher. To learn more, see Configuring Kibana.
- Specifies the max number of documents loaded by each shard to generate autocomplete suggestions. The default is 100000. Allowed values are between 1 and 10000000. Available on Kibana 7.3 and higher. To learn more, see Configuring Kibana.
- Specifies additional vector layers for use in Region Map visualizations. Each layer object points to an external vector file that contains a geojson FeatureCollection. The file must use the WGS84 coordinate reference system and only include polygons. If the file is hosted on a separate domain from Kibana, the server needs to be CORS-enabled so Kibana can download the file. The following example shows a valid regionmap configuration.
map.regionmap: includeElasticMapsService: false layers: - name: "Departments of France" url: "http://my.cors.enabled.server.org/france_departements.geojson" attribution: "INRAP" fields: - name: "department" description: "Full department name" - name: "INSEE" description: "INSEE numeric identifier"
- Turns on or off
whether layers from the Elastic Maps Service should be included in the vector
layer option list. Supported on Elastic Cloud Enterprise. By turning this off,
only the layers that are configured here will be included. The default is
- Optional. References the originating source of the geojson file.
- Mandatory. Each layer can contain multiple fields to indicate what properties from the geojson features you wish to expose. The example above shows how to define multiple properties.
- Mandatory. The human readable text that is shown under the Options tab when building the Region Map visualization.
This value is used to do an inner-join between the document stored in
Elasticsearch and the geojson file. For example, if the field in the geojson is
Locationand has city names, there must be a field in Elasticsearch that holds the same values that Kibana can then use to lookup for the geoshape data.
- Mandatory. A description of the map being provided.
- Mandatory. The location of the geojson file as provided by a webserver.
- Specifies the default route when opening Kibana. You can use this setting to modify the landing page when opening Kibana.
Adds the map attribution string.
In version 7.0, all tilemap settings now begin with
map.. For example,
- Sets the maximum zoom level.
- Sets the minimum zoom level.
- Provides an array of subdomains used by the tile service.
Specify the position of the subdomain the URL with the token
- Lists the URL to the tileservice that Kibana uses to display map tiles in tilemap visualizations.
- Specifies the locale for all strings, dates, and number formats that can be localized. Defaults to
For version 7.x The Timelion application no longer appears by default in the Kibana side navigation.
trueto add Timelion back in the side navigation.
- For version 7.2 and later, the following SAML user settings are also supported:
- Specifies which SAML realm in Elasticsearch should be used.
- Specifies which providers are going to be used in Kibana.
The following settings are deprecated and are not supported in version 8.0
For version 6.4 and later, The following SAML user settings are also supported:
- Set to
samlto instruct Kibana to use SAML SSO as the authentication method.
- Whitelists the SAML authentication URL within Kibana, so that the Kibana server doesn’t reject external authentication messages that originate from your Identity Provider.
- Set to HTTP or HTTPS. To access Kibana, HTTPS protocol is recommended.
- Set to a fully qualified hostname to connect your users to the proxy server.
- The port number that connects your users to the proxy server (for example, 80 for HTTP or 443 for HTTPS).
To learn more, see configuring Kibana to use SAML.
- OpenID Connect
- The following OpenID Connect user settings are supported:
- Specifies which OpenID Connect realm in Elasticsearch should be used.
To learn more, see configuring Kibana to use OpenID Connect.
- Specifies the session duration in milliseconds. Allows a value between 15000 (15 seconds) and 86400000 (1 day). To learn more, see Security settings in Kibana.
For version 5.0 and later: You can configure the following X-Pack settings from the Kibana User Settings editor. You can review the full list of the latest X-Pack settings, if needed.
- Set to
true(default) to enable the Grok Debugger.
- Set to
falseto disable X-Pack graph.
- When enabled, specifies the email address to receive cluster alert notifications. As of version 6.5, replaces the
xpack:defaultAdminEmailsetting for monitoring.
- Controls how often data samples are collected.
- Specifies the minimum number of seconds that a time bucket in a chart can represent. If you modify the
xpack.monitoring.kibana.collection.interval, use the same value in this setting.
For Elasticsearch clusters that run in containers, enables the
Node Listingto display the
CPU utilizationbased on the
Cgroup statistics, and adds the
Cgroup CPU utilizationto the Node Overview page instead of the overall operating system CPU utilization.
Set to true (default) to enable machine learning.
If set to
kibana.yml, the machine learning icon is hidden in this Kibana instance. If
xpack.ml.enabledis set to
elasticsearch.yml, however, you can still use the machine learning APIs. To disable machine learning entirely, see the Elasticsearch Machine Learning Settings.
- Set to
falseto disable reporting.
How long each worker has to produce a report. If your machine is slow or under heavy load, you might need to increase this timeout. Specified in milliseconds.
Specifies the browser to use to capture screenshots. Valid options are
chromiumis set, the settings specified in the Chromium settings are respected.
- Set to any text string. To provide your own encryption key for reports, use this setting.
Sets the maximum size of a CSV file before being truncated. This setting exists to prevent large exports from causing performance and storage issues.
- The following APM settings are supported in Kibana:
- Set to
falseto disable X-Pack APM UI.
- Matcher for indices containing span documents. Defaults to apm-*.
- Matcher for indices containing error documents. Defaults to apm-*.
- Matcher for indices containing transaction documents. Defaults to apm-*.