Skip to content

Commit

Permalink
[Reporting] Add contextual documentation for CSV Max Bytes setting (#…
Browse files Browse the repository at this point in the history
…80782) (#80890) (#80900)

* [Reporting] Add contextual documentation for CSV Max Bytes setting

* Update reporting-settings.asciidoc

* updates per feedback
  • Loading branch information
tsullivan authored Oct 16, 2020
1 parent 2a459c4 commit 98f4c85
Showing 1 changed file with 20 additions and 2 deletions.
22 changes: 20 additions & 2 deletions docs/settings/reporting-settings.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ You can configure `xpack.reporting` settings in your `kibana.yml` to:
* <<reporting-kibana-server-settings,Control how the {report-features} communicate with the {kib} server>>
* <<reporting-job-queue-settings,Manage background jobs>>
* <<reporting-capture-settings,Capture screenshots>>
* <<reporting-csv-settings,Increase the byte limit for CSV exports>>

[float]
[[general-reporting-settings]]
Expand Down Expand Up @@ -65,7 +66,7 @@ proxy host requires that the {kib} server has network access to the proxy.

[NOTE]
============
Reporting authenticates requests on the Kibana page only when the hostname matches the
Reporting authenticates requests on the {kib} 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"`.
Expand Down Expand Up @@ -176,7 +177,24 @@ When `xpack.reporting.capture.browser.type` is set to `chromium` (default) you c
| [[xpack-reporting-csv]] `xpack.reporting.csv.maxSizeBytes`
| 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).
Defaults to `10485760` (10 MB).
|===

[NOTE]
============
Setting `xpack.reporting.csv.maxSizeBytes` much larger than the default 10 MB limit has the potential to negatively affect the
performance of {kib} and your {es} cluster. There is no enforced maximum for this setting, but a reasonable maximum value depends
on multiple factors:
* The `http.max_content_length` setting in {es}.
* Network proxies, which are often configured by default to block large requests with a 413 error.
* The amount of memory available to the {kib} server, which limits the size of CSV data that must be held temporarily.
For information about {kib} memory limits, see <<production, using {kib} in a production environment>>.
============

[cols="2*<"]
|===

| `xpack.reporting.csv.scroll.size`
| Number of documents retrieved from {es} for each scroll iteration during a CSV
Expand Down

0 comments on commit 98f4c85

Please sign in to comment.