Skip to content

Commit 3797b6f

Browse files
committed
Incorporate feedback from Support
1 parent a52f1b3 commit 3797b6f

File tree

3 files changed

+7
-5
lines changed

3 files changed

+7
-5
lines changed

modules/develop/pages/transactions.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -270,7 +270,7 @@ Redpanda’s default configuration supports exactly-once processing. To preserve
270270

271271
To help avoid common pitfalls and optimize performance, consider the following when configuring transactional workloads in Redpanda:
272272

273-
* If a consumer is configured to process only messages from successfully committed transactions, an ongoing transaction with a large timeout that becomes stuck might block consumers from processing more committed transactions. This prevents consumers from advancing their offsets and potentially causes backlogs.
273+
* If a consumer is configured to use the read_committed isolation level, it can only process successfully committed transactions. As a result, an ongoing transaction with a large timeout that becomes stuck could prevent the consumer from processing other committed transactions.
274274
+
275275
To avoid this, don't set the transaction timeout client setting (`transaction.timeout.ms` in the Kafka Java client implementation) to a value that is too high. The longer the timeout, the longer consumers may be blocked.
276276
ifndef::env-cloud[]

modules/manage/pages/cluster-maintenance/disk-utilization.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -165,21 +165,21 @@ Redpanda supports group offset deletion with the Kafka OffsetDelete API through
165165

166166
== Manage transaction coordinator disk usage
167167

168-
Redpanda uses the internal topic `kafka_internal/tx` to store transaction metadata for exactly-once and transactional producers. Over time, this topic can consume excessive disk space in niche use cases that generate a large number of transactional sessions.
168+
Redpanda uses the internal topic `kafka_internal/tx` to store transaction metadata for exactly-once and transactional producers. The log files contain all historical transactions, both committed and current open ones. Over time, this topic can consume excessive disk space in niche use cases that generate a large number of transactional sessions.
169169

170170
You can manage the disk usage of `kafka_internal/tx` by tuning the following cluster properties:
171171

172172
* config_ref:transaction_coordinator_delete_retention_ms,true,properties/cluster-properties[`transaction_coordinator_delete_retention_ms`]. Default: `604800000` (7 days).
173173
* config_ref:transactional_id_expiration_ms,true,properties/cluster-properties[`transactional_id_expiration_ms`]. Default: `604800000` (7 days).
174174

175-
To mitigate unbounded growth of `kafka_internal/tx` disk usage and manage its storage consumption more effectively, <<monitor-disk-space,monitor your storage metrics>> and lower the values of the relevant properties as needed.
175+
To mitigate unbounded growth of `kafka_internal/tx` disk usage and manage its storage consumption more effectively, <<monitor-disk-space,monitor your storage metrics>> and lower the values of the relevant properties as needed.
176176

177177
To adjust these properties, run:
178178

179179
[,bash]
180180
----
181181
rpk cluster config set transaction_coordinator_delete_retention_ms=<milliseconds> transactional_id_expiration_ms=<milliseconds>
182-
----
182+
----
183183

184184
== Configure segment size
185185

modules/reference/pages/properties/cluster-properties.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6259,7 +6259,9 @@ Cleanup policy for a transaction coordinator topic.
62596259

62606260
=== transaction_coordinator_delete_retention_ms
62616261

6262-
Delete segments older than this age. To ensure transaction state is retained as long as the longest-running transaction, make sure this is no less than <<transactional_id_expiration_ms,`transactional_id_expiration_ms`>>.
6262+
Delete segments older than this age. To ensure transaction state is retained for as long as the longest-running transaction, make sure this is greater than or equal to <<transactional_id_expiration_ms,`transactional_id_expiration_ms`>>.
6263+
6264+
For example, if your typical transactions run for one hour, consider setting both `transaction_coordinator_delete_retention_ms` and `transactional_id_expiration_ms` to at least 3600000 (one hour), or a little over.
62636265

62646266
*Unit:* milliseconds
62656267

0 commit comments

Comments
 (0)