2018-04-20 21:13:37 +02:00
|
|
|
[role="xpack"]
|
|
|
|
[[reporting-settings-kb]]
|
2020-06-08 23:46:26 +02:00
|
|
|
=== Reporting settings in {kib}
|
2018-04-20 21:13:37 +02:00
|
|
|
++++
|
2019-02-11 17:17:25 +01:00
|
|
|
<titleabbrev>Reporting settings</titleabbrev>
|
2018-04-20 21:13:37 +02:00
|
|
|
++++
|
|
|
|
|
|
|
|
You can configure `xpack.reporting` settings in your `kibana.yml` to:
|
|
|
|
|
2019-02-11 17:17:25 +01:00
|
|
|
* <<reporting-kibana-server-settings,Control how the {report-features} communicate with the {kib} server>>
|
2018-04-20 21:13:37 +02:00
|
|
|
* <<reporting-job-queue-settings,Manage background jobs>>
|
|
|
|
* <<reporting-capture-settings,Capture screenshots>>
|
|
|
|
|
|
|
|
[float]
|
|
|
|
[[general-reporting-settings]]
|
2019-02-11 17:17:25 +01:00
|
|
|
==== General reporting settings
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
2020-09-03 22:06:45 +02:00
|
|
|
| [[xpack-enable-reporting]]`xpack.reporting.enabled` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Set to `false` to disable the {report-features}.
|
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
| `xpack.reporting.encryptionKey` {ess-icon}
|
2020-07-28 16:35:00 +02:00
|
|
|
| Set to an alphanumeric, at least 32 characters long text string. By default, {kib} will generate a random key when it
|
2020-05-04 17:22:40 +02:00
|
|
|
starts, which will cause pending reports to fail after restart. Configure this
|
|
|
|
setting to preserve the same key across multiple restarts and multiple instances of {kib}.
|
|
|
|
|
|
|
|
|===
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[reporting-kibana-server-settings]]
|
2020-05-04 17:22:40 +02:00
|
|
|
==== {kib} server settings
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
Reporting opens the {kib} web interface in a server process to generate
|
|
|
|
screenshots of {kib} visualizations. In most cases, the default settings
|
|
|
|
will work and you don't need to configure Reporting to communicate with {kib}.
|
2019-11-21 20:30:03 +01:00
|
|
|
However, if your client connections must go through a reverse-proxy
|
2020-05-04 17:22:40 +02:00
|
|
|
to access {kib}, Reporting configuration must have the proxy port, protocol,
|
2019-11-21 20:30:03 +01:00
|
|
|
and hostname set in the `xpack.reporting.kibanaServer.*` settings.
|
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[NOTE]
|
2019-11-21 20:30:03 +01:00
|
|
|
====
|
2020-05-04 17:22:40 +02:00
|
|
|
If a reverse-proxy carries encrypted traffic from end-user
|
|
|
|
clients back to a {kib} server, the proxy port, protocol, and hostname
|
|
|
|
in Reporting settings must be valid for the encryption that the Reporting
|
|
|
|
browser will receive. Encrypted communications will fail if there are
|
2019-11-21 20:30:03 +01:00
|
|
|
mismatches in the host information between the request and the certificate on the server.
|
|
|
|
|
|
|
|
Configuring the `xpack.reporting.kibanaServer` settings to point to a
|
2020-05-04 17:22:40 +02:00
|
|
|
proxy host requires that the {kib} server has network access to the proxy.
|
2019-11-21 20:30:03 +01:00
|
|
|
====
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
|
|
|
| `xpack.reporting.kibanaServer.port`
|
|
|
|
| The port for accessing {kib}, if different from the `server.port` value.
|
|
|
|
|
|
|
|
| `xpack.reporting.kibanaServer.protocol`
|
|
|
|
| The protocol for accessing {kib}, typically `http` or `https`.
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
| `xpack.reporting.kibanaServer.hostname`
|
|
|
|
| The hostname for accessing {kib}, if different from the `server.host` value.
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
|===
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-01-09 18:13:22 +01:00
|
|
|
[NOTE]
|
|
|
|
============
|
|
|
|
Reporting authenticates requests on the Kibana page only when the hostname matches the
|
|
|
|
`xpack.reporting.kibanaServer.hostname` setting. Therefore Reporting would fail if the
|
|
|
|
set value redirects to another server. For that reason, `"0"` is an invalid setting
|
|
|
|
because, in the Reporting browser, it becomes an automatic redirect to `"0.0.0.0"`.
|
|
|
|
============
|
|
|
|
|
2018-11-16 18:08:58 +01:00
|
|
|
|
2018-04-20 21:13:37 +02:00
|
|
|
[float]
|
|
|
|
[[reporting-job-queue-settings]]
|
2019-02-11 17:17:25 +01:00
|
|
|
==== Background job settings
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
Reporting generates reports in the background and jobs are coordinated using documents
|
2020-05-04 17:22:40 +02:00
|
|
|
in {es}. Depending on how often you generate reports and the overall number of
|
2018-04-20 21:13:37 +02:00
|
|
|
reports, you might need to change the following settings.
|
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
|
|
|
| `xpack.reporting.queue.indexInterval`
|
|
|
|
| How often the index that stores reporting jobs rolls over to a new index.
|
|
|
|
Valid values are `year`, `month`, `week`, `day`, and `hour`. Defaults to `week`.
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
| `xpack.reporting.queue.pollEnabled` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Set to `true` (default) to enable the {kib} instance to to poll the index for
|
|
|
|
pending jobs and claim them for execution. Setting this to `false` allows the
|
|
|
|
{kib} instance to only add new jobs to the reporting queue, list jobs, and
|
|
|
|
provide the downloads to completed report through the UI.
|
|
|
|
|
|
|
|
|===
|
2018-10-24 17:03:54 +02:00
|
|
|
|
|
|
|
[NOTE]
|
|
|
|
============
|
2020-05-04 17:22:40 +02:00
|
|
|
Running multiple instances of {kib} in a cluster for load balancing of
|
2018-10-24 17:03:54 +02:00
|
|
|
reporting requires identical values for `xpack.reporting.encryptionKey` and, if
|
|
|
|
security is enabled, `xpack.security.encryptionKey`.
|
|
|
|
============
|
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
|
|
|
| `xpack.reporting.queue.pollInterval`
|
|
|
|
| Specifies the number of milliseconds that the reporting poller waits between polling the
|
|
|
|
index for any pending Reporting jobs. Defaults to `3000` (3 seconds).
|
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
| [[xpack-reporting-q-timeout]] `xpack.reporting.queue.timeout` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| 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.
|
|
|
|
If a Reporting job execution time goes over this time limit, the job will be
|
|
|
|
marked as a failure and there will not be a download available.
|
|
|
|
Defaults to `120000` (two minutes).
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
|===
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[reporting-capture-settings]]
|
2019-02-11 17:17:25 +01:00
|
|
|
==== Capture settings
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
Reporting works by capturing screenshots from {kib}. The following settings
|
2018-04-20 21:13:37 +02:00
|
|
|
control the capturing process.
|
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
2020-09-03 22:06:45 +02:00
|
|
|
a| `xpack.reporting.capture.timeouts`
|
|
|
|
`.openUrl` {ess-icon}
|
2020-05-15 00:23:15 +02:00
|
|
|
| Specify how long to allow the Reporting browser to wait for the "Loading..." screen
|
|
|
|
to dismiss and find the initial data for the Kibana page. If the time is
|
|
|
|
exceeded, a page screenshot is captured showing the current state, and the download link shows a warning message.
|
2020-08-18 22:26:31 +02:00
|
|
|
Defaults to `60000` (1 minute).
|
2020-05-04 17:22:40 +02:00
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
a| `xpack.reporting.capture.timeouts`
|
|
|
|
`.waitForElements` {ess-icon}
|
2020-05-15 00:23:15 +02:00
|
|
|
| Specify how long to allow the Reporting browser to wait for all visualization
|
|
|
|
panels to load on the Kibana page. If the time is exceeded, a page screenshot
|
|
|
|
is captured showing the current state, and the download link shows a warning message. Defaults to `30000` (30
|
|
|
|
seconds).
|
2020-03-06 06:26:36 +01:00
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
a| `xpack.reporting.capture.timeouts`
|
|
|
|
`.renderComplete` {ess-icon}
|
2020-05-15 00:23:15 +02:00
|
|
|
| Specify how long to allow the Reporting browser to wait for all visualizations to
|
|
|
|
fetch and render the data. If the time is exceeded, a
|
|
|
|
page screenshot is captured showing the current state, and the download link shows a warning message. Defaults to
|
|
|
|
`30000` (30 seconds).
|
2020-03-06 06:26:36 +01:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
|===
|
2020-03-06 06:26:36 +01:00
|
|
|
|
|
|
|
[NOTE]
|
|
|
|
============
|
|
|
|
If any timeouts from `xpack.reporting.capture.timeouts.*` settings occur when
|
|
|
|
running a report job, Reporting will log the error and try to continue
|
|
|
|
capturing the page with a screenshot. As a result, a download will be
|
|
|
|
available, but there will likely be errors in the visualizations in the report.
|
|
|
|
============
|
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
2020-09-03 22:06:45 +02:00
|
|
|
| `xpack.reporting.capture.maxAttempts` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| If capturing a report fails for any reason, {kib} will re-attempt other reporting
|
|
|
|
job, as many times as this setting. Defaults to `3`.
|
2019-09-05 08:10:49 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
| `xpack.reporting.capture.loadDelay`
|
|
|
|
| When visualizations are not evented, this is the amount of time before
|
|
|
|
taking a screenshot. All visualizations that ship with {kib} are evented, so this
|
|
|
|
setting should not have much effect. If you are seeing empty images instead of
|
|
|
|
visualizations, try increasing this value.
|
|
|
|
Defaults to `3000` (3 seconds).
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
| [[xpack-reporting-browser]] `xpack.reporting.capture.browser.type` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Specifies the browser to use to capture screenshots. This setting exists for
|
|
|
|
backward compatibility. The only valid option is `chromium`.
|
|
|
|
|
|
|
|
|===
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[reporting-chromium-settings]]
|
2019-02-11 17:17:25 +01:00
|
|
|
==== Chromium settings
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2018-12-04 17:43:59 +01:00
|
|
|
When `xpack.reporting.capture.browser.type` is set to `chromium` (default) you can also specify the following settings.
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
2020-09-03 22:06:45 +02:00
|
|
|
a| `xpack.reporting.capture.browser`
|
|
|
|
`.chromium.disableSandbox`
|
2020-05-04 17:22:40 +02:00
|
|
|
| It is recommended that you research the feasibility of enabling unprivileged user namespaces.
|
|
|
|
See Chromium Sandbox for additional information. Defaults to false for all operating systems except Debian,
|
|
|
|
Red Hat Linux, and CentOS which use true.
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
a| `xpack.reporting.capture.browser`
|
|
|
|
`.chromium.proxy.enabled`
|
2020-05-04 17:22:40 +02:00
|
|
|
| Enables the proxy for Chromium to use. When set to `true`, you must also specify the
|
|
|
|
`xpack.reporting.capture.browser.chromium.proxy.server` setting.
|
|
|
|
Defaults to `false`.
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
a| `xpack.reporting.capture.browser`
|
|
|
|
.chromium.proxy.server`
|
2020-05-04 17:22:40 +02:00
|
|
|
| The uri for the proxy server. Providing the username and password for the proxy server via the uri is not supported.
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-09-03 22:06:45 +02:00
|
|
|
a| `xpack.reporting.capture.browser`
|
|
|
|
.chromium.proxy.bypass`
|
2020-05-04 17:22:40 +02:00
|
|
|
| An array of hosts that should not go through the proxy server and should use a direct connection instead.
|
|
|
|
Examples of valid entries are "elastic.co", "*.elastic.co", ".elastic.co", ".elastic.co:5601".
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
|===
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[reporting-csv-settings]]
|
2019-02-11 17:17:25 +01:00
|
|
|
==== CSV settings
|
2020-05-04 17:22:40 +02:00
|
|
|
|
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
2020-09-03 22:06:45 +02:00
|
|
|
| [[xpack-reporting-csv]] `xpack.reporting.csv.maxSizeBytes` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| The maximum size of a CSV file before being truncated. This setting exists to prevent
|
|
|
|
large exports from causing performance and storage issues.
|
|
|
|
Defaults to `10485760` (10mB).
|
|
|
|
|
2020-07-02 19:07:48 +02:00
|
|
|
| `xpack.reporting.csv.scroll.size`
|
2020-09-03 22:06:45 +02:00
|
|
|
| Number of documents retrieved from {es} for each scroll iteration during a CSV
|
2020-07-02 19:07:48 +02:00
|
|
|
export.
|
|
|
|
Defaults to `500`.
|
|
|
|
|
|
|
|
| `xpack.reporting.csv.scroll.duration`
|
|
|
|
| Amount of time allowed before {kib} cleans the scroll context during a CSV export.
|
|
|
|
Defaults to `30s`.
|
2020-09-03 22:06:45 +02:00
|
|
|
|
2020-07-02 19:07:48 +02:00
|
|
|
| `xpack.reporting.csv.checkForFormulas`
|
|
|
|
| Enables a check that warns you when there's a potential formula involved in the output (=, -, +, and @ chars).
|
|
|
|
See OWASP: https://www.owasp.org/index.php/CSV_Injection
|
|
|
|
Defaults to `true`.
|
2020-09-03 22:06:45 +02:00
|
|
|
|
2020-07-02 19:07:48 +02:00
|
|
|
| `xpack.reporting.csv.enablePanelActionDownload`
|
2020-09-03 22:06:45 +02:00
|
|
|
| Enables CSV export from a saved search on a dashboard. This action is available in the dashboard
|
2020-07-02 19:07:48 +02:00
|
|
|
panel menu for the saved search.
|
|
|
|
Defaults to `true`.
|
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
|===
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[reporting-advanced-settings]]
|
2019-02-11 17:17:25 +01:00
|
|
|
==== Advanced settings
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
|
|
|
| `xpack.reporting.index`
|
|
|
|
| Reporting uses a weekly index in {es} to store the reporting job and
|
|
|
|
the report content. The index is automatically created if it does not already
|
|
|
|
exist. Configure this to a unique value, beginning with `.reporting-`, for every
|
|
|
|
{kib} instance that has a unique `kibana.index` setting. Defaults to `.reporting`.
|
|
|
|
|
|
|
|
| `xpack.reporting.roles.allow`
|
|
|
|
| Specifies the roles in addition to superusers that can use reporting.
|
|
|
|
Defaults to `[ "reporting_user" ]`. +
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
|===
|
2018-10-24 16:48:22 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[NOTE]
|
|
|
|
============
|
|
|
|
Each user has access to only their own reports.
|
|
|
|
============
|