Kibana User Guide [4.2] » Settings » Setting Kibana Server Properties

Setting Kibana Server Properties

设置Kibana服务器属性

The Kibana server reads properties from the kibana.yml file on startup. The default settings configure Kibana to run on localhost:5601. To change the host or port number, or connect to Elasticsearch running on a different machine, you’ll need to update your kibana.yml file. You can also enable SSL and set a variety of other options.

Kibana 服务器在启动的时候会从 kibana.yml 文件读取属性设置。默认设置是运行在 localhost:5601。要变更主机或端口，或者连接远端主机上的 Elasticsearch，你都需要更新你的 kibana.yml 文件。你还可以开启 SSL 或者设置其他一系列选项：

Deprecated in 4.2.

4.2版本不支持

The names of several Kibana server properties changed in the 4.2 release of Kibana. The previous names remain as functional aliases, but are now deprecated and will be removed in a future release of Kibana.

Kibana服务器所有权的名字在Kibana发布后发生改变。以前的名字还在匿名工作，但是现在收到反对，将会在以后的Kibana版本中移除。

Table 2. Kibana Server Properties Kibana服务器所有权

`server.port` 4.2]Added in 4.2.	The port that the Kibana server runs on. alias: `port` [4.2]Deprecated in 4.2. default: `5601`
`server.host` [4.2]Added in 4.2.	The host to bind the Kibana server to. alias: `host` [4.2]Deprecated in 4.2. default: `"0.0.0.0"`
`elasticsearch.url` [4.2]Added in 4.2.	The Elasticsearch instance where the indices you want to query reside. alias: `elasticsearch_url` [4.2]Deprecated in 4.2. default: `"http://localhost:9200"`
`elasticsearch.preserveHost`[4.2]Added in 4.2.	By default, the host specified in the incoming request from the browser is specified as the host in the corresponding request Kibana sends to Elasticsearch. If you set this option to `false`, Kibana uses the host specified in `elasticsearch_url`. alias: `elasticsearch_preserve_host` [4.2]Deprecated in 4.2. default: `true`
`elasticsearch.ssl.cert` [4.2]Added in 4.2.	This parameter specifies the path to the SSL certificate for Elasticsearch instances that require a client certificate. alias: `kibana_elasticsearch_client_crt` [4.2]Deprecated in 4.2.
`elasticsearch.ssl.key` [4.2]Added in 4.2.	This parameter specifies the path to the SSL key for Elasticsearch instances that require a client key. alias: `kibana_elasticsearch_client_key` [4.2]Deprecated in 4.2.
`elasticsearch.password` [4.2]Added in 4.2.	This parameter specifies the password for Elasticsearch instances that use HTTP basic authentication. Kibana users still need to authenticate with Elasticsearch, which is proxied through the Kibana server. alias: `kibana_elasticsearch_password` deprecated [4.2]
`elasticsearch.username` [4.2]Added in 4.2.	This parameter specifies the username for Elasticsearch instances that use HTTP basic authentication. Kibana users still need to authenticate with Elasticsearch, which is proxied through the Kibana server. alias: `kibana_elasticsearch_username` [4.2]Deprecated in 4.2.
`elasticsearch.pingTimeout`[4.2]Added in 4.2.	This parameter specifies the maximum wait time in milliseconds for ping responses by Elasticsearch. alias: `ping_timeout` [4.2]Deprecated in 4.2. default: `1500`
`elasticsearch.startupTimeout`[4.2]Added in 4.2.	This parameter specifies the maximum wait time in milliseconds for Elasticsearch discovery at Kibana startup. Kibana repeats attempts to discover an Elasticsearch cluster after the specified time elapses. alias: `startup_timeout` [4.2]Deprecated in 4.2. default: `5000`
`kibana.index` [4.2]Added in 4.2.	The name of the index where saved searched, visualizations, and dashboards will be stored.. alias: `kibana_index` [4.2]Deprecated in 4.2. default: `.kibana`
`kibana.defaultAppId` [4.2]Added in 4.2.	The page that will be displayed when you launch Kibana: `discover`,`visualize`, `dashboard`, or `settings`. alias: `default_app_id` [4.2]Deprecated in 4.2. default: `"discover"`
`logging.silent` [4.2]Added in 4.2.	Set this value to `true` to suppress all logging output. default: `false`
`logging.quiet` [4.2]Added in 4.2.	Set this value to `true` to suppress all logging output except for log messages tagged `error`, `fatal`, or Hapi.js errors. default: `false`
`logging.verbose` [4.2]Added in 4.2.	Set this value to `true` to log all events, including system usage information and all requests. default: `false`
`logging.events` [4.2]Added in 4.2.	You can specify a map of log types to output tags for this parameter to create a customized set of loggable events, as in the following example: { log: ['info', 'warning', 'error', 'fatal'], response: '', error: '' }
`elasticsearch.requestTimeout`[4.2]Added in 4.2.	How long to wait for responses from the Kibana backend or Elasticsearch, in milliseconds. alias: `request_timeout` [4.2]Deprecated in 4.2. default: `500000`
`elasticsearch.shardTimeout`[4.2]Added in 4.2.	How long Elasticsearch should wait for responses from shards. Set to 0 to disable. alias: `shard_timeout` [4.2]Deprecated in 4.2. default: `0`
`elasticsearch.ssl.verify`[4.2]Added in 4.2.	Indicates whether or not to validate the Elasticsearch SSL certificate. Set to false to disable SSL verification. alias: `verify_ssl` [4.2]Deprecated in 4.2. default: `true`
`elasticsearch.ssl.ca` [4.2]Added in 4.2.	The path to the CA certificate for your Elasticsearch instance. Specify if you are using a self-signed certificate so the certificate can be verified. Disable`elasticsearch.ssl.verify` otherwise. alias: `ca` [4.2]Deprecated in 4.2.
`server.ssl.key` [4.2]Added in 4.2.	The path to your Kibana server’s key file. Must be set to encrypt communications between the browser and Kibana. alias: `ssl_key_file` [4.2]Deprecated in 4.2.
`server.ssl.cert` [4.2]Added in 4.2.	The path to your Kibana server’s certificate file. Must be set to encrypt communications between the browser and Kibana. alias: `ssl_cert_file` [4.2]Deprecated in 4.2.
`pid.file` [4.2]Added in 4.2.	The location where you want to store the process ID file. alias: `pid_file` [4.2]Deprecated in 4.2. default: `/var/run/kibana.pid`
`logging.dest` [4.2]Added in 4.2.	The location where you want to store the Kibana’s log output. If not specified, log output is written to standard output and not stored. Specifying a log file suppresses log writes to standard output. alias: `log_file` [4.2]

表 2. Kibana 服务器属性

属性	描述
port	Kibana 服务器运行的端口。默认：`port: 5601`。
host	Kibana 服务器监听的地址。默认：`host: "0.0.0.0"`。
elasticsearch_url	你想请求的索引存在哪个 Elasticsearch 实例上。默认：`elasticsearch_url: "http://localhost:9200"`。
elasticsearch_preserve_host	默认的，浏览器请求中的主机名即作为 Kibana 发送给 Elasticsearch 时请求的主机名。如果你设置这个参数为 `false`, Kibana 会改用`elasticsearch_url` 里的主机名。你应该不用担心这个设置 —— 直接用默认即可。默认：`elasticsearch_preserve_host: true`。
kibana_index	保存搜索，可视化，仪表板信息的索引的名字。默认：`kibana_index: .kibana`。
default_app_id	进入 Kibana 是默认显示的页面。可以为 `discover`, `visualize`,`dashboard` 或 `settings`。默认：`default_app_id: "discover"`。
request_timeout	等待 Kibana 后端或 Elasticsearch 的响应的超时时间，单位毫秒。默认：`request_timeout: 500000`。
shard_timeout	Elasticsearch 等待分片响应的超时时间。设置为 0 表示关闭超时控制。默认：`shard_timeout: 0`。
verify_ssl	定义是否验证 Elasticsearch SSL 证书。设置为 false 关闭 SSL 认证。默认：`verify_ssl: true`。
ca	你的 Elasticsearch 实例的 CA 证书的路径。如果你是自己签的证书，必须指定这个参数，证书才能被认证。否则，你需要关闭 `verify_ssl`。默认：none。
ssl_key_file	Kibana 服务器的密钥文件路径。设置用来加密浏览器和 Kibana 之间的通信。默认：none。
ssl_cert_file	Kibana 服务器的证书文件路径。设置用来加密浏览器和 Kibana 之间的通信。默认：none。
pid_file	你想用来存进程 ID 文件的位置。如果没有指定，PID 文件存在`/var/run/kibana.pid`。默认：none。

备注：
材料来自elastic官网。
参考整理：
http://kibana.logstash.es/content/kibana/v4/settings.html
原文地址：
https://www.elastic.co/guide/en/kibana/current/kibana-server-properties.html