pulsar-admin
Apache Pulsar cluster administration tool
TLDR
List tenants
SYNOPSIS
pulsar-admin command [options]
pulsar-client produce|consume [options]
DESCRIPTION
pulsar-admin manages Apache Pulsar clusters, handling tenants, namespaces, topics, and cluster configuration. pulsar-client provides simple produce/consume operations.
Pulsar's multi-tenancy model organizes resources: clusters contain tenants, tenants contain namespaces, namespaces contain topics. Each level has configurable policies.
Topics use the format persistent://tenant/namespace/topic (or non-persistent://). Subscriptions define how consumers receive messages: exclusive, shared, failover, or key_shared.
pulsar-admin topics stats shows message rates, storage size, subscriptions, and producer/consumer connections. This helps monitor topic health.
Pulsar Functions enable lightweight stream processing directly on the broker. Sources and sinks connect external systems for data ingestion and export.
PARAMETERS
--admin-url url
Pulsar admin service URL.--url url
Broker service URL (for client).--auth-plugin class
Authentication plugin class.--auth-params params
Authentication parameters.-m, --messages message
Message content for produce.-s, --subscription name
Subscription name for consume.-n, --num-messages count
Number of messages to consume.-r, --rate msgs/sec
Message rate limit.
ADMIN COMMANDS
tenants list|create|delete|get|update
Manage tenants (multi-tenancy).namespaces list|create|delete|policies
Manage namespaces.topics list|create|delete|stats|subscriptions
Manage topics and subscriptions.brokers list|leader|namespaces
Broker information.clusters list|create|delete|update
Cluster management.functions create|delete|list|status
Manage Pulsar Functions.sources/sinks create|delete|list
Manage IO connectors.
CAVEATS
Requires proper authentication configuration for secured clusters. Topic creation may be automatic depending on broker settings. Namespace policies affect all topics within. Functions require function worker to be enabled.
HISTORY
Apache Pulsar was originally developed at Yahoo! and open-sourced in 2016. It became an Apache top-level project in 2018. Designed for multi-tenancy and geo-replication, Pulsar separates storage (BookKeeper) from serving (brokers). It offers features like topic compaction, tiered storage, and built-in schema registry. StreamNative provides commercial support.
SEE ALSO
kafka-console-producer(1), nats(1), rabbitmqctl(1)