influx replication list
Replication remotes and replication streams can only be configured for InfluxDB OSS.
The influx replication list command lists all InfluxDB replication streams and their corresponding metrics.
The following metrics are listed for each replication and provide information about how the replication queue is performing:
- Latest Status Code: Status code of the last
writerequest to the remote. This should be a 204 during healthy operation. - Remaining Bytes to be Synced: Number of bytes that have not been synced to the remote. This number should stay close to 0 and should not be constantly increasing.
- Current Queue Bytes on Disk: Total size of the replication queue in bytes.
The replication queue is cleaned up every
--max-ageseconds. If your queue is filling up your disk, lower this value at the cost of potentially lower reliability.
Usage
influx replication list [command options] [arguments...]
Flags
| Flag | Description | Input type | Maps to ? | |
|---|---|---|---|---|
-n |
--name |
Filter replication streams by name | string | |
--org-id |
Local organization ID | string | INFLUX_ORG_ID |
|
-o |
--org |
Local organization name | string | INFLUX_ORG |
--remote-id |
Filter replication streams by remote connection ID | string | ||
--local-bucket-id |
Filter replication streams by local bucket | string | ||
--host |
InfluxDB HTTP address (default http://localhost:8086) |
string | INFLUX_HOST |
|
--skip-verify |
Skip TLS certificate verification | INFLUX_SKIP_VERIFY |
||
--configs-path |
Path to influx CLI configurations (default ~/.influxdbv2/configs) |
string | INFLUX_CONFIGS_PATH |
|
-c |
--active-config |
CLI configuration to use for command | string | |
--http-debug |
Inspect communication with InfluxDB servers | string | ||
--json |
Output data as JSON (default false) |
INFLUX_OUTPUT_JSON |
||
--hide-headers |
Hide table headers (default false) |
INFLUX_HIDE_HEADERS |
||
-t |
--token |
InfluxDB API token | string | INFLUX_TOKEN |
Examples
Authentication credentials
The examples below assume your InfluxDB host, organization, and token are
provided by either the active influx CLI configuration or by environment variables (INFLUX_HOST, INFLUX_ORG, and INFLUX_TOKEN).
If you do not have a CLI configuration set up or the environment variables set, include these required credentials for each command with the following flags:
--host: InfluxDB host-o, --orgor--org-id: InfluxDB organization name or ID-t, --token: InfluxDB API token
List all replication streams
influx replication list --org-id <OSS org ID> --token <OSS token>
List a replication stream by name
influx replication list --name example-replication-name
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.