You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by ur...@apache.org on 2022/10/11 06:17:37 UTC

[pulsar-site] branch main updated: Docs sync done from apache/pulsar(#252eded)

This is an automated email from the ASF dual-hosted git repository.

urfree pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git


The following commit(s) were added to refs/heads/main by this push:
     new ae8fabf736d Docs sync done from apache/pulsar(#252eded)
ae8fabf736d is described below

commit ae8fabf736d5790cf1bf9b7354c0142d00aac23e
Author: Pulsar Site Updater <de...@pulsar.apache.org>
AuthorDate: Tue Oct 11 06:17:32 2022 +0000

    Docs sync done from apache/pulsar(#252eded)
---
 site2/website-next/docs/concepts-messaging.md      | 48 ++++++++++------------
 site2/website-next/docs/deploy-docker.md           |  2 +-
 site2/website-next/docs/reference-metrics.md       |  2 +-
 site2/website-next/static/assets/batching.svg      |  1 +
 site2/website-next/static/assets/consumer.svg      |  1 +
 .../static/assets/message-deduplication.svg        |  1 +
 site2/website-next/static/assets/message-delay.svg |  1 +
 .../website-next/static/assets/pub-sub-border.svg  |  1 +
 .../assets/pulsar-exclusive-subscriptions.svg      |  1 +
 .../assets/pulsar-failover-subscriptions.svg       |  1 +
 .../assets/pulsar-key-shared-subscriptions.svg     |  1 +
 .../static/assets/pulsar-shared-subscriptions.svg  |  1 +
 .../static/assets/retention-expiry.svg             |  1 +
 .../static/swagger/restApiVersions.json            | 10 ++---
 .../version-2.10.0-deprecated/reference-metrics.md |  2 +-
 .../version-2.6.0/reference-metrics.md             |  2 +-
 .../version-2.6.1/reference-metrics.md             |  2 +-
 .../version-2.6.2/reference-metrics.md             |  2 +-
 .../version-2.6.3/reference-metrics.md             |  2 +-
 .../version-2.6.4/reference-metrics.md             |  2 +-
 .../version-2.7.0/reference-metrics.md             |  2 +-
 .../version-2.7.1/reference-metrics.md             |  2 +-
 .../version-2.7.2/reference-metrics.md             |  2 +-
 .../version-2.7.3/reference-metrics.md             |  2 +-
 .../version-2.7.4/reference-metrics.md             |  2 +-
 .../version-2.8.0-deprecated/reference-metrics.md  |  2 +-
 .../version-2.8.1-deprecated/reference-metrics.md  |  2 +-
 .../version-2.8.2-deprecated/reference-metrics.md  |  2 +-
 .../version-2.8.3-deprecated/reference-metrics.md  |  2 +-
 .../version-2.9.0-deprecated/reference-metrics.md  |  2 +-
 .../version-2.9.1-deprecated/reference-metrics.md  |  2 +-
 .../version-2.9.2-deprecated/reference-metrics.md  |  2 +-
 32 files changed, 56 insertions(+), 52 deletions(-)

diff --git a/site2/website-next/docs/concepts-messaging.md b/site2/website-next/docs/concepts-messaging.md
index a5738fd84f5..dd762d0f75d 100644
--- a/site2/website-next/docs/concepts-messaging.md
+++ b/site2/website-next/docs/concepts-messaging.md
@@ -93,16 +93,16 @@ Message compression can reduce message size by paying some CPU overhead. The Pul
 * [LZ4](https://github.com/lz4/lz4)
 * [ZLIB](https://zlib.net/)
 * [ZSTD](https://facebook.github.io/zstd/)
-* [SNAPPY](https://google.github.io/snappy/). 
- 
+* [SNAPPY](https://google.github.io/snappy/).
+
 Compression types are stored in the message metadata, so consumers can adopt different compression types automatically, as needed.
 
 The sample code below shows how to enable compression type for a producer:
 
 ```
 client.newProducer()
-    .topic(“topic-name”) 
-    .compressionType(CompressionType.LZ4) 
+    .topic(“topic-name”)
+    .compressionType(CompressionType.LZ4)
     .create();
 ```
 
@@ -139,7 +139,7 @@ Consumer<byte[]> consumer = pulsarClient.newConsumer()
 Message chunking enables Pulsar to process large payload messages by splitting the message into chunks at the producer side and aggregating chunked messages at the consumer side.
 
 With message chunking enabled, when the size of a message exceeds the allowed maximum payload size (the `maxMessageSize` parameter of broker), the workflow of messaging is as follows:
-1. The producer splits the original message into chunked messages and publishes them with chunked metadata to the broker separately and in order. 
+1. The producer splits the original message into chunked messages and publishes them with chunked metadata to the broker separately and in order.
 2. The broker stores the chunked messages in one managed ledger in the same way as that of ordinary messages, and it uses the `chunkedMessageRate` parameter to record chunked message rate on the topic.
 3. The consumer buffers the chunked messages and aggregates them into the receiver queue when it receives all the chunks of a message.
 4. The client consumes the aggregated message from the receiver queue.
@@ -494,7 +494,7 @@ Consumer<byte[]> consumer = pulsarClient.newConsumer(Schema.BYTES)
                 .subscribe();
 ```
 
-Dead letter topic serves message redelivery, which is triggered by [acknowledgment timeout](#acknowledgment-timeout) or [negative acknowledgment](#negative-acknowledgment) or [retry letter topic](#retry-letter-topic). 
+Dead letter topic serves message redelivery, which is triggered by [acknowledgment timeout](#acknowledgment-timeout) or [negative acknowledgment](#negative-acknowledgment) or [retry letter topic](#retry-letter-topic).
 
 :::note
 
@@ -536,7 +536,7 @@ A subscription is a named configuration rule that determines how messages are de
 
 :::tip
 
-**Pub-Sub or Queuing**  
+**Pub-Sub or Queuing**
   In Pulsar, you can use different subscriptions flexibly.
   * If you want to achieve traditional "fan-out pub-sub messaging" among consumers, specify a unique subscription name for each consumer. It is an exclusive subscription type.
   * If you want to achieve "message queuing" among consumers, share the same subscription name among multiple consumers(shared, failover, key_shared).
@@ -560,7 +560,7 @@ Exclusive is the default subscription type.
 
 :::
 
-![Exclusive subscriptions](/assets/pulsar-exclusive-subscriptions.png)
+![Exclusive subscriptions](/assets/pulsar-exclusive-subscriptions.svg)
 
 #### Failover
 
@@ -573,7 +573,7 @@ For example, a partitioned topic has 3 partitions, and 15 consumers. Each partit
 
 In the diagram below, **Consumer-B-0** is the master consumer while **Consumer-B-1** would be the next consumer in line to receive messages if **Consumer-B-0** is disconnected.
 
-![Failover subscriptions](/assets/pulsar-failover-subscriptions.png)
+![Failover subscriptions](/assets/pulsar-failover-subscriptions.svg)
 
 #### Shared
 
@@ -583,24 +583,24 @@ In the diagram below, **Consumer-C-1** and **Consumer-C-2** are able to subscrib
 
 :::note
 
-**Limitations of Shared type**  
+**Limitations of Shared type**
  When using Shared type, be aware that:
  * Message ordering is not guaranteed.
  * You cannot use cumulative acknowledgment with Shared type.
- 
+
 :::
 
-![Shared subscriptions](/assets/pulsar-shared-subscriptions.png)
+![Shared subscriptions](/assets/pulsar-shared-subscriptions.svg)
 
 #### Key_Shared
 
 In the *Key_Shared* type, multiple consumers can attach to the same subscription. Messages are delivered in distribution across consumers and messages with the same key or same ordering key are delivered to only one consumer. No matter how many times the message is re-delivered, it is delivered to the same consumer. When a consumer connects or disconnects, it causes the served consumer to change some message keys.
 
-![Key_Shared subscriptions](/assets/pulsar-key-shared-subscriptions.png)
+![Key_Shared subscriptions](/assets/pulsar-key-shared-subscriptions.svg)
 
 Note that when the consumers are using the Key_Shared subscription type, you need to **disable batching** or **use key-based batching** for the producers. There are two reasons why the key-based batching is necessary for the Key_Shared subscription type:
-1. The broker dispatches messages according to the keys of the messages, but the default batching approach might fail to pack the messages with the same key to the same batch. 
-2. Since it is the consumers instead of the broker who dispatch the messages from the batches, the key of the first message in one batch is considered as the key to all messages in this batch, thereby leading to context errors. 
+1. The broker dispatches messages according to the keys of the messages, but the default batching approach might fail to pack the messages with the same key to the same batch.
+2. Since it is the consumers instead of the broker who dispatch the messages from the batches, the key of the first message in one batch is considered as the key to all messages in this batch, thereby leading to context errors.
 
 The key-based batching aims at resolving the above-mentioned issues. This batching method ensures that the producers pack the messages with the same key to the same batch. The messages without a key are packed into one batch and this batch has no key. When the broker dispatches messages from this batch, it uses `NON_KEY` as the key. In addition, each consumer is associated with **only one** key and should receive **only one message batch** for the connected key. By default, you can limit [...]
 
@@ -643,13 +643,13 @@ producer = client.create_producer(topic='my-topic', batching_type=pulsar.Batchin
 
 :::note
 
-**Limitations of Key_Shared type** 
+**Limitations of Key_Shared type**
 
 When you use Key_Shared type, be aware that:
   * You need to specify a key or ordering key for messages.
   * You cannot use cumulative acknowledgment with Key_Shared type.
-  * When the position of the newest message in a topic is `X`, a key-shared consumer that is newly attached to the same subscription and connected to the topic will **not** receive any messages until all the messages before `X` have been acknowledged. 
-  
+  * When the position of the newest message in a topic is `X`, a key-shared consumer that is newly attached to the same subscription and connected to the topic will **not** receive any messages until all the messages before `X` have been acknowledged.
+
 :::
 
 ### Subscription modes
@@ -727,7 +727,7 @@ When subscribing to multiple topics, the Pulsar client automatically makes a cal
 
 :::note
 
- **No ordering guarantees across multiple topics**  
+ **No ordering guarantees across multiple topics**
  When a producer sends messages to a single topic, all messages are guaranteed to be read from that topic in the same order. However, these guarantees do not hold across multiple topics. So when a producer sends messages to multiple topics, the order in which messages are read from those topics is not guaranteed to be the same.
 
 :::
@@ -806,7 +806,7 @@ Per-producer       | All the messages from the same producer will be in order. |
 
 {@inject: javadoc:HashingScheme:/client/org/apache/pulsar/client/api/HashingScheme} is an enum that represents sets of standard hashing functions available when choosing the partition to use for a particular message.
 
-There are 2 types of standard hashing functions available: `JavaStringHash` and `Murmur3_32Hash`. 
+There are 2 types of standard hashing functions available: `JavaStringHash` and `Murmur3_32Hash`.
 The default hashing function for producers is `JavaStringHash`.
 Please pay attention that `JavaStringHash` is not useful when producers can be from different multiple language clients, under this use case, it is recommended to use `Murmur3_32Hash`.
 
@@ -946,7 +946,6 @@ The following diagram illustrates what happens when message deduplication is dis
 
 ![Pulsar message deduplication](/assets/message-deduplication.svg)
 
-
 Message deduplication is disabled in the scenario shown at the top. Here, a producer publishes message 1 on a topic; the message reaches a Pulsar broker and is [persisted](concepts-architecture-overview.md#persistent-storage) to BookKeeper. The producer then sends message 1 again (in this case due to some retry logic), and the message is received by the broker and stored in BookKeeper again, which means that duplication has occurred.
 
 In the second scenario at the bottom, the producer publishes message 1, which is received by the broker and persisted, as in the first scenario. When the producer attempts to publish the message again, however, the broker knows that it has already seen message 1 and thus does not persist the message.
@@ -970,7 +969,7 @@ Delayed message delivery only works in the Shared subscription type. In the Excl
 
 The diagram below illustrates the concept of delayed message delivery:
 
-![Delayed Message Delivery](/assets/message_delay.png)
+![Delayed Message Delivery](/assets/message-delay.svg)
 
 A broker saves a message without any check. When a consumer consumes a message, if the message is set to delay, then the message is added to `DelayedDeliveryTracker`. A subscription checks and gets timeout messages from `DelayedDeliveryTracker`.
 
@@ -1005,8 +1004,3 @@ The following is an example of delayed message delivery for a producer in Java:
 // message to be delivered at the configured delay interval
 producer.newMessage().deliverAfter(3L, TimeUnit.Minute).value("Hello Pulsar!").send();
 ```
-
-![consumer](https://user-images.githubusercontent.com/94193423/192619010-cb1a5772-f0b8-4d40-b9f9-1df1c5d8ce68.svg)
-![retention-expiry](https://user-images.githubusercontent.com/94193423/192619038-5dca1524-6c10-4879-be1d-a2504f1f9003.svg)
-![message-deduplication](https://user-images.githubusercontent.com/94193423/192619054-de1226d9-2186-4961-92da-e26c79bae996.svg)
-![delayed-delivery](https://user-images.githubusercontent.com/94193423/192619073-206f0f8c-ab95-4d5e-b83f-f04338d62cea.svg)
diff --git a/site2/website-next/docs/deploy-docker.md b/site2/website-next/docs/deploy-docker.md
index 718eba80ab3..b5eb3939a09 100644
--- a/site2/website-next/docs/deploy-docker.md
+++ b/site2/website-next/docs/deploy-docker.md
@@ -2,7 +2,7 @@
 id: deploy-docker
 title: Deploy a cluster on Docker
 sidebar_label: "Docker"
-—
+---
 
 You can use two kinds of methods to deploy a Pulsar cluster on Docker.
 The first uses Docker commands, while the second uses a `docker-compose.yaml` file.
diff --git a/site2/website-next/docs/reference-metrics.md b/site2/website-next/docs/reference-metrics.md
index 226f1aa22ea..959e58a4d02 100644
--- a/site2/website-next/docs/reference-metrics.md
+++ b/site2/website-next/docs/reference-metrics.md
@@ -401,7 +401,7 @@ All the bundleUnloading metrics are labeled with the following labels:
 
 | Name                          | Type    | Description                                                |
 |-------------------------------|---------|------------------------------------------------------------|
-| pulsar_lb_bundles_split_total | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_total | Counter | The total count of bundle split in this leader broker |
 
 #### Bundle metrics
 All the bundle metrics are labeled with the following labels:
diff --git a/site2/website-next/static/assets/batching.svg b/site2/website-next/static/assets/batching.svg
new file mode 100644
index 00000000000..f27da67619c
--- /dev/null
+++ b/site2/website-next/static/assets/batching.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1720" height="520"><g transform="translate(-20 -360)" lucid:page-tab-id="0_0"><path d="M40 386c0-3.3 2.7-6 6-6h1668c3.3 0 6 2.7 6 6v468c0 3.3-2.7 6-6 6H46c-3.3 0-6-2.7-6-6z" stroke="#dfe3e8" stroke-width="2" fill="#fff" filter="url(#a)"/><path d="M1040 565c0-3.3 2.7-6 6-6h268c3.3 0 6 2.7 6 6v168c0 3.3-2.7 6-6 6h-268c-3.3 0-6-2.7-6-6z" stroke="#3a414a" fill="#fff"/><use xlink:href [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/consumer.svg b/site2/website-next/static/assets/consumer.svg
new file mode 100644
index 00000000000..231ca54adf2
--- /dev/null
+++ b/site2/website-next/static/assets/consumer.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1760" height="460"><g transform="translate(0 -329)" lucid:page-tab-id="0_0"><path d="M20 355c0-3.3 2.7-6 6-6h1708c3.3 0 6 2.7 6 6v408c0 3.3-2.7 6-6 6H26c-3.3 0-6-2.7-6-6z" stroke="#979ea8" fill="#fff" filter="url(#a)"/><path d="M1460 406c0-3.3 2.7-6 6-6h248c3.3 0 6 2.7 6 6v68c0 3.3-2.7 6-6 6h-248c-3.3 0-6-2.7-6-6z" stroke="#3a414a" stroke-width="3" fill="#cfe4ff"/><use xlink:href [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/message-deduplication.svg b/site2/website-next/static/assets/message-deduplication.svg
new file mode 100644
index 00000000000..11d2bf8dd4b
--- /dev/null
+++ b/site2/website-next/static/assets/message-deduplication.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1720" height="920"><g transform="translate(-20 -180)" lucid:page-tab-id="0_0"><path d="M40 206c0-3.3 2.7-6 6-6h1668c3.3 0 6 2.7 6 6v868c0 3.3-2.7 6-6 6H46c-3.3 0-6-2.7-6-6z" stroke="#dfe3e8" fill="#fff" filter="url(#a)"/><path d="M80 246c0-3.3 2.7-6 6-6h188c3.3 0 6 2.7 6 6v88c0 3.3-2.7 6-6 6H86c-3.3 0-6-2.7-6-6z" stroke="#3a414a" stroke-width="3" fill="#dfe3e8"/><use xlink:href=" [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/message-delay.svg b/site2/website-next/static/assets/message-delay.svg
new file mode 100644
index 00000000000..79541c1e590
--- /dev/null
+++ b/site2/website-next/static/assets/message-delay.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1640" height="520"><g transform="translate(-60 -380)" lucid:page-tab-id="0_0"><path d="M80 406c0-3.3 2.7-6 6-6h1588c3.3 0 6 2.7 6 6v468c0 3.3-2.7 6-6 6H86c-3.3 0-6-2.7-6-6z" stroke="#dfe3e8" fill="#fff" filter="url(#a)"/><path d="M160 726c0-3.3 2.7-6 6-6h168c3.3 0 6 2.7 6 6v88c0 3.3-2.7 6-6 6H166c-3.3 0-6-2.7-6-6z" stroke="#3a414a" stroke-width="2" fill="#fff"/><use xlink:href="# [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/pub-sub-border.svg b/site2/website-next/static/assets/pub-sub-border.svg
new file mode 100644
index 00000000000..4238fc8afa1
--- /dev/null
+++ b/site2/website-next/static/assets/pub-sub-border.svg
@@ -0,0 +1 @@
+<svg version="1.1" viewBox="0.0 0.0 960.0 540.0" fill="none" stroke="none" stroke-linecap="square" stroke-miterlimit="10" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg"><clipPath id="g118d76e06ad_0_0.0"><path d="m0 0l960.0 0l0 540.0l-960.0 0l0 -540.0z" clip-rule="nonzero"/></clipPath><g clip-path="url(#g118d76e06ad_0_0.0)"><path fill="#ffffff" d="m0 0l960.0 0l0 540.0l-960.0 0z" fill-rule="evenodd"/><g filter="url(#shadowFilter-g118d76e06ad_0_0.1)"><use xlin [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/pulsar-exclusive-subscriptions.svg b/site2/website-next/static/assets/pulsar-exclusive-subscriptions.svg
new file mode 100644
index 00000000000..b2701ed7724
--- /dev/null
+++ b/site2/website-next/static/assets/pulsar-exclusive-subscriptions.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1760" height="720"><g transform="translate(0 -320)" lucid:page-tab-id="0_0"><path d="M20 346c0-3.3 2.7-6 6-6h1708c3.3 0 6 2.7 6 6v668c0 3.3-2.7 6-6 6H26c-3.3 0-6-2.7-6-6z" stroke="#ced4db" stroke-width="2" fill="#fff" filter="url(#a)"/><path d="M1248.56 566c0-3.3 2.7-6 6-6H1714c3.3 0 6 2.7 6 6v230c0 3.3-2.7 6-6 6h-459.44c-3.3 0-6-2.7-6-6z" stroke="#3a414a" fill="#dfe3e8"/><path d [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/pulsar-failover-subscriptions.svg b/site2/website-next/static/assets/pulsar-failover-subscriptions.svg
new file mode 100644
index 00000000000..c4e1b379644
--- /dev/null
+++ b/site2/website-next/static/assets/pulsar-failover-subscriptions.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1760" height="720"><g transform="translate(0 -320)" lucid:page-tab-id="0_0"><path d="M20 346c0-3.3 2.7-6 6-6h1708c3.3 0 6 2.7 6 6v668c0 3.3-2.7 6-6 6H26c-3.3 0-6-2.7-6-6z" stroke="#ced4db" stroke-width="2" fill="#fff" filter="url(#a)"/><path d="M1248.56 566c0-3.3 2.7-6 6-6H1714c3.3 0 6 2.7 6 6v230c0 3.3-2.7 6-6 6h-459.44c-3.3 0-6-2.7-6-6z" stroke="#3a414a" fill="#dfe3e8"/><path d [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/pulsar-key-shared-subscriptions.svg b/site2/website-next/static/assets/pulsar-key-shared-subscriptions.svg
new file mode 100644
index 00000000000..fc811449aa3
--- /dev/null
+++ b/site2/website-next/static/assets/pulsar-key-shared-subscriptions.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1760" height="720"><g transform="translate(0 -320)" lucid:page-tab-id="0_0"><path d="M20 346c0-3.3 2.7-6 6-6h1708c3.3 0 6 2.7 6 6v668c0 3.3-2.7 6-6 6H26c-3.3 0-6-2.7-6-6z" stroke="#ced4db" stroke-width="2" fill="#fff" filter="url(#a)"/><path d="M1248.56 571c0-3.3 2.7-6 6-6H1714c3.3 0 6 2.7 6 6v230c0 3.3-2.7 6-6 6h-459.44c-3.3 0-6-2.7-6-6z" stroke="#3a414a" fill="#dfe3e8"/><path d [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/pulsar-shared-subscriptions.svg b/site2/website-next/static/assets/pulsar-shared-subscriptions.svg
new file mode 100644
index 00000000000..f8fd5a24738
--- /dev/null
+++ b/site2/website-next/static/assets/pulsar-shared-subscriptions.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1760" height="720"><g transform="translate(0 -320)" lucid:page-tab-id="0_0"><path d="M20 346c0-3.3 2.7-6 6-6h1708c3.3 0 6 2.7 6 6v668c0 3.3-2.7 6-6 6H26c-3.3 0-6-2.7-6-6z" stroke="#ced4db" stroke-width="2" fill="#fff" filter="url(#a)"/><path d="M1248.56 566c0-3.3 2.7-6 6-6H1714c3.3 0 6 2.7 6 6v230c0 3.3-2.7 6-6 6h-459.44c-3.3 0-6-2.7-6-6z" stroke="#3a414a" fill="#dfe3e8"/><path d [...]
\ No newline at end of file
diff --git a/site2/website-next/static/assets/retention-expiry.svg b/site2/website-next/static/assets/retention-expiry.svg
new file mode 100644
index 00000000000..2d9d2ee3d4d
--- /dev/null
+++ b/site2/website-next/static/assets/retention-expiry.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1796.5" height="866.59"><g transform="translate(16.5 -220)" lucid:page-tab-id="0_0"><path d="M3.5 246c0-3.3 2.7-6 6-6H1754c3.3 0 6 2.7 6 6v814.6c0 3.3-2.7 6-6 6H9.5c-3.3 0-6-2.7-6-6z" stroke="#ced4db" stroke-width="2" fill="#fff" filter="url(#a)"/><path d="M84 379.4c0-3.3 2.7-6 6-6h248c3.3 0 6 2.7 6 6v84.44c0 3.3-2.7 6-6 6H90c-3.3 0-6-2.7-6-6z" stroke="#3a414a" stroke-width="2" f [...]
\ No newline at end of file
diff --git a/site2/website-next/static/swagger/restApiVersions.json b/site2/website-next/static/swagger/restApiVersions.json
index 29099ec9b0e..f036dbe6692 100644
--- a/site2/website-next/static/swagger/restApiVersions.json
+++ b/site2/website-next/static/swagger/restApiVersions.json
@@ -33,7 +33,7 @@
             ]
         }
     ],
-    "2.3.0": [
+    "2.3.1": [
         {
             "version": "v2",
             "fileName": [
@@ -49,7 +49,7 @@
             ]
         }
     ],
-    "2.3.1": [
+    "2.3.2": [
         {
             "version": "v2",
             "fileName": [
@@ -65,7 +65,7 @@
             ]
         }
     ],
-    "2.3.2": [
+    "2.3.0": [
         {
             "version": "v2",
             "fileName": [
@@ -129,7 +129,7 @@
             ]
         }
     ],
-    "2.5.0": [
+    "2.5.1": [
         {
             "version": "v2",
             "fileName": [
@@ -145,7 +145,7 @@
             ]
         }
     ],
-    "2.5.1": [
+    "2.5.0": [
         {
             "version": "v2",
             "fileName": [
diff --git a/site2/website-next/versioned_docs/version-2.10.0-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.10.0-deprecated/reference-metrics.md
index c0c67c3bfd2..44b03a5069c 100644
--- a/site2/website-next/versioned_docs/version-2.10.0-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.10.0-deprecated/reference-metrics.md
@@ -343,7 +343,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 #### Bundle metrics
 All the bundle metrics are labelled with the following labels:
diff --git a/site2/website-next/versioned_docs/version-2.6.0/reference-metrics.md b/site2/website-next/versioned_docs/version-2.6.0/reference-metrics.md
index 8921123c136..e3403b8ad81 100644
--- a/site2/website-next/versioned_docs/version-2.6.0/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.6.0/reference-metrics.md
@@ -277,7 +277,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.6.1/reference-metrics.md b/site2/website-next/versioned_docs/version-2.6.1/reference-metrics.md
index 8921123c136..e3403b8ad81 100644
--- a/site2/website-next/versioned_docs/version-2.6.1/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.6.1/reference-metrics.md
@@ -277,7 +277,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.6.2/reference-metrics.md b/site2/website-next/versioned_docs/version-2.6.2/reference-metrics.md
index 8921123c136..e3403b8ad81 100644
--- a/site2/website-next/versioned_docs/version-2.6.2/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.6.2/reference-metrics.md
@@ -277,7 +277,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.6.3/reference-metrics.md b/site2/website-next/versioned_docs/version-2.6.3/reference-metrics.md
index 8921123c136..e3403b8ad81 100644
--- a/site2/website-next/versioned_docs/version-2.6.3/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.6.3/reference-metrics.md
@@ -277,7 +277,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.6.4/reference-metrics.md b/site2/website-next/versioned_docs/version-2.6.4/reference-metrics.md
index 0e47ef05e6f..daece9fef90 100644
--- a/site2/website-next/versioned_docs/version-2.6.4/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.6.4/reference-metrics.md
@@ -277,7 +277,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.7.0/reference-metrics.md b/site2/website-next/versioned_docs/version-2.7.0/reference-metrics.md
index 03457f0d0ec..1fadede9362 100644
--- a/site2/website-next/versioned_docs/version-2.7.0/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.7.0/reference-metrics.md
@@ -275,7 +275,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.7.1/reference-metrics.md b/site2/website-next/versioned_docs/version-2.7.1/reference-metrics.md
index 5172653659e..804aba18640 100644
--- a/site2/website-next/versioned_docs/version-2.7.1/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.7.1/reference-metrics.md
@@ -277,7 +277,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.7.2/reference-metrics.md b/site2/website-next/versioned_docs/version-2.7.2/reference-metrics.md
index 5172653659e..804aba18640 100644
--- a/site2/website-next/versioned_docs/version-2.7.2/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.7.2/reference-metrics.md
@@ -277,7 +277,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.7.3/reference-metrics.md b/site2/website-next/versioned_docs/version-2.7.3/reference-metrics.md
index a146ce1907b..9335fa1bdab 100644
--- a/site2/website-next/versioned_docs/version-2.7.3/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.7.3/reference-metrics.md
@@ -297,7 +297,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.7.4/reference-metrics.md b/site2/website-next/versioned_docs/version-2.7.4/reference-metrics.md
index a146ce1907b..9335fa1bdab 100644
--- a/site2/website-next/versioned_docs/version-2.7.4/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.7.4/reference-metrics.md
@@ -297,7 +297,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.8.0-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.8.0-deprecated/reference-metrics.md
index 24a67d4b81d..df5f7594335 100644
--- a/site2/website-next/versioned_docs/version-2.8.0-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.8.0-deprecated/reference-metrics.md
@@ -296,7 +296,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.8.1-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.8.1-deprecated/reference-metrics.md
index 9ec2cec93be..2d7944e0c83 100644
--- a/site2/website-next/versioned_docs/version-2.8.1-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.8.1-deprecated/reference-metrics.md
@@ -299,7 +299,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.8.2-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.8.2-deprecated/reference-metrics.md
index 4c0f307b7e6..61c734f96a2 100644
--- a/site2/website-next/versioned_docs/version-2.8.2-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.8.2-deprecated/reference-metrics.md
@@ -308,7 +308,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.8.3-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.8.3-deprecated/reference-metrics.md
index 4c0f307b7e6..61c734f96a2 100644
--- a/site2/website-next/versioned_docs/version-2.8.3-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.8.3-deprecated/reference-metrics.md
@@ -308,7 +308,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.9.0-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.9.0-deprecated/reference-metrics.md
index 96c378c3c5d..e4e12d89ac5 100644
--- a/site2/website-next/versioned_docs/version-2.9.0-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.9.0-deprecated/reference-metrics.md
@@ -329,7 +329,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.9.1-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.9.1-deprecated/reference-metrics.md
index 96c378c3c5d..e4e12d89ac5 100644
--- a/site2/website-next/versioned_docs/version-2.9.1-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.9.1-deprecated/reference-metrics.md
@@ -329,7 +329,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics
 
diff --git a/site2/website-next/versioned_docs/version-2.9.2-deprecated/reference-metrics.md b/site2/website-next/versioned_docs/version-2.9.2-deprecated/reference-metrics.md
index 96c378c3c5d..e4e12d89ac5 100644
--- a/site2/website-next/versioned_docs/version-2.9.2-deprecated/reference-metrics.md
+++ b/site2/website-next/versioned_docs/version-2.9.2-deprecated/reference-metrics.md
@@ -329,7 +329,7 @@ All the bundleUnloading metrics are labelled with the following labels:
 
 | Name | Type | Description |
 | --- | --- | --- |
-| pulsar_lb_bundles_split_count | Counter | bundle split count in this bundle splitting check interval |
+| pulsar_lb_bundles_split_count | Counter | The total count of bundle split in this leader broker |
 
 ### Subscription metrics