Skip to content

Commit ff3c2e5

Browse files
committed
Change versions to Elastic stack
1 parent f42aae4 commit ff3c2e5

File tree

1 file changed

+14
-10
lines changed

1 file changed

+14
-10
lines changed

troubleshoot/ingest/opentelemetry/edot-collector/trace-export-errors.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -28,16 +28,17 @@ These errors indicate the Collector is overwhelmed and unable to export data fas
2828
This issue typically occurs when the `sending_queue` configuration or the Elasticsearch cluster scaling is misaligned with the incoming telemetry volume.
2929

3030
:::{important}
31-
The sending queue is disabled by default in versions earlier than **v0.138.0** and enabled by default from **v0.138.0** onward. If you're using an earlier version, verify that `enabled: true` is explicitly set — otherwise any queue configuration will be ignored.
31+
{applies_to}`stack: ga 9.0, deprecated 9.3`
32+
The sending queue is turned off by default. Verify that `enabled: true` is explicitly set — otherwise any queue configuration will be ignored.
3233
:::
3334

3435
Common contributing factors include:
3536

3637
* Underscaled Elasticsearch cluster is the most frequent cause of persistent export failures. If Elasticsearch cannot index data fast enough, the Collector’s queue fills up.
37-
* `sending_queue.block_on_overflow` is disabled in **pre-v0.138.0** releases (defaults to `false`), which can lead to silent data drops. Starting from **v0.138.0**, the Elasticsearch exporter enables this setting by default.
38-
* `num_consumers` is too low to keep up with the incoming data volume.
39-
* The queue size (`queue_size`) is too small for the traffic load.
40-
* Export batching is disabled, increasing processing overhead.
38+
* {applies_to}`stack: ga 9.0, deprecated 9.3` `sending_queue.block_on_overflow` is turned off (defaults to `false`), which can lead to data drops.
39+
* Sending queue is enabled but `num_consumers` is too low to keep up with the incoming data volume.
40+
* Sending queue size (`queue_size`) is too small for the traffic load.
41+
* Both internal and sending queue batching are disabled, increasing processing overhead.
4142
* EDOT Collector resources (CPU, memory) are insufficient for the traffic volume.
4243

4344
:::{note}
@@ -46,11 +47,12 @@ Increasing the `timeout` value (for example from 30s to 90s) doesn't help if the
4647

4748
## Resolution
4849

49-
The resolution approach depends on which EDOT Collector version you're using.
50+
The resolution approach depends on your {{stack}} version and Collector configuration.
5051

51-
### For EDOT Collector versions earlier than v0.138.0
52+
### When the sending queue is not enabled by default
53+
{applies_to}`stack: ga 9.0, deprecated 9.3`
5254

53-
Enable the sending queue and block on overflow to prevent silent data drops:
55+
Enable the sending queue and block on overflow to prevent data drops:
5456

5557
```yaml
5658
sending_queue:
@@ -60,7 +62,8 @@ sending_queue:
6062
block_on_overflow: true
6163
```
6264
63-
### For EDOT Collector v0.138.0 and later
65+
### When the sending queue is enabled by default
66+
{applies_to}`stack: ga 9.3`
6467

6568
The Elasticsearch exporter provides default `sending_queue` parameters (including `block_on_overflow: true`) but these can and often should be tuned for specific workloads.
6669

@@ -97,7 +100,8 @@ Address indexing delays, rejected bulk requests, or shard imbalances that limit
97100
:::::
98101

99102
:::{tip}
100-
For **v0.138.0+**, focus tuning efforts on Elasticsearch performance, Collector resource allocation, and queue sizing informed by the internal telemetry metrics above.
103+
{applies_to}`stack: ga 9.3`
104+
Focus tuning efforts on {{es}} performance, Collector resource allocation, and queue sizing informed by the internal telemetry metrics above.
101105
:::
102106

103107

0 commit comments

Comments
 (0)