Configure the Kibana endpoint

Kibana dashboards are loaded into Kibana via the Kibana API. This requires a Kibana endpoint configuration. For details on authenticating to the Kibana API, see Authentication.

You configure the endpoint in the setup.kibana section of the auditbeat.yml config file.

Here is an example configuration:

setup.kibana.host: "http://localhost:5601"

Configuration options

edit

You can specify the following options in the setup.kibana section of the auditbeat.yml config file:

`setup.kibana.host`

edit

The Kibana host where the dashboards will be loaded. The default is 127.0.0.1:5601. The value of host can be a URL or IP:PORT. For example: http://192.15.3.2, 192:15.3.2:5601 or http://192.15.3.2:6701/path. If no port is specified, 5601 is used.

When a node is defined as an IP:PORT, the scheme and path are taken from the setup.kibana.protocol and setup.kibana.path config options.

IPv6 addresses must be defined using the following format: https://[2001:db8::1]:5601.

`setup.kibana.protocol`

edit

The name of the protocol Kibana is reachable on. The options are: http or https. The default is http. However, if you specify a URL for host, the value of protocol is overridden by whatever scheme you specify in the URL.

Example config:

setup.kibana.host: "192.0.2.255:5601"
setup.kibana.protocol: "http"
setup.kibana.path: /kibana

`setup.kibana.username`

edit

The basic authentication username for connecting to Kibana. If you don’t specify a value for this setting, Auditbeat uses the username specified for the Elasticsearch output.

`setup.kibana.password`

edit

The basic authentication password for connecting to Kibana. If you don’t specify a value for this setting, Auditbeat uses the password specified for the Elasticsearch output.

`setup.kibana.path`

edit

An HTTP path prefix that is prepended to the HTTP API calls. This is useful for the cases where Kibana listens behind an HTTP reverse proxy that exports the API under a custom prefix.

`setup.kibana.space.id`

edit

The Kibana space ID to use. If specified, Auditbeat loads Kibana assets into this Kibana space. Omit this option to use the default space.

`setup.kibana.headers`

edit

Custom HTTP headers to add to each request sent to Kibana. Example:

setup.kibana.headers:
  X-My-Header: Header contents

`setup.kibana.ssl.enabled`

edit

Enables Auditbeat to use SSL settings when connecting to Kibana via HTTPS. If you configure Auditbeat to connect over HTTPS, this setting defaults to true and Auditbeat uses the default SSL settings.

Example configuration:

setup.kibana.host: "https://192.0.2.255:5601"
setup.kibana.ssl.enabled: true
setup.kibana.ssl.certificate_authorities: ["/etc/client/ca.pem"]
setup.kibana.ssl.certificate: "/etc/client/cert.pem"
setup.kibana.ssl.key: "/etc/client/cert.key

See SSL for more information.

« Configure Elasticsearch index template loading Configure Kibana dashboard loading »