vtctl Resharding Throttler Command Reference

The following vtctl commands are available for administering Resharding Throttler.

Commands #

ThrottlerMaxRates #

Returns the current max rate of all active resharding throttlers on the server.

Example #

ThrottlerMaxRates -server <vtworker or vttablet>

Flags #

NameTypeDefinition
serverstringvtworker or vttablet to connect to

Arguments #

  • <vtworker or vttablet> – Required.

Errors #

  • the ThrottlerSetMaxRate command does not accept any positional parameters This error occurs if the command is not called with exactly 0 arguments.
  • error creating a throttler client for <server> ‘%v’: %v
  • failed to get the throttler rate from <server> ‘%v’: %v

ThrottlerSetMaxRate #

Sets the max rate for all active resharding throttlers on the server.

Example #

ThrottlerSetMaxRate -server <vtworker or vttablet> <rate>

Flags #

NameTypeDefinition
serverstringvtworker or vttablet to connect to

Arguments #

  • <vtworker or vttablet> – Required.
  • <rate> – Required.

Errors #

  • the <rate> argument is required for the <ThrottlerSetMaxRate> command This error occurs if the command is not called with exactly one argument.
  • failed to parse rate ‘%v’ as integer value: %v
  • error creating a throttler client for <server> ‘%v’: %v
  • failed to set the throttler rate on <server> ‘%v’: %v

GetThrottlerConfiguration #

Returns the current configuration of the MaxReplicationLag module. If no throttler name is specified, the configuration of all throttlers will be returned.

Example #

GetThrottlerConfiguration -server <vtworker or vttablet> [<throttler name>]

Flags #

NameTypeDefinition
serverstringvtworker or vttablet to connect to

Arguments #

  • <vtworker or vttablet> – Required.
  • <throttler name> – Optional.

Errors #

  • the <GetThrottlerConfiguration> command accepts only <throttler name> as optional positional parameter This error occurs if the command is not called with more than 1 arguments.
  • error creating a throttler client for <server> ‘%v’: %v
  • failed to get the throttler configuration from <server> ‘%v’: %v

UpdateThrottlerConfiguration #

Updates the configuration of the MaxReplicationLag module. The configuration must be specified as protobuf text. If a field is omitted or has a zero value, it will be ignored unless -copy_zero_values is specified. If no throttler name is specified, all throttlers will be updated.

Example #

UpdateThrottlerConfiguration `-server <vtworker or vttablet> [-copy_zero_values] "<configuration protobuf text>" [<throttler name>]`

Flags #

NameTypeDefinition
copy_zero_valuesBooleanIf true, fields with zero values will be copied as well
serverstringvtworker or vttablet to connect to

Arguments #

  • <vtworker or vttablet> – Required.
  • <throttler name> – Optional.

Errors #

  • Failed to unmarshal the configuration protobuf text (%v) into a protobuf instance: %v
  • error creating a throttler client for <server> ‘%v’: %v
  • failed to update the throttler configuration on <server> ‘%v’: %v

ResetThrottlerConfiguration #

Resets the current configuration of the MaxReplicationLag module. If no throttler name is specified, the configuration of all throttlers will be reset.

Example #

ResetThrottlerConfiguration -server <vtworker or vttablet> [<throttler name>]

Flags #

NameTypeDefinition
serverstringvtworker or vttablet to connect to

Arguments #

  • <vtworker or vttablet> – Required.
  • <throttler name> – Optional.

Errors #

  • the <ResetThrottlerConfiguration> command accepts only <throttler name> as optional positional parameter This error occurs if the command is not called with more than 1 arguments.
  • error creating a throttler client for <server> ‘%v’: %v
  • failed to get the throttler configuration from <server> ‘%v’: %v

See Also #