Elasticsearch Add-On for Heroku 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 Add-On for Heroku 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 Add-On for Heroku, you will get an error message when you try to save.
trueto log all events, including system usage information and all requests.
- 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.3 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.
- are deprecated and will not be supported on 8.0.0
For version 6.4 and later, The following SAML user settings are also supported:
xpack.security.authProviders:: Set to
saml to 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.
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.
true(default) to enable the Grok Debugger.
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.
xpack.ml.enabled:: 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.
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.
falseto disable X-Pack APM UI.