DOC-1907: Add Paginate Messages page

local-antora-playbook.yml

@@ -18,7 +18,7 @@ content:
   - url: https://github.com/redpanda-data/docs
     branches: [v/*, shared, site-search,'!v-end-of-life/*']
   - url: https://github.com/redpanda-data/cloud-docs
-    branches: 'main'
+    branches: 'DOC-1907-paginate-messages-events'
   - url: https://github.com/redpanda-data/redpanda-labs
     branches: main
     start_paths: [docs,'*/docs']

modules/ROOT/nav.adoc

@@ -49,6 +49,7 @@
 *** xref:develop:consume-data/follower-fetching.adoc[Follower Fetching]
 *** xref:console:ui/programmable-push-filters.adoc[Filter Messages]
 *** xref:console:ui/record-deserialization.adoc[Deserialize Messages]
+*** xref:console:ui/paginate-messages-events.adoc[]
 ** xref:develop:data-transforms/index.adoc[]
 *** xref:develop:data-transforms/how-transforms-work.adoc[Overview]
 *** xref:develop:data-transforms/run-transforms-index.adoc[Get Started]

modules/console/pages/index.adoc

@@ -24,7 +24,7 @@ image::broker-overview.png[]
 
 Observe and debug your streaming data:
 
-* *Message inspection*: Browse and filter messages within your topics, with options to search by key, timestamp, or custom filters.
+* *Message inspection*: Browse and filter messages within your topics, with options to search by key, timestamp, or custom filters. See xref:console:ui/paginate-messages-events.adoc[] to inspect large result sets.
 * xref:console:ui/programmable-push-filters.adoc[*Programmable push filters*]: Write custom JavaScript filters to isolate specific messages, enabling deep inspection and debugging.
 * *Rewind and Replay*: Roll back consumer offsets to reprocess messages, allowing you to correct issues or replay data as needed.
 

modules/console/pages/ui/paginate-messages-events.adoc

@@ -0,0 +1,40 @@
+= Paginate Messages in {ui}
+:description: Enable Continuous Pagination on a topic's Messages tab to scroll through all records instead of being capped by Max results.
+:page-topic-type: how-to
+
+
+// tag::single-source[]
+
+By default, the *Messages* tab on a topic returns up to the number of records set in *Max results*. Enable *Continuous Pagination* when you need to inspect a topic beyond that cap.
+
+== Browse all messages in a topic
+
+. In the menu, go to *Topics* and select a topic.
+. Open the *Messages* tab.
+. (Optional) Set *Start offset* and *Max results*, or apply filters, to narrow the records you want to inspect.
++
+ifdef::env-cloud[]
+See xref:manage:schema-reg/programmable-push-filters.adoc[] and xref:manage:schema-reg/record-deserialization.adoc[].
+endif::[]
+ifndef::env-cloud[]
+See xref:console:ui/programmable-push-filters.adoc[] and xref:console:ui/record-deserialization.adoc[].
+endif::[]
+. Enable the *Continuous Pagination* toggle.
+. Scroll the message list. {ui} keeps loading records until you reach the end of the topic.
+
+When continuous pagination is on, the max results cap no longer limits the browsing session.
+
+== Performance considerations
+
+Retrieving large result sets increases load on the {ui} backend and the cluster. To keep responses fast:
+
+* Narrow the result set with filters or a bounded offset range before enabling continuous pagination*.
+ifdef::env-cloud[]
+* Use xref:manage:schema-reg/programmable-push-filters.adoc[JavaScript push filters] to match only the records you need.
+endif::[]
+ifndef::env-cloud[]
+* Use xref:console:ui/programmable-push-filters.adoc[JavaScript push filters] to match only the records you need.
+endif::[]
+* Leave continuous pagination off and rely on max results when you only need a sample.
+
+// end::single-source[]