Kapacitor cluster CLI

This is archived documentation for InfluxData product versions that are no longer maintained. For newer documentation, see the latest InfluxData documentation.

The kapacictorctl utility provides management tools for Kapacitor clusters.



Skips TLS verification. This should be used if interacting with Kapacitor servers in your cluster that are secured using self-signed TLS certificates.

This can also be enabled using the KAPACITOR_UNSAFE_SSL environment variable.

# Pattern
kapacitorctl [command] [subcommand] -skipVerify

# Example
kapacitorctl member add example.com:9091 -skipVerify


This option is used to run kapacitorctl commands on a remote host. It specifies the resolvable host at which a kapacitord process is running.

This can also be specified using the KAPACITOR_URL environment variable.

# Pattern
kapacitorctl [command] [subcommand] -url http://example.com:9092

# Example
kapacitorctl member list -url http://example.com:9092

Include authentication credentials in the Kapacitor URL

If authentication is enabled on InfluxDB and Kapacitor, include your InfluxDB username and password as query parameters, u and p respectively, in the Kapacitor URL. For both convenience and security, InfluxData recommends storing these credentials as part of the Kapacitor URL in the KAPACITOR_URL environment variable.


# When KAPACITOR_URL is defined, the -url flag isn't necessary.
kapacitorctl member list


The kapacitorctl utility includes the following commands:


The kapacitorctl member command is used to add, remove, and list information about members of a Kapacitor cluster. It includes three subcommands:

member list

The kapacitorctl member list subcommand lists cluster members, related information, and statuses.

kapacitorctl member list

The output contains the following information:

State: initialized
Cluster ID: 876ddfb4-1879-4f40-87e2-4080c04d3096
Local Member ID: f74f3547-efaf-4e6e-8b05-fb12b19f8287
Member ID                               Gossip Address RPC Address    API Address    Roles  Status
f74f3547-efaf-4e6e-8b05-fb12b19f8287    serverA:9090   serverA:9091   serverA:9092   worker alive
13eeefdd-41b5-453f-928e-cb9c55fd2a5d    serverB:9090   serverB:9091   serverB:9092   worker alive

member add

The kapacitorctl member add subcommand adds members to a Kapacitor cluster. It requires the RPC address of the member you intend to add. The RPC address is the resolvable DNS or IP (using port 9091) of the Kapacitor host you intend to add as a member.

RPC addresses can also be found by running kapacitorctl memeber list on the Kapacitor node you intend to add. The Kapacitor host will appear as the only member in the cluster since it has not yet been added to a cluster.

# Pattern
kapacitorctl member add <member-rpc-address>

# Example
kapacitorctl member add example.com:9091

member remove

The kapacitorctl member remove subcommand removes a member from a Kapacitor cluster. It requires the member ID of the member you intend to remove. Member IDs are included in the kapacitorctl member list output.

# Pattern
kapacitorctl member remove <member-id>

# Example
kapacitorctl member remove 13eeefdd-41b5-453f-928e-cb9c55fd2a5d


The help command prints help information for a given command.

# Pattern
kapacitorctl help [command]

# Example
kapacitorctl help member

Running kapacitorctl commands remotely

To run kapacitorctl commands remotely, use the -url option to specify the URL at which the remote Kapacitor server is accessed.

For example, if you have a Kapacitor cluster with a member accessible at https://node-1.my-kapacitor.com:9092, you can run kapacitorctl commands on that server by passing the resolvable URL as the -url.

kapacitorctl member add node-2.my-kapacitor.com:9091 -url https://node-1.my-kapacitor.com:9092

The member add subcommand above will run on the node-1.my-kapacitor.com server.

If Kapacitor members in your cluster are secured using self-signed TLS certificates, include the -skipVerify option to avoid SSL/TLS verification issues.