In Apache Pulsar, unloading a topic is a helpful administrative action that forces the broker to release resources tied to a topic. This can be especially useful for rebalancing load, resolving temporary issues, or resetting state on the broker.
In this guide, we’ll walk through how to unload a topic directly from the web interface. No CLI required.
To get started, open the Explorer page. This is your main starting point for interacting with your Pulsar environment.
Once you are on the Explorer page, you'll see a list of tenants, the logical groups that help organize your messaging infrastructure. Each tenant contains one or more namespaces, which in turn contain the actual topics where your messages live.
Here’s a quick path through the structure:
This clear hierarchy ensures you always know exactly where you are in the system.
Once you’ve selected a topic, you’ll land on its overview page. This page gives you general information about the topic, such as its configuration and metrics.
Look for the Manage button and click on it. In the context menu that opens, select Unload.
When you click Unload, here is what happens:
This actions is safe and quick - it does not delete any data and the topic will automatically be reassigned.
Unload a Pulsar topic is a powerful but simple operation when managing Pulsar clusters. With our Pulsar UI, you can get easy one-click access to all the go-to operations you need. Try it out next time you need to reset a stuck connection, reduce load on a broker or release some stale metadata!