Merge pull request #2455 from segmentio/develop

Release 22.5.2

Author: stayseesong

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/_includes/content/troubleshooting-server-debugger.md

@@ -3,3 +3,5 @@
 1. Double check that you've followed all the steps in the [Quickstart](quickstart/).
 
 2. Make sure that you're calling one of our API methods once the library is successfully installed—[`identify`](#identify), [`track`](#track), etc.
+
+3. Make sure your application isn't shutting down before the `Analytics.Client` local queue events are pushed to Segemet. You can manually call `Analytics.Client.Flush()` to ensure the queue is fully processed before shutdown.

src/_includes/menu/menu-source.html

@@ -36,11 +36,13 @@
               {% assign integrations = site.data.catalog.sources.items | where: "categories", category %}
 
               {% for integration in integrations %}
+              {% unless integration.hidden %}
                 <li class="menu-item menu-item--compact">
                   <a href="{{ site.baseurl }}/{{ integration.url }}/" class="menu-item__link">
                     {{ integration.display_name }}
                   </a>
                 </li>
+                {% endunless %}
               {% endfor %}
             </ul>
           </li>
@@ -61,7 +63,7 @@
             {% assign integrations = site.data.catalog.sources.items %}
 
             {% for integration in integrations %}
-              {% unless integration.categories contains promoted_categories[0] or integration.categories contains promoted_categories[1] or integration.categories contains promoted_categories[2] or integration.categories contains promoted_categories[3] %}
+              {% unless integration.categories contains promoted_categories[0] or integration.categories contains promoted_categories[1] or integration.categories contains promoted_categories[2] or integration.categories contains promoted_categories[3] or integration.hidden%}
                 <li class="menu-item menu-item--compact">
                   <a href="{{ site.baseurl }}/{{ integration.url }}/" class="menu-item__link">
                     {{ integration.display_name }}

src/connections/sources/catalog/cloud-apps/intercom/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/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/go/v2/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/http-api/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/java/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/net/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