You can configure settings in
kibana.yml to control how X-Pack reporting
communicates with the Kibana server, manages background jobs, and captures
screenshots. See Reporting Settings for the complete
list of settings.
Encryption keys for multiple Kibana instancesedit
By default, a new encryption key is generated for X-Pack reporting each time you start Kibana. This means if a static encryption key is not persisted in the Kibana configuration, any pending reports will fail when you restart Kibana.
If you are load balancing across multiple Kibana instances, they need to have the same reporting encryption key. Otherwise, report generation will fail if a report is queued through one instance and another instance picks up the job from the report queue. The other instance will not be able to decrypt the reporting job metadata.
To set a static encryption key for reporting, set the
xpack.reporting.encryptionKey property in the
configuration file. You can use any text string as the encryption key.
Report indices for multiple Kibana workspacesedit
If you divide workspaces in an Elastic cluster using multiple Kibana instances
with a different
kibana.index setting per instance, you must set a unique
kibana.index. Otherwise, report generation will periodically fail
if a report is queued through an instance with one
kibana.index setting, and
an instance with a different
kibana.index attempts to claim the job.
Kibana instance A:
kibana.index: ".kibana-a" xpack.reporting.index: ".reporting-a" xpack.reporting.encryptionKey: "something_secret"
Kibana instance B:
kibana.index: ".kibana-b" xpack.reporting.index: ".reporting-b" xpack.reporting.encryptionKey: "something_secret"
If security is enabled, the
xpack.reporting.index setting should begin
.reporting- in order for the
kibana_system role to have the necessary
privileges over the index.
Use reverse proxiesedit
If your Kibana instance requires a reverse proxy (NGINX, Apache, etc.) for
access, because of rewrite rules or special headers being added by the proxy,
then you need to configure the
xpack.reporting.kibanaServer settings to make
the headless browser process connect to the proxy in Kibana server settings.
A headless browser runs on the Kibana server to open a Kibana page for
capturing screenshots. Configuring the
to point to a proxy host requires that the Kibana server has network access to