From 843cc76ddaf7f9358fbd9c283b5b8a40b5e0ec6d Mon Sep 17 00:00:00 2001
From: Tim Sullivan <tsullivan@users.noreply.github.com>
Date: Fri, 16 Oct 2020 12:05:50 -0700
Subject: [PATCH] [Reporting] Add contextual documentation for CSV Max Bytes
 setting (#80782) (#80890) (#80899)

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

* Update reporting-settings.asciidoc

* updates per feedback
---
 docs/settings/reporting-settings.asciidoc | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/docs/settings/reporting-settings.asciidoc b/docs/settings/reporting-settings.asciidoc
index 8de3a48959fac..8c3d1ea8ab3ba 100644
--- a/docs/settings/reporting-settings.asciidoc
+++ b/docs/settings/reporting-settings.asciidoc
@@ -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]]
@@ -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"`.
@@ -215,7 +216,24 @@ a| `xpack.reporting.capture.browser`
 | [[xpack-reporting-csv]] `xpack.reporting.csv.maxSizeBytes` {ess-icon}
   | 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