Add information about HTTP API batch request size limits (#2453)

Author: markzegarelli

src/_includes/content/tracking-api-limit.md

@@ -0,0 +1,4 @@
+<div class="premonition warning"><div class="fa fa-exclamation-circle"></div><div class="content"><p class="header">HTTP Tracking API limits</p><p>Segment’s HTTP Tracking API accepts batch requests up to <strong>500kb</strong>. To avoid errors in event creation, ensure that individual event payload sizes remain below <strong>32kb</strong>.</p>
+
+
+</div></div>

src/connections/sources/catalog/libraries/server/go/index.md

@@ -378,6 +378,8 @@ By default, our library will flush:
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
 Sometimes you might not want batching (eg. when debugging, or in short-lived programs). You can turn off batching by setting the `FlushAt` argument to `1`, and your requests will always be sent right away.
 
 

src/connections/sources/catalog/libraries/server/go/v2/index.md

@@ -324,6 +324,9 @@ By default, our library will flush:
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
+
 Sometimes you might not want batching (eg. when debugging, or in short-lived programs). You can turn off batching by setting the `FlushAt` argument to `1`, and your requests will always be sent right away.
 
 

src/connections/sources/catalog/libraries/server/http-api/index.md

@@ -264,6 +264,9 @@ The `batch` method lets you send a series of `identify`, `group`, `track`, `page
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
+
 Here's the what the `batch` request signature looks like:
 
 ```

src/connections/sources/catalog/libraries/server/java/index.md

@@ -357,6 +357,9 @@ Every method you call **does not** result in an HTTP request, but is queued in m
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
+
 ## How do I flush right now?!
 
 You can also flush on demand. For example, at the end of your program, you'll want to flush to make sure there's nothing left in the queue. Just call the `flush` method:

src/connections/sources/catalog/libraries/server/net/index.md

@@ -400,6 +400,9 @@ By default (in async mode), this library starts a single seperate thread on init
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
+
 
 ### How do I turn batching off?
 

src/connections/sources/catalog/libraries/server/php/index.md

@@ -402,6 +402,9 @@ If your servers are handling more than 20 requests per second, you may want to l
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
+
 The lib-curl consumer is Segment's default PHP library, although you may still initialize it explicitly and set queue and batch sizes in the library's initialization settings.
 
 ```php

src/connections/sources/catalog/libraries/server/python/index.md

@@ -510,6 +510,9 @@ By default, our library will flush:
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
+
 ### What happens if there are just too many messages?
 
 If the module detects that it can't flush faster than it's receiving messages, it'll simply stop accepting messages. This means your program will never crash because of a backed up analytics queue. The default `max_queue_size` is `10000`.
@@ -678,7 +681,8 @@ If you're having issues with threads outliving your request, check [Background t
 
 ### Request Size Limits
 
-Keep in mind that we have a size limit of `32KB` per request and `500KB` per batch request!
+{% include content/tracking-api-limit.md %}
+
 
 {% include content/troubleshooting-intro.md %}
 {% include content/troubleshooting-server-debugger.md %}

src/connections/sources/catalog/libraries/server/ruby/index.md

@@ -414,6 +414,8 @@ By default, our library will flush:
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
 The queue consumer makes only **a single outbound request** at a time to avoid saturating your server's resources. If multiple messages are in the queue, they are sent together in a batch call.
 
 You can specify the following additional options to determine how the queue operates and to help debug possible errors. None of them are required for normal operation.

src/connections/sources/catalog/libraries/server/rust/index.md

@@ -377,6 +377,9 @@ leaving the flushing of Messages up to you to implement.
 
 There is a maximum of `500KB` per batch request and `32KB` per call.
 
+{% include content/tracking-api-limit.md %}
+
+
 ## Troubleshooting
 
 {% include content/troubleshooting-intro.md %}