From 262841bcbfef2d584518095b60ecab370ff0c37f Mon Sep 17 00:00:00 2001 From: Faried Fauzi Date: Mon, 16 Nov 2026 11:50:21 +0100 Subject: [PATCH 1/2] Document CDC Kafka producer metrics --- .../integration/change-data-capture/_index.md | 1 + content/en/docs/refguide/runtime/metrics.md | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+) diff --git a/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md b/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md index d20f949056b..2036da980bd 100644 --- a/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md +++ b/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md @@ -103,3 +103,4 @@ For details on setting up a BYOK cluster with the Mendix Event Broker, see [Mend * [Published CDC Services](/refguide/published-cdc-services/) * [Mendix Event Broker](/appstore/services/event-broker/) * [Event Broker Bridges](/appstore/services/event-broker-bridges/) +* [Change Data Capture Producer Metrics](/refguide/metrics/#cdc-producer-metrics) diff --git a/content/en/docs/refguide/runtime/metrics.md b/content/en/docs/refguide/runtime/metrics.md index 7ac378dee53..ea322f0a516 100644 --- a/content/en/docs/refguide/runtime/metrics.md +++ b/content/en/docs/refguide/runtime/metrics.md @@ -454,6 +454,25 @@ Note that the actual name may vary slightly depending on the back end (for examp Additionally, a suffix may be added for the unit of the metric (for example, `_bytes`). {{% /alert %}} +#### Change Data Capture Producer Metrics {#cdc-producer-metrics} + +Starting with Mendix 11.17, [Change Data Capture (CDC)](/refguide/change-data-capture/) exposes the following Kafka producer metrics as gauges. +They register automatically after the producer initializes successfully. You do not need a microflow or Java action to register them. +These metrics describe the producer client as a whole, not individual topics. + +| Name | Unit | Description | +| --- | --- | --- | +| `mx.cdc.producer.kafka.batch_size_avg` | Bytes | Average number of bytes sent per partition per request. | +| `mx.cdc.producer.kafka.batch_size_max` | Bytes | Maximum number of bytes sent per partition per request. | +| `mx.cdc.producer.kafka.records_per_request_avg` | Records per request | Average number of records sent per request. | +| `mx.cdc.producer.kafka.record_queue_time_avg` | Milliseconds | Average time record batches spend in the producer's send buffer. | +| `mx.cdc.producer.kafka.record_send_rate` | Records per second | Average number of records sent per second. | +| `mx.cdc.producer.kafka.request_latency_avg` | Milliseconds | Average Kafka producer request latency. | +| `mx.cdc.producer.kafka.buffer_available_bytes` | Bytes | Buffer memory available to the producer. | + +A gauge can report `NaN` when its value is unavailable or cannot be read. +The gauges read current Kafka client values, including after the client is recreated. + ### Additional Metrics {{% alert color="info" %}} From 653792e283750221c5d9b9d8e6e5c4c2a7f4ee55 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Tue, 17 Nov 2026 16:28:46 +0100 Subject: [PATCH 2/2] Review --- content/en/docs/refguide/runtime/metrics.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/refguide/runtime/metrics.md b/content/en/docs/refguide/runtime/metrics.md index ea322f0a516..c9bd6995e9d 100644 --- a/content/en/docs/refguide/runtime/metrics.md +++ b/content/en/docs/refguide/runtime/metrics.md @@ -456,8 +456,8 @@ Additionally, a suffix may be added for the unit of the metric (for example, `_b #### Change Data Capture Producer Metrics {#cdc-producer-metrics} -Starting with Mendix 11.17, [Change Data Capture (CDC)](/refguide/change-data-capture/) exposes the following Kafka producer metrics as gauges. -They register automatically after the producer initializes successfully. You do not need a microflow or Java action to register them. +As of Studio Pro 11.17, [Change Data Capture (CDC)](/refguide/change-data-capture/) exposes the following Kafka producer metrics as gauges. They register automatically after the producer initializes successfully. You do not need a microflow or Java action to register them. + These metrics describe the producer client as a whole, not individual topics. | Name | Unit | Description |