influx replication create

Replication remotes and replication streams can only be configured for InfluxDB OSS.

The influx replication create command creates a new InfluxDB replication stream.

Usage

  1. influx replication create [command options] [arguments...]

Flags

FlagDescriptionInput typeMaps to ?
-n—nameReplication stream namestring
-d—descriptionReplication stream descriptionstring
—org-idLocal organization IDstringINFLUX_ORG_ID
-o—orgLocal organization namestringINFLUX_ORG
—remote-idRemote connection ID to replicate data tostring
—local-bucket-idLocal bucket ID to replicate data fromstring
—remote-bucketRemote bucket name to replicate data to (mutually exclusive with —remote-bucket-id)string
—remote-bucket-idRemote bucket ID to replicate data to (mutually exclusive with —remote-bucket-name)string
—max-queue-bytesMax queue size in bytes (default: 67108860)integer
—drop-non-retryable-dataDrop data when a non-retryable error is encountered
—no-drop-non-retryable-dataDo not drop data when a non-retryable error is encountered
—max-ageSpecify a maximum age (in seconds) for data before it is droppedinteger
—hostInfluxDB HTTP address (default http://localhost:8086)stringINFLUX_HOST
—skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
—configs-pathPath to influx CLI configurations (default ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
-c—active-configCLI configuration to use for commandstring
—http-debugInspect communication with InfluxDB serversstring
—jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
—hide-headersHide table headers (default false)INFLUX_HIDE_HEADERS
-t—tokenInfluxDB API tokenstringINFLUX_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, --org or --org-id: InfluxDB organization name or ID
  • -t, --token: InfluxDB API token

Create a replication stream

  1. Create a remote connection, if you haven’t already.

  2. Use influx remote list to get the ID for the remote you want to replicate data to.

    1. $ influx remote list
    2. ID                    Name        Org ID
    3. 0ooxX0xxXo0x         myremote    [...]

  3. Create the replication:

    1. influx replication create \
    2.   --name myreplication
    3.   --local-bucket example-local-bucket
    4.   --remote-bucket example-remote-bucket
    5.   --remote-id 0ooxX0xxXo0x

write