Advanced Settings

edit

Advanced Settings control the behavior of Kibana. You can change the settings that apply to spaces, or to all of Kibana. For example, you can change the format used to display dates, specify the default data view, and apply your own branding.

Changing a setting can affect Kibana performance and cause problems that are difficult to diagnose. Setting a property value to a blank field reverts to the default behavior, which might not be compatible with other configuration settings. Deleting a custom setting permanently removes it from Kibana.

Required permissions

edit

The Advanced Settings Kibana privilege is required to access Advanced Settings.

When you have insufficient privileges to edit advanced settings, the edit options are not visible, and the following indicator is displayed:

Example of Advanced Settings Management’s read only access indicator in Kibana’s header

To add the privilege, go to the Roles management page using the navigation menu or the global search field.

For more information on granting access to Kibana, refer to Granting access to Kibana.

Change the space settings

edit

Change the settings that apply only to Kibana spaces.

  1. Go to the Advanced settings page using the navigation menu or the global search field.
  2. Click Space Settings.
  3. Scroll or search for the setting.
  4. Make your change, then click Save changes.

General

edit

autocomplete:useTimeRange

When disabled, autocompletes the suggestions from your data set instead of the time range.

bfetch:disable

[8.15.0] Deprecated in 8.15.0. When disabled, search requests from Kibana will be made in individual HTTP requests rather than bundled together.

bfetch:disableCompression

[8.15.0] Deprecated in 8.15.0. When disabled, allows you to debug individual requests, but increases the response size.

csv:quoteValues

Set this property to true to quote exported values.

csv:separator

A string that serves as the separator for exported values.

dateFormat

The format to use for displaying pretty formatted dates.

dateFormat:dow

The day that a week should start on.

dateFormat:scaled

The values that define the format to use to render ordered time-based data. Formatted timestamps must adapt to the interval between measurements. Keys are ISO8601 intervals.

dateFormat:tz

The timezone that Kibana uses. The default value of Browser uses the timezone detected by the browser.

dateNanosFormat

The format to use for displaying pretty formatted dates of Elasticsearch date_nanos type.

defaultIndex

The index to access if no index is set. The default is null.

defaultRoute

The default route when opening Kibana. Use this setting to route users to a specific dashboard, application, or saved object as they enter each space.

fields:popularLimit

The top N most popular fields to show.

fileUpload:maxFileSize

Sets the file size limit when importing files. The default value is 100MB. The highest supported value for this setting is 1GB.

filterEditor:suggestValues

Set this property to false to prevent the filter editor and KQL autocomplete from suggesting values for fields.

autocomplete:valueSuggestionMethod

When set to terms_enum, autocomplete uses the terms enum API for value suggestions. Kibana returns results faster, but suggestions are approximate, sorted alphabetically, and can be outside the selected time range. (Note that this API is incompatible with Document-Level-Security.) When set to terms_agg, Kibana uses a terms aggregation for value suggestions, which is slower, but suggestions include all values that optionally match your time range and are sorted by popularity.

autocomplete:useTimeRange

Disable this property to get autocomplete suggestions from your full dataset, rather than from the current time range.

filters:pinnedByDefault

Set this property to true to make filters have a global state (be pinned) by default.

format:bytes:defaultPattern

The default numeral pattern format for the "bytes" format.

format:currency:defaultPattern

The default numeral pattern format for the "currency" format.

format:defaultTypeMap

A map of the default format name for each field type. Field types that are not explicitly mentioned use "_default_".

format:number:defaultLocale

The numeral pattern locale.

format:number:defaultPattern

The numeral pattern for the "number" format.

format:percent:defaultPattern

The numeral pattern for the "percent" format.

histogram:barTarget

When date histograms use the auto interval, Kibana attempts to generate this number of bars.

histogram:maxBars

To improve performance, limits the density of date and number histograms across Kibana using a test query. When the test query contains too many buckets, the interval between buckets increases. This setting applies separately to each histogram aggregation, and does not apply to other types of aggregations. To find the maximum value of this setting, divide the Elasticsearch search.max_buckets value by the maximum number of aggregations in each visualization.

history:limit

In fields that have history, such as query inputs, show this many recent values.

metaFields

Fields that exist outside of _source. Kibana merges these fields into the document when displaying it.

metrics:allowStringIndices

Enables you to use Elasticsearch indices in TSVB visualizations.

metrics:max_buckets

Affects the TSVB histogram density. Must be set higher than histogram:maxBars.

query:allowLeadingWildcards

Allows a wildcard (*) as the first character in a query clause. To disallow leading wildcards in Lucene queries, use query:queryString:options.

query:queryString:options

Options for the Lucene query string parser. Only used when "Query language" is set to Lucene.

savedObjects:listingLimit

The number of objects to fetch for lists of saved objects. The default value is 1000. Do not set above 10000.

savedObjects:perPage

The number of objects to show on each page of the list of saved objects. The default is 5.

search:queryLanguage

The query language to use in the query bar. Choices are KQL, a language built specifically for Kibana, and the Lucene query syntax.

shortDots:enable

Set this property to true to shorten long field names in visualizations. For example, show f.b.baz instead of foo.bar.baz.

sort:options

Options for the Elasticsearch sort parameter.

state:storeInSessionStorage

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Kibana tracks UI state in the URL, which can lead to problems when there is a lot of state information, and the URL gets very long. Enabling this setting stores part of the URL in your browser session to keep the URL short.

theme:darkMode

The UI theme that the Kibana UI should use. Set to enabled or disabled to enable or disable the dark theme. Set to system to have the Kibana UI theme follow the system theme. You must refresh the page to apply the setting.

theme:version

Kibana only ships with the v8 theme now, so this setting can no longer be edited.

timepicker:quickRanges

The list of ranges to show in the Quick section of the time filter. This should be an array of objects, with each object containing from, to (see accepted formats), and display (the title to be displayed).

timepicker:refreshIntervalDefaults

The default refresh interval for the time filter. Example: { "pause": true, "value": 15000 }.

timepicker:timeDefaults

The default selection in the time filter.

truncate:maxHeight

[8.16.0] Deprecated in 8.16.0. The maximum height that a cell occupies in a table. Set to 0 to disable truncation.

enableESQL

This setting enables ES|QL in Kibana.

Presentation Labs

edit

labs:canvas:enable_ui

When enabled, provides access to the experimental Labs features for Canvas.

labs:dashboard:deferBelowFold

When enabled, the panels that appear below the fold are loaded when they become visible on the dashboard. Below the fold refers to panels that are not immediately visible when you open a dashboard, but become visible as you scroll.

labs:dashboard:enable_ui

When enabled, provides access to the experimental Labs features for Dashboard.

Accessibility

edit

accessibility:disableAnimations

Turns off all unnecessary animations in the Kibana UI. Refresh the page to apply the changes.

Banners

edit

Banners are a subscription feature.

banners:placement

Set to Top to display a banner above the Elastic header for this space. Defaults to the value of the xpack.banners.placement configuration property.

banners:textContent

The text to display inside the banner for this space, either plain text or Markdown. Defaults to the value of the xpack.banners.textContent configuration property.

banners:textColor

The color for the banner text for this space. Defaults to the value of the xpack.banners.textColor configuration property.

banners:backgroundColor

The color of the banner background for this space. Defaults to the value of the xpack.banners.backgroundColor configuration property.

Dashboard

edit

xpackDashboardMode:roles

[7.7.0] Deprecated in 7.7.0. Deprecated; use feature privileges instead. The roles that belong to dashboard only mode.

Discover

edit

context:defaultSize

The number of surrounding entries to display in the context view. The default value is 5.

context:step

The number by which to increment or decrement the context size. The default value is 5.

context:tieBreakerFields

A comma-separated list of fields to use for breaking a tie between documents that have the same timestamp value. The first field that is present and sortable in the current data view is used.

defaultColumns

The columns that appear by default on the Discover page. The default is _source.

discover:maxDocFieldsDisplayed

Specifies the maximum number of fields to show in the document column of the Discover table.

discover:modifyColumnsOnSwitch

When enabled, removes the columns that are not in the new data view.

discover:rowHeightOption

The number of lines to allow in a row. A value of -1 automatically adjusts the row height to fit the contents. A value of 0 displays the content in a single line.

discover:sampleRowsPerPage

Limits the number of rows per page in the document table.

discover:sampleSize

Sets the maximum number of rows for the entire document table. This is the maximum number of documents fetched from Elasticsearch.

discover:searchFieldsFromSource

[8.15.0] Deprecated in 8.15.0. Load fields from the original JSON _source. When disabled, Discover loads fields using the Elasticsearch search API’s fields parameter.

discover:searchOnPageLoad

Controls whether a search is executed when Discover first loads. This setting does not have an effect when loading a saved Discover session.

discover:showFieldStatistics

[beta] This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features. Enables the Field statistics view. Examine details such as the minimum and maximum values of a numeric field or a map of a geo field.

discover:showMultiFields

Controls the display of multi-fields in the expanded document view.

discover:sort:defaultOrder

The default sort direction for time-based data views.

doc_table:hideTimeColumn

Hides the "Time" column in Discover and in all Discover session panels on dashboards.

doc_table:highlight

Highlights search results in Discover and Discover session panels on dashboards. Highlighting slows requests when working on big documents.

doc_table:legacy

[8.15.0] Deprecated in 8.15.0. Controls the way the document table looks and works. To use the new Document Explorer instead of the classic view, turn off this option. The Document Explorer offers better data sorting, resizable columns, and a full screen view.

truncate:maxHeight

The maximum height that a cell in a table can occupy. To disable truncation, set to 0.

Machine Learning

edit

ml:anomalyDetection:results:enableTimeDefaults

Use the default time filter in the Single Metric Viewer and Anomaly Explorer. If this setting is disabled, the results for the full time range are shown.

ml:anomalyDetection:results:timeDefaults

Sets the default time filter for viewing anomaly detection job results. This setting must contain from and to values (see accepted formats). It is ignored unless ml:anomalyDetection:results:enableTimeDefaults is enabled.

Notifications

edit

notifications:banner

A custom banner intended for temporary notices to all users. Supports Markdown.

notifications:lifetime:banner

The duration, in milliseconds, for banner notification displays. The default value is 3000000.

notifications:lifetime:error

The duration, in milliseconds, for error notification displays. The default value is 300000.

notifications:lifetime:info

The duration, in milliseconds, for information notification displays. The default value is 5000.

notifications:lifetime:warning

The duration, in milliseconds, for warning notification displays. The default value is 10000.

Observability

edit

apm:enableServiceOverview

When enabled, displays the Overview tab for services in APM.

observability:apmAgentExplorerView

[beta] This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features. Enables the Agent explorer view.

observability:apmAWSLambdaPriceFactor

Set the price per Gb-second for your AWS Lambda functions.

observability:apmAWSLambdaRequestCostPerMillion

Set the AWS Lambda cost per million requests.

observability:apmEnableContinuousRollups

[beta] This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features. When continuous rollups is enabled, the UI will select metrics with the appropriate resolution. On larger time ranges, lower resolution metrics will be used, which will improve loading times.

observability:apmEnableServiceMetrics

[beta] This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features. Enables the usage of service transaction metrics, which are low cardinality metrics that can be used by certain views like the service inventory for faster loading times.

observability:apmLabsButton

Enable or disable the APM Labs button — a quick way to enable and disable technical preview features in APM.

observability:apmEnableCriticalPath

When enabled, displays the critical path of a trace.

observability:apmProgressiveLoading

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. When enabled, uses progressive loading of some APM views. Data may be requested with a lower sampling rate first, with lower accuracy but faster response times, while the unsampled data loads in the background.

observability:apmServiceGroupMaxNumberOfServices

Limit the number of services in a given service group.

observability:apmServiceInventoryOptimizedSorting

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Sorts services without anomaly detection rules on the APM Service inventory page by service name.

observability:apmDefaultServiceEnvironment

Set the default environment for the APM app. When left empty, data from all environments will be displayed by default.

observability:apmEnableProfilingIntegration

Enable the Universal Profiling integration in APM.

observability:profilingShowErrorFrames

Show error frames in the Universal Profiling views to indicate stack unwinding failures.

observability:apmEnableTableSearchBar

[beta] This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features. Enables faster searching in APM tables by adding a handy search bar with live filtering. Available for the following tables: Services, Transactions, and Errors.

observability:enableAwsLambdaMetrics

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Display Amazon Lambda metrics in the service metrics tab.

observability:enableLegacyUptimeApp

Shows the Uptime app even if there is no recent Heartbeat data.

observability:enableComparisonByDefault

Determines whether the comparison feature is enabled or disabled by default in the APM app.

observability:enableInfrastructureView

Enables the Infrastructure view in the APM app.

observability:apmEnableTransactionProfiling

Enable Universal Profiling on Transaction view.

observability:enableInspectEsQueries

When enabled, allows you to inspect Elasticsearch queries in API responses.

observability:enableServiceGroups

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. When enabled, allows users to create Service Groups from the APM Service Inventory page.

observability:apmTraceExplorerTab

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Enable the APM Trace Explorer feature, that allows you to search and inspect traces with KQL or EQL.

observability:enableInfrastructureProfilingIntegration

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Enables the Profiling view in Host details within Infrastructure.

observability:enableInfrastructureAssetCustomDashboards

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Enables option to link custom dashboards in the Asset Details view.

observability:profilingPervCPUWattX86

The average amortized per-core power consumption (based on 100% CPU utilization) for x86 architecture.

observability:profilingPervCPUWattArm64

The average amortized per-core power consumption (based on 100% CPU utilization) for arm64 architecture.

observability:profilingDatacenterPUE

Data center power usage effectiveness (PUE) measures how efficiently a data center uses energy. Defaults to 1.7, the average on-premise data center PUE according to the Uptime Institute survey.

observability:profilingCo2PerKWH

Carbon intensity measures how clean your data center electricity is. Specifically, it measures the average amount of CO2 emitted per kilowatt-hour (kWh) of electricity consumed in a particular region.

observability:profilingAWSCostDiscountRate

If you’re enrolled in the AWS Enterprise Discount Program (EDP), enter your discount rate to update the profiling cost calculation.

observability:profilingAzureCostDiscountRate

If you have an Azure Enterprise Agreement with Microsoft, enter your discount rate to update the profiling cost calculation.

observability:profilingFetchTopNFunctionsFromStacktraces

Switch to fetch the TopN Functions from the Stacktraces API.

observability:profilingCostPervCPUPerHour

Default Hourly Cost per CPU Core for machines not on AWS or Azure.

Reporting

edit

xpackReporting:customPdfLogo

A custom image to use in the footer of the PDF.

Rollup

edit

Deprecated in 8.11.0.

Rollups are deprecated and will be removed in a future version. Use downsampling instead.

rollups:enableIndexPatterns

[8.15.0] Deprecated in 8.15.0. Enables the creation of data views that capture rollup indices, which in turn enables visualizations based on rollup data. Refresh the page to apply the changes.

Search

edit
courier:customRequestPreference
Request preference to use when courier:setRequestPreference is set to "custom".
courier:ignoreFilterIfFieldNotInIndex
Skips filters that apply to fields that don’t exist in the index for a visualization. Useful when dashboards consist of visualizations from multiple data views.
courier:maxConcurrentShardRequests
Controls the max_concurrent_shard_requests setting used for _msearch requests sent by Kibana. Set to 0 to disable this config and use the Elasticsearch default.
courier:setRequestPreference

Enables you to set which shards handle your search requests.

  • Session ID: Restricts operations to execute all search requests on the same shards. This has the benefit of reusing shard caches across requests.
  • Custom: Allows you to define your own preference. Use courier:customRequestPreference to customize your preference value.
  • None: Do not set a preference. This might provide better performance because requests can be spread across all shard copies. However, results might be inconsistent because different shards might be in different refresh states.
search:includeFrozen
[7.16.0] Deprecated in 7.16.0. Includes frozen indices in results. Searching through frozen indices might increase the search time. This setting is off by default. Users must opt-in to include frozen indices.
search:timeout
Change the maximum timeout, in milliseconds (ms), for search requests. To disable the timeout and allow queries to run to completion, set to 0. The default is 600000, or 10 minutes.

Security Solution

edit

securitySolution:defaultAnomalyScore

The threshold above which machine learning job anomalies are displayed in the Elastic Security app.

securitySolution:defaultIndex

A comma-delimited list of Elasticsearch indices from which the Elastic Security app collects events.

securitySolution:defaultThreatIndex

A comma-delimited list of Threat Intelligence indices from which the Elastic Security app collects indicators.

securitySolution:enableCcsWarning

Enables privilege check warnings in rules for CCS indices.

securitySolution:enableNewsFeed

Enables the security news feed on the Security Overview page.

securitySolution:ipReputationLinks

A JSON array containing links for verifying the reputation of an IP address. The links are displayed on IP detail pages.

securitySolution:newsFeedUrl

The URL from which the security news feed content is retrieved.

securitySolution:refreshIntervalDefaults

The default refresh interval for the Security time filter, in milliseconds.

securitySolution:rulesTableRefresh

Enables auto refresh on the rules and monitoring tables, in milliseconds.

securitySolution:showRelatedIntegrations

Shows related integrations on the rules and monitoring tables.

securitySolution:timeDefaults

The default period of time in the Security time filter.

Timelion

edit
timelion:es.default_index
The default index when using the .es() query.
timelion:es.timefield
The default field containing a timestamp when using the .es() query.
timelion:max_buckets
The maximum number of buckets a single data source can return. This value is used for calculating automatic intervals in visualizations.
timelion:min_interval
The smallest interval to calculate when using "auto".
timelion:target_buckets
Used for calculating automatic intervals in visualizations, this is the number of buckets to try to represent.

Visualization

edit

visualization:colorMapping

[7.11.0] Deprecated in 7.11.0. Maps values to specific colors in charts using the Compatibility palette.

visualization:useLegacyTimeAxis

[8.10.0] Deprecated in 8.10.0. Enables the legacy time axis for charts in Lens, Discover, Visualize and TSVB

visualization:heatmap:maxBuckets

The maximum number of buckets a datasource can return. High numbers can have a negative impact on your browser rendering performance.

visualization:visualize:legacyHeatmapChartsLibrary

Disable this option if you prefer to use the new heatmap charts with improved performance, legend settings, and more..

Change the global settings

edit

Change the settings that apply only to Kibana spaces.

  1. Go to the Advanced settings page using the navigation menu or the global search field.
  2. Click Global Settings.
  3. Scroll or search for the setting.
  4. Make your change, then click Save changes.

Custom branding

edit

xpackCustomBranding:logo

A custom image that appears in the header of all Kibana pages. Images must have a transparent background, and 128 x 128 pixels or smaller.

xpackCustomBranding:customizedLogo

The custom text that appears in the header of all Kibana pages. Images must have a transparent background, and 200 x 84 pixels or smaller.

xpackCustomBranding:pageTitle

The custom text that appears on Kibana browser tabs.

xpackCustomBranding:faviconSVG

The URL of a custom SVG image that appears on Kibana browser tabs. Images must be 16 x 16 pixels.

xpackCustomBranding:faviconPNG

The URL of a custom PNG image that appears on Kibana browser tabs.

Usage collection

edit
telemetry:enabled
Enabling data usage collection (also known as Telemetry) allows us to learn what our users are most interested in, so we can improve our products and services. Refer to our Privacy Statement for more details.