Important

You are viewing documentation for an older version of Confluent Platform. For the latest, click here.

Command Reference¶

Important

The Confluent CLI is meant for development purposes only and is not suitable for a production environment. The data that are produced are transient and are intended to be temporary.

Available Commands

The available commands are:

Command	Description
confluent acl	Specify an ACL for a service.
confluent config	View or set connector configuration properties.
confluent current	Print the filesystem path of the data and logs of the services managed by the current Confluent run. If such a path does not exist, it will be created.
confluent destroy	Delete an existing Confluent run.
confluent help	Print command information.
confluent list	List all available services or plugins.
confluent load	Load a bundled connector with a predefined name or custom connector.
confluent log	View a snapshot or tail the log of a service.
confluent start	Start Confluent Platform services.
confluent stop	Stop services.
confluent top	View service resource usage.
confluent unload	Unload a connector.

To list available commands, run confluent with no parameters:

confluent: A command line interface to manage Confluent services

Usage: confluent <command> [<subcommand>] [<parameters>]

These are the available commands:

    acl         Specify acl for a service.
    config      Configure a connector.
    current     Get the path of the data and logs of the services managed by the current confluent run.
    destroy     Delete the data and logs of the current confluent run.
    list        List available services.
    load        Load a connector.
    log         Read or tail the log of a service.
    start       Start all services or a specific service along with its dependencies
    status      Get the status of all services or the status of a specific service along with its dependencies.
    stop        Stop all services or a specific service along with the services depending on it.
    top         Track resource usage of a service.
    unload      Unload a connector.

'confluent help' lists available commands. See 'confluent help <command>' to read about a
specific command.

Environment Variables

The Confluent CLI supports the CONFLUENT_CURRENT environment variable, which can be set dynamically. For more information, see Installing and Configuring the CLI.

To configure properties for specific services via environment variable, use the given prefix for the corresponding service:

Service	Prefix
ZooKeeper	`$ZOOKEEPER_`
Kafka	`$KAFKA_`
Schema Registry	`$SCHEMA_REGISTRY_`
REST Proxy	`$KAFKAREST_`
Kafka Connect	`$CONNECT_`

For example, to set the system property -Djava.security.auth.login.config=/tmp/kafka_client_jaas.conf when starting Kafka Connect, run the command:

export CONNECT_OPTS="-Djava.security.auth.login.config=/tmp/kafka_client_jaas.conf"
confluent start connect

and to set the same system property when invoking Kafka core, run the command:

export KAFKA_OPTS="-Djava.security.auth.login.config=/tmp/kafka_client_jaas.conf"
confluent start kafka

The Apache Kafka startup scripts for Kafka Connect (bin/connect-standalone.sh and bin/connect-distributed.sh) use variables prefixed with $KAFKA_ (e.g. $KAFKA_OPTS and $KAFKA_LOG4J_OPTS). For simplicity, the Confluent CLI uses $CONNECT_ for Kafka Connect settings and $KAFKA_ for core Kafka settings.