diff --git a/antora.yml b/antora.yml index 2d617a50c6..a7d65438d4 100644 --- a/antora.yml +++ b/antora.yml @@ -17,8 +17,8 @@ asciidoc: # Fallback versions # We try to fetch the latest versions from GitHub at build time # -- - full-version: 26.1.1 - latest-redpanda-tag: 'v26.1.1' + full-version: 26.1.2 + latest-redpanda-tag: 'v26.1.2' latest-console-tag: 'v3.3.1' latest-release-commit: '35a825c9c1880ebeedf4c18bb8c6cceaa63566c1' latest-operator-version: 'v2.3.8-24.3.6' diff --git a/docs-data/property-overrides.json b/docs-data/property-overrides.json index a13c840587..ff2493fc8d 100644 --- a/docs-data/property-overrides.json +++ b/docs-data/property-overrides.json @@ -775,7 +775,7 @@ "config_scope": "cluster" }, "default_redpanda_storage_mode": { - "description": "Set the default storage mode for new topics. This value applies to any topic created without an explicit <> setting (that is, when the topic's `redpanda.storage.mode` is `unset`).\n\nAccepted values:\n\n* `unset`: Defer to the legacy <> and <> topic properties for Tiered Storage configuration.\n* `local`: Store data only on local disks, with no object storage involvement.\n* `tiered`: Store data on local disks and replicate it to object storage using Tiered Storage. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`.\n* `cloud`: Store data primarily in object storage using Cloud Topics.", + "description": "Set the default storage mode for new topics. This value applies to any topic created without an explicit <> setting (that is, when the topic's `redpanda.storage.mode` is `unset`).\n\nAccepted values:\n\n* `unset`: Defer to the legacy <> and <> topic properties for Tiered Storage configuration.\n* `local`: Store data only on local disks, with no object storage involvement.\nifndef::env-cloud[]\n* `tiered`: Store data on local disks and replicate it to object storage using xref:manage:tiered-storage.adoc[Tiered Storage]. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`.\n* `cloud`: Store data primarily in object storage using xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics].\nendif::[]\nifdef::env-cloud[]\n* `tiered`: Store data on local disks and replicate it to object storage using Tiered Storage. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`.\n* `cloud`: Store data primarily in object storage using Cloud Topics.\nendif::[]", "related_topics": [ "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]", "self-managed-only: xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics]" @@ -1092,14 +1092,14 @@ "config_scope": "topic" }, "initial_retention_local_target_bytes_default": { - "description": "Initial local retention size target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica set.", + "description": "ifndef::env-cloud[]\nInitial local retention size target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]\nifdef::env-cloud[]\nInitial local retention size target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]", "related_topics": [ "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]" ], "config_scope": "cluster" }, "initial_retention_local_target_ms_default": { - "description": "Initial local retention time target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.", + "description": "ifndef::env-cloud[]\nInitial local retention time target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]\nifdef::env-cloud[]\nInitial local retention time target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]", "related_topics": [ "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]" ], @@ -1296,6 +1296,12 @@ "description": "Leadership rebalancing idle timeout.\n\n*Unit*: milliseconds", "config_scope": "cluster" }, + "leader_balancer_mode": { + "_comment": "greedy mode excluded from docs - internal use only (added in v26.1.2)", + "description": "Mode of the leader balancer optimization strategy.\n\nAccepted values:\n\n* `calibrated` (default): An adaptive strategy that samples potential moves and prioritizes high-impact transfers. Minimizes unnecessary leader movement while achieving balance over time. Best for most production workloads.\n* `random`: Accepts the first random move that improves balance. Less efficient than `calibrated` because it doesn't prioritize high-impact moves. Available as a fallback if `calibrated` causes unexpected behavior.\n\nLegacy values `greedy_balanced_shards` and `random_hill_climbing` are treated as `calibrated`.", + "accepted_values": ["calibrated", "random"], + "config_scope": "cluster" + }, "leader_balancer_mute_timeout": { "description": "The length of time that a glossterm:Raft[] group is muted after a leadership rebalance operation. Any group that has been moved, regardless of whether the move succeeded or failed, undergoes a cooling-off period. This prevents Raft groups from repeatedly experiencing leadership rebalance operations in a short time frame, which can lead to instability in the cluster.\n\nThe leader balancer maintains a list of muted groups and reevaluates muted status at the start of each balancing iteration. Muted groups still contribute to overall cluster balance calculations although they can't themselves be moved until the mute period is over.", "config_scope": "cluster" @@ -1795,7 +1801,7 @@ "config_scope": "topic" }, "redpanda.storage.mode": { - "description": "The storage mode for a topic. Determines how topic data is stored and whether it is eligible for upload to object storage.\n\nAccepted values:\n\n* `local`: Topic data is stored only on the broker's local disk. Object storage upload is disabled for the topic, regardless of cluster-level Tiered Storage settings.\n* `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables Tiered Storage for the topic.\n* `cloud`: Topic data is stored in object storage using the Cloud Topics architecture. Local storage is used only as a write buffer.\n* `unset`: Specifies that the topic's storage mode is unset, regardless of the cluster default. The topic may still have Tiered Storage enabled through the legacy properties `redpanda.remote.read` and `redpanda.remote.write`.\n\nThis property overrides the cluster-wide config_ref:default_redpanda_storage_mode,true,properties/cluster-properties[] setting for individual topics.", + "description": "The storage mode for a topic. Determines how topic data is stored and whether it is eligible for upload to object storage.\n\nAccepted values:\n\n* `local`: Topic data is stored only on the broker's local disk. Object storage upload is disabled for the topic, regardless of cluster-level Tiered Storage settings.\nifndef::env-cloud[]\n* `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables xref:manage:tiered-storage.adoc[Tiered Storage] for the topic.\n* `cloud`: Topic data is stored in object storage using the xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics] architecture. Local storage is used only as a write buffer.\nendif::[]\nifdef::env-cloud[]\n* `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables Tiered Storage for the topic.\n* `cloud`: Topic data is stored in object storage using the Cloud Topics architecture. Local storage is used only as a write buffer.\nendif::[]\n* `unset`: Specifies that the topic's storage mode is unset, regardless of the cluster default. The topic may still have Tiered Storage enabled through the legacy properties `redpanda.remote.read` and `redpanda.remote.write`.\n\nThis property overrides the cluster-wide config_ref:default_redpanda_storage_mode,true,properties/cluster-properties[] setting for individual topics.", "related_topics": [ "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]", "self-managed-only: xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics]" @@ -2261,4 +2267,4 @@ "description": "The default write caching mode to apply to user topics. Write caching acknowledges a message as soon as it is received and acknowledged on a majority of brokers, without waiting for it to be written to disk. With `acks=all`, this provides lower latency while still ensuring that a majority of brokers acknowledge the write. \n\nFsyncs follow <> and <>, whichever is reached first.\n\nThe `write_caching_default` cluster property can be overridden with the xref:reference:properties/topic-properties.adoc#writecaching[`write.caching`] topic property." } } -} +} \ No newline at end of file diff --git a/docs-data/redpanda-property-changes-v26.1.1-to-v26.1.1-rc5.json b/docs-data/redpanda-property-changes-v26.1.1-to-v26.1.2.json similarity index 81% rename from docs-data/redpanda-property-changes-v26.1.1-to-v26.1.1-rc5.json rename to docs-data/redpanda-property-changes-v26.1.1-to-v26.1.2.json index 0f0d4b108b..35219831fe 100644 --- a/docs-data/redpanda-property-changes-v26.1.1-to-v26.1.1-rc5.json +++ b/docs-data/redpanda-property-changes-v26.1.1-to-v26.1.2.json @@ -1,8 +1,8 @@ { "comparison": { "oldVersion": "v26.1.1", - "newVersion": "v26.1.1-rc5", - "timestamp": "2026-03-31T14:37:03.774Z" + "newVersion": "v26.1.2", + "timestamp": "2026-04-03T17:46:32.769Z" }, "summary": { "newProperties": 0, @@ -10,6 +10,7 @@ "changedDescriptions": 0, "changedTypes": 0, "deprecatedProperties": 0, + "removedDeprecatedProperties": 0, "removedProperties": 0, "emptyDescriptions": 2 }, @@ -19,6 +20,7 @@ "changedDescriptions": [], "changedTypes": [], "deprecatedProperties": [], + "removedDeprecatedProperties": [], "removedProperties": [], "emptyDescriptions": [ { diff --git a/modules/reference/attachments/redpanda-properties-v26.1.1-rc5.json b/modules/reference/attachments/redpanda-properties-v26.1.2.json similarity index 99% rename from modules/reference/attachments/redpanda-properties-v26.1.1-rc5.json rename to modules/reference/attachments/redpanda-properties-v26.1.2.json index f72db52b73..76ea8f7035 100644 --- a/modules/reference/attachments/redpanda-properties-v26.1.1-rc5.json +++ b/modules/reference/attachments/redpanda-properties-v26.1.2.json @@ -240,10 +240,12 @@ "defined_in": "model/metadata.h", "enum": [ "calibrated", - "random" + "random", + "greedy" ], "enum_string_mappings": { "calibrated": "calibrated", + "greedy": "greedy", "random": "random" }, "type": "enum" @@ -3388,7 +3390,7 @@ "needs_restart": true, "nullable": false, "related_topics": [ - "xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics]" + "self-managed-only: xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics]" ], "type": "boolean", "visibility": "user" @@ -5496,7 +5498,7 @@ "config_scope": "cluster", "default": "unset", "defined_in": "src/v/config/configuration.cc", - "description": "Set the default storage mode for new topics. This value applies to any topic created without an explicit <> setting (that is, when the topic's `redpanda.storage.mode` is `unset`).\n\nAccepted values:\n\n* `unset`: Defer to the legacy <> and <> topic properties for Tiered Storage configuration.\n* `local`: Store data only on local disks, with no object storage involvement.\n* `tiered`: Store data on local disks and replicate it to object storage using xref:manage:tiered-storage.adoc[Tiered Storage]. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`.\n* `cloud`: Store data primarily in object storage using xref:manage:tiered-storage.adoc#cloud-topics[cloud topics].", + "description": "Set the default storage mode for new topics. This value applies to any topic created without an explicit <> setting (that is, when the topic's `redpanda.storage.mode` is `unset`).\n\nAccepted values:\n\n* `unset`: Defer to the legacy <> and <> topic properties for Tiered Storage configuration.\n* `local`: Store data only on local disks, with no object storage involvement.\nifndef::env-cloud[]\n* `tiered`: Store data on local disks and replicate it to object storage using xref:manage:tiered-storage.adoc[Tiered Storage]. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`.\n* `cloud`: Store data primarily in object storage using xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics].\nendif::[]\nifdef::env-cloud[]\n* `tiered`: Store data on local disks and replicate it to object storage using Tiered Storage. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`.\n* `cloud`: Store data primarily in object storage using Cloud Topics.\nendif::[]", "enum": [ "local", "tiered", @@ -5510,8 +5512,8 @@ "needs_restart": false, "nullable": false, "related_topics": [ - "xref:manage:tiered-storage.adoc[Tiered Storage]", - "xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics]" + "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]", + "self-managed-only: xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics]" ], "type": "string", "version": "v26.1.1", @@ -7577,14 +7579,14 @@ "config_scope": "cluster", "default": null, "defined_in": "src/v/config/configuration.cc", - "description": "Initial local retention size target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica set.", + "description": "ifndef::env-cloud[]\nInitial local retention size target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]\nifdef::env-cloud[]\nInitial local retention size target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]", "is_deprecated": false, "is_enterprise": false, "name": "initial_retention_local_target_bytes_default", "needs_restart": false, "nullable": true, "related_topics": [ - "xref:manage:tiered-storage.adoc[Tiered Storage]" + "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]" ], "type": "integer", "visibility": "user" @@ -7598,7 +7600,7 @@ "config_scope": "cluster", "default": null, "defined_in": "src/v/config/configuration.cc", - "description": "Initial local retention time target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica is set.", + "description": "ifndef::env-cloud[]\nInitial local retention time target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]\nifdef::env-cloud[]\nInitial local retention time target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set.\nendif::[]", "is_deprecated": false, "is_enterprise": false, "maximum": 17592186044415, @@ -7607,7 +7609,7 @@ "needs_restart": false, "nullable": true, "related_topics": [ - "xref:manage:tiered-storage.adoc[Tiered Storage]" + "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]" ], "type": "integer", "visibility": "user" @@ -8698,7 +8700,7 @@ "config_scope": "cluster", "default": "calibrated", "defined_in": "src/v/config/configuration.cc", - "description": "Mode of the leader balancer optimization strategy. `calibrated` uses a heuristic that balances leaders based on replica counts per shard. `random` randomly moves leaders to reduce load on heavily-loaded shards. Legacy values `greedy_balanced_shards` and `random_hill_climbing` are treated as `calibrated`.", + "description": "Mode of the leader balancer optimization strategy.\n\nAccepted values:\n\n* `calibrated` (default): An adaptive strategy that samples potential moves and prioritizes high-impact transfers. Minimizes unnecessary leader movement while achieving balance over time. Best for most production workloads.\n* `random`: Accepts the first random move that improves balance. Less efficient than `calibrated` because it doesn't prioritize high-impact moves. Available as a fallback if `calibrated` causes unexpected behavior.\n\nLegacy values `greedy_balanced_shards` and `random_hill_climbing` are treated as `calibrated`.", "enum": [ "calibrated", "random" @@ -11254,8 +11256,8 @@ "is_topic_property": true, "name": "redpanda.cloud_topic.enabled", "related_topics": [ - "xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics]", - "xref:manage:tiered-storage.adoc[Tiered Storage]" + "self-managed-only: xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics]", + "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]" ], "type": "string", "visibility": "user" @@ -11423,6 +11425,11 @@ "default": "TopicNameStrategy", "defined_in": "src/v/kafka/server/handlers/topics/types.h", "description": "The subject name strategy for keys when `redpanda.key.schema.id.validation` is enabled. This determines how the topic and schema are mapped to a subject name in the Schema Registry.", + "enum": [ + "TopicNameStrategy", + "RecordNameStrategy", + "TopicRecordNameStrategy" + ], "is_deprecated": false, "is_enterprise": false, "is_topic_property": true, @@ -11620,7 +11627,7 @@ "corresponding_cluster_property": "default_redpanda_storage_mode", "default": "unset", "defined_in": "src/v/kafka/protocol/topic_properties.h", - "description": "The storage mode for a topic. Determines how topic data is stored and whether it is eligible for upload to object storage.\n\nAccepted values:\n\n* `local`: Topic data is stored only on the broker's local disk. Object storage upload is disabled for the topic, regardless of cluster-level Tiered Storage settings.\n* `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables xref:manage:tiered-storage.adoc[Tiered Storage] for the topic.\n* `cloud`: Topic data is stored in object storage using the glossterm:Cloud Topic[,Cloud Topics] architecture. Local storage is used only as a write buffer.\n* `unset`: Specifies that the topic's storage mode is unset, regardless of the cluster default. The topic may still have Tiered Storage enabled through the legacy properties `redpanda.remote.read` and `redpanda.remote.write`.\n\nThis property overrides the cluster-wide config_ref:default_redpanda_storage_mode,true,properties/cluster-properties[] setting for individual topics.", + "description": "The storage mode for a topic. Determines how topic data is stored and whether it is eligible for upload to object storage.\n\nAccepted values:\n\n* `local`: Topic data is stored only on the broker's local disk. Object storage upload is disabled for the topic, regardless of cluster-level Tiered Storage settings.\nifndef::env-cloud[]\n* `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables xref:manage:tiered-storage.adoc[Tiered Storage] for the topic.\n* `cloud`: Topic data is stored in object storage using the xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics] architecture. Local storage is used only as a write buffer.\nendif::[]\nifdef::env-cloud[]\n* `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables Tiered Storage for the topic.\n* `cloud`: Topic data is stored in object storage using the Cloud Topics architecture. Local storage is used only as a write buffer.\nendif::[]\n* `unset`: Specifies that the topic's storage mode is unset, regardless of the cluster default. The topic may still have Tiered Storage enabled through the legacy properties `redpanda.remote.read` and `redpanda.remote.write`.\n\nThis property overrides the cluster-wide config_ref:default_redpanda_storage_mode,true,properties/cluster-properties[] setting for individual topics.", "enum": [ "local", "tiered", @@ -11633,8 +11640,8 @@ "name": "redpanda.storage.mode", "needs_restart": false, "related_topics": [ - "xref:manage:tiered-storage.adoc[Tiered Storage]", - "xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics]" + "self-managed-only: xref:manage:tiered-storage.adoc[Tiered Storage]", + "self-managed-only: xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics]" ], "type": "string", "version": "v26.1.1" diff --git a/modules/reference/partials/properties/cluster-properties.adoc b/modules/reference/partials/properties/cluster-properties.adoc index f1fee64386..02dbd9e589 100644 --- a/modules/reference/partials/properties/cluster-properties.adoc +++ b/modules/reference/partials/properties/cluster-properties.adoc @@ -4937,7 +4937,7 @@ Accepted values: * `local`: Store data only on local disks, with no object storage involvement. ifndef::env-cloud[] * `tiered`: Store data on local disks and replicate it to object storage using xref:manage:tiered-storage.adoc[Tiered Storage]. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`. -* `cloud`: Store data primarily in object storage using xref:manage:tiered-storage.adoc#cloud-topics[cloud topics]. +* `cloud`: Store data primarily in object storage using xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics]. endif::[] ifdef::env-cloud[] * `tiered`: Store data on local disks and replicate it to object storage using Tiered Storage. Equivalent to setting `redpanda.remote.read` and `redpanda.remote.write` to `true`. @@ -4990,9 +4990,9 @@ endif::[] | `tiered` +ifndef::env-cloud[] | Related topics | -ifndef::env-cloud[] * xref:manage:tiered-storage.adoc[Tiered Storage] * xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics] @@ -8015,7 +8015,6 @@ endif::[] // end::redpanda-cloud[] -// tag::redpanda-cloud[] === iceberg_rest_catalog_aws_credentials_source *Accepted values*: `aws_instance_metadata`, `azure_aks_oidc_federation`, `azure_vm_instance_metadata`, `config_file`, `gcp_instance_metadata`, `sts`. @@ -8076,7 +8075,6 @@ endif::[] |=== -// end::redpanda-cloud[] // tag::redpanda-cloud[] === iceberg_rest_catalog_aws_region @@ -9173,10 +9171,10 @@ endif::[] === initial_retention_local_target_bytes_default ifndef::env-cloud[] -Initial local retention size target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica set. +Initial local retention size target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set. endif::[] ifdef::env-cloud[] -Initial local retention size target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica set. +Initial local retention size target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set. endif::[] [cols="1s,2a"] @@ -9224,10 +9222,10 @@ endif::[] === initial_retention_local_target_ms_default ifndef::env-cloud[] -Initial local retention time target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica is set. +Initial local retention time target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set. endif::[] ifdef::env-cloud[] -Initial local retention time target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica is set. +Initial local retention time target for partitions of topics with Tiered Storage enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to the learner when joining the partition replica set. endif::[] [cols="1s,2a"] @@ -11505,7 +11503,14 @@ endif::[] === leader_balancer_mode -Mode of the leader balancer optimization strategy. `calibrated` uses a heuristic that balances leaders based on replica counts per shard. `random` randomly moves leaders to reduce load on heavily-loaded shards. Legacy values `greedy_balanced_shards` and `random_hill_climbing` are treated as `calibrated`. +Mode of the leader balancer optimization strategy. + +Accepted values: + +* `calibrated` (default): An adaptive strategy that samples potential moves and prioritizes high-impact transfers. Minimizes unnecessary leader movement while achieving balance over time. Best for most production workloads. +* `random`: Accepts the first random move that improves balance. Less efficient than `calibrated` because it doesn't prioritize high-impact moves. Available as a fallback if `calibrated` causes unexpected behavior. + +Legacy values `greedy_balanced_shards` and `random_hill_climbing` are treated as `calibrated`. [cols="1s,2a"] |=== diff --git a/modules/reference/partials/properties/topic-properties.adoc b/modules/reference/partials/properties/topic-properties.adoc index 2f599a9cb3..80491397af 100644 --- a/modules/reference/partials/properties/topic-properties.adoc +++ b/modules/reference/partials/properties/topic-properties.adoc @@ -977,9 +977,9 @@ ifndef::env-cloud[] | Yes endif::[] +ifndef::env-cloud[] | Related topics | -ifndef::env-cloud[] * xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics] * xref:manage:tiered-storage.adoc[Tiered Storage] @@ -1241,8 +1241,16 @@ The subject name strategy for keys when `redpanda.key.schema.id.validation` is e | Property | Value | Type -| `string` +| `string` (enum) +| Accepted Values +| +ifndef::env-cloud[] +`TopicNameStrategy`, `RecordNameStrategy`, `TopicRecordNameStrategy` +endif::[] +ifdef::env-cloud[] +`TopicNameStrategy`, `RecordNameStrategy`, `TopicRecordNameStrategy` +endif::[] | Default @@ -1569,7 +1577,7 @@ Accepted values: * `local`: Topic data is stored only on the broker's local disk. Object storage upload is disabled for the topic, regardless of cluster-level Tiered Storage settings. ifndef::env-cloud[] * `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables xref:manage:tiered-storage.adoc[Tiered Storage] for the topic. -* `cloud`: Topic data is stored in object storage using the glossterm:Cloud Topic[,Cloud Topics] architecture. Local storage is used only as a write buffer. +* `cloud`: Topic data is stored in object storage using the xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics] architecture. Local storage is used only as a write buffer. endif::[] ifdef::env-cloud[] * `tiered`: Topic data is stored on local disk and also uploaded to object storage. Enables Tiered Storage for the topic. @@ -1616,9 +1624,9 @@ ifndef::env-cloud[] | Yes endif::[] +ifndef::env-cloud[] | Related topics | -ifndef::env-cloud[] * xref:manage:tiered-storage.adoc[Tiered Storage] * xref:develop:manage-topics/cloud-topics.adoc[Manage Cloud Topics]