Message Browser

From the Messages page, you can view the data being produced to a topic. Browse message data, seek to a specific offset or timestamp by partition, and select messages you want to download.

Inspect a topic

The Topic Inspection feature in Confluent Cloud enables you to inspect topic details and browse live streaming messages.

To inspect a topic and browse a live stream of messages:

  1. Select a cluster from the navigation bar.

  2. Click the Topics menu. The Topics page appears.

    ../../../_images/ccloud-topics-context-menu.png
  3. Click the ellipsis (...) by the topic name and click Messages. The Messages page displays incoming streaming messages for the topic.

  4. To browse the messages pane:

    • Click the horizontal (tabular view) and vertical scrollbars to view all of the available data. The newest data is displayed at the top of the messages pane. As you scroll vertically, or hover in the messages pane, a timeline arrow indicates when the messages were received.
    Browse topic messages in default tabular view

    Browse topic messages in default tabular view

    • To pause scrolling incoming messages so that you can analyze the data, hover in the messages pane. To resume scrolling, move the cursor focus outside of the messages pane.

    • To filter the results, enter the criteria in the Filter by keyword box.

      Search topic messages by keyword

      Prefix search for topic messages by keyword of value

      Note

      Only prefix searching is currently supported. You can search for the beginning portion of a keyword. The search keyword must be the first substring in a column item. The filter matches the search string across any of the columns.

    • Seek to a particular message using Jump to offset or Jump to timestamp.

    • Click Columns to select which columns you want to toggle on or off in the topic messages table. There must be populated message data for the Columns selector to appear. Narrow the view to focus on the columns of interest without resorting to horizontal scrolling. If you jump to an offset or timestamp, the table resets to show all columns again.

      Column selector topic messages view

      Column selector topic messages view

    • Click the Card view or Tabular view (default) icon for the layout you prefer:

      ../../../_images/c3-topic-inspect-card-tab-icons.png
      Browse topic messages in cards view

      Browse topic messages in cards view

Jump to an offset

To jump to a message offset, click the Jump to offset menu and enter the offset and partition. Messages are displayed in the message browser pane starting from the desired offset, and continue to feed in at the top of the message browser pane.

The record at the offset is highlighted and preselected for download.

Jump to an offset in Confluent Cloud topic message browser

Jump to an offset in Confluent Cloud topic message browser

Jump to a timestamp

To jump to a message timestamp, click the Jump to timestamp menu and enter the timestamp and partition.

The timestamp is displayed in microseconds. Enter your time of interest in milliseconds into the timestamp box and selected partition.

Tip

Use a timestamp converter to convert the timestamp into a human-readable date and time.

The timestamp jump searches for the earliest offset where the timestamp was first recorded. Even if there are multiple data points associated with a timestamp, the seek goes to the earliest offset. Messages are displayed in the message browser pane starting from the desired timestamp, and continue to feed in at the top of the message browser pane. Manually select any messages you want to download.

Jump to a timestamp in Confluent Cloud topic message browser

Jump to a timestamp in Control Cloud topic message browser

Download selected topic messages

Download selected rows of messages in a JSON format.

  1. Select one or more contiguous or non-contiguous rows. The Download button becomes available and shows the number of selected messages.

    Tip

    Press the command key + click to select non-contiguous rows. Press shift + click on a beginning and ending row to select a contiguous range of messages.

    Select contiguous rows to download messages in Confluent Cloud message browser

    Contiguous rows selected for download

    Select non-contiguous rows to download messages in Confluent Cloud message browser

    Non-contiguous rows selected for download

  2. Click the download icon. A file named selected_data_n.json that contains the selected messages in JSON format is downloaded into your downloads directory. The n represents the number of selected messages.

    Example filename: selected_data_1.json

    Example contents:

    [{"topic":"test-topic","partition":2,"offset":7,"timestamp":1570216529854,"timestampType":"CREATE_TIME","headers":[],"key":null,"value":"transaction123"}]