vitess.io/vitess@v0.16.2/go/flags/endtoend/vtctld.txt (about) 1 Usage of vtctld: 2 --action_timeout duration time to wait for an action before resorting to force (default 1m0s) 3 --alsologtostderr log to standard error as well as files 4 --azblob_backup_account_key_file string Path to a file containing the Azure Storage account key; if this flag is unset, the environment variable VT_AZBLOB_ACCOUNT_KEY will be used as the key itself (NOT a file path). 5 --azblob_backup_account_name string Azure Storage Account name for backups; if this flag is unset, the environment variable VT_AZBLOB_ACCOUNT_NAME will be used. 6 --azblob_backup_container_name string Azure Blob Container Name. 7 --azblob_backup_parallelism int Azure Blob operation parallelism (requires extra memory when increased). (default 1) 8 --azblob_backup_storage_root string Root prefix for all backup-related Azure Blobs; this should exclude both initial and trailing '/' (e.g. just 'a/b' not '/a/b/'). 9 --backup_engine_implementation string Specifies which implementation to use for creating new backups (builtin or xtrabackup). Restores will always be done with whichever engine created a given backup. (default "builtin") 10 --backup_storage_block_size int if backup_storage_compress is true, backup_storage_block_size sets the byte size for each block while compressing (default is 250000). (default 250000) 11 --backup_storage_compress if set, the backup files will be compressed. (default true) 12 --backup_storage_implementation string Which backup storage implementation to use for creating and restoring backups. 13 --backup_storage_number_blocks int if backup_storage_compress is true, backup_storage_number_blocks sets the number of blocks that can be processed, at once, before the writer blocks, during compression (default is 2). It should be equal to the number of CPUs available for compression. (default 2) 14 --builtinbackup_mysqld_timeout duration how long to wait for mysqld to shutdown at the start of the backup. (default 10m0s) 15 --builtinbackup_progress duration how often to send progress updates when backing up large files. (default 5s) 16 --catch-sigpipe catch and ignore SIGPIPE on stdout and stderr if specified 17 --cell string cell to use 18 --ceph_backup_storage_config string Path to JSON config file for ceph backup storage. (default "ceph_backup_config.json") 19 --compression-engine-name string compressor engine used for compression. (default "pargzip") 20 --compression-level int what level to pass to the compressor. (default 1) 21 --consul_auth_static_file string JSON File to read the topos/tokens from. 22 --datadog-agent-host string host to send spans to. if empty, no tracing will be done 23 --datadog-agent-port string port to send spans to. if empty, no tracing will be done 24 --disable_active_reparents if set, do not allow active reparents. Use this to protect a cluster using external reparents. 25 --durability_policy string type of durability to enforce. Default is none. Other values are dictated by registered plugins (default "none") 26 --emit_stats If set, emit stats to push-based monitoring and stats backends 27 --external-compressor string command with arguments to use when compressing a backup. 28 --external-compressor-extension string extension to use when using an external compressor. 29 --external-decompressor string command with arguments to use when decompressing a backup. 30 --file_backup_storage_root string Root directory for the file backup storage. 31 --gcs_backup_storage_bucket string Google Cloud Storage bucket to use for backups. 32 --gcs_backup_storage_root string Root prefix for all backup-related object names. 33 --grpc_auth_mode string Which auth plugin implementation to use (eg: static) 34 --grpc_auth_mtls_allowed_substrings string List of substrings of at least one of the client certificate names (separated by colon). 35 --grpc_auth_static_client_creds string When using grpc_static_auth in the server, this file provides the credentials to use to authenticate with server. 36 --grpc_auth_static_password_file string JSON File to read the users/passwords from. 37 --grpc_ca string server CA to use for gRPC connections, requires TLS, and enforces client certificate check 38 --grpc_cert string server certificate to use for gRPC connections, requires grpc_key, enables TLS 39 --grpc_compression string Which protocol to use for compressing gRPC. Default: nothing. Supported: snappy 40 --grpc_crl string path to a certificate revocation list in PEM format, client certificates will be further verified against this file during TLS handshake 41 --grpc_enable_optional_tls enable optional TLS mode when a server accepts both TLS and plain-text connections on the same port 42 --grpc_enable_tracing Enable gRPC tracing. 43 --grpc_initial_conn_window_size int gRPC initial connection window size 44 --grpc_initial_window_size int gRPC initial window size 45 --grpc_keepalive_time duration After a duration of this time, if the client doesn't see any activity, it pings the server to see if the transport is still alive. (default 10s) 46 --grpc_keepalive_timeout duration After having pinged for keepalive check, the client waits for a duration of Timeout and if no activity is seen even after that the connection is closed. (default 10s) 47 --grpc_key string server private key to use for gRPC connections, requires grpc_cert, enables TLS 48 --grpc_max_connection_age duration Maximum age of a client connection before GoAway is sent. (default 2562047h47m16.854775807s) 49 --grpc_max_connection_age_grace duration Additional grace period after grpc_max_connection_age, after which connections are forcibly closed. (default 2562047h47m16.854775807s) 50 --grpc_max_message_size int Maximum allowed RPC message size. Larger messages will be rejected by gRPC with the error 'exceeding the max size'. (default 16777216) 51 --grpc_port int Port to listen on for gRPC calls. If zero, do not listen. 52 --grpc_prometheus Enable gRPC monitoring with Prometheus. 53 --grpc_server_ca string path to server CA in PEM format, which will be combine with server cert, return full certificate chain to clients 54 --grpc_server_initial_conn_window_size int gRPC server initial connection window size 55 --grpc_server_initial_window_size int gRPC server initial window size 56 --grpc_server_keepalive_enforcement_policy_min_time duration gRPC server minimum keepalive time (default 10s) 57 --grpc_server_keepalive_enforcement_policy_permit_without_stream gRPC server permit client keepalive pings even when there are no active streams (RPCs) 58 -h, --help display usage and exit 59 --jaeger-agent-host string host and port to send spans to. if empty, no tracing will be done 60 --keep_logs duration keep logs for this long (using ctime) (zero to keep forever) 61 --keep_logs_by_mtime duration keep logs for this long (using mtime) (zero to keep forever) 62 --lameduck-period duration keep running at least this long after SIGTERM before stopping (default 50ms) 63 --lock-timeout duration Maximum time for which a shard/keyspace lock can be acquired for (default 45s) 64 --log_backtrace_at traceLocation when logging hits line file:N, emit a stack trace (default :0) 65 --log_dir string If non-empty, write log files in this directory 66 --log_err_stacks log stack traces for errors 67 --log_rotate_max_size uint size in bytes at which logs are rotated (glog.MaxSize) (default 1887436800) 68 --logtostderr log to standard error instead of files 69 --max-stack-size int configure the maximum stack size in bytes (default 67108864) 70 --onclose_timeout duration wait no more than this for OnClose handlers before stopping (default 10s) 71 --onterm_timeout duration wait no more than this for OnTermSync handlers before stopping (default 10s) 72 --opentsdb_uri string URI of opentsdb /api/put method 73 --pid_file string If set, the process will write its pid to the named file, and delete it on graceful shutdown. 74 --port int port for the server 75 --pprof strings enable profiling 76 --proxy_tablets Setting this true will make vtctld proxy the tablet status instead of redirecting to them 77 --purge_logs_interval duration how often try to remove old logs (default 1h0m0s) 78 --remote_operation_timeout duration time to wait for a remote operation (default 15s) 79 --s3_backup_aws_endpoint string endpoint of the S3 backend (region must be provided). 80 --s3_backup_aws_region string AWS region to use. (default "us-east-1") 81 --s3_backup_aws_retries int AWS request retries. (default -1) 82 --s3_backup_force_path_style force the s3 path style. 83 --s3_backup_log_level string determine the S3 loglevel to use from LogOff, LogDebug, LogDebugWithSigning, LogDebugWithHTTPBody, LogDebugWithRequestRetries, LogDebugWithRequestErrors. (default "LogOff") 84 --s3_backup_server_side_encryption string server-side encryption algorithm (e.g., AES256, aws:kms, sse_c:/path/to/key/file). 85 --s3_backup_storage_bucket string S3 bucket to use for backups. 86 --s3_backup_storage_root string root prefix for all backup-related object names. 87 --s3_backup_tls_skip_verify_cert skip the 'certificate is valid' check for SSL connections. 88 --schema_change_check_interval duration How often the schema change dir is checked for schema changes (deprecated: if passed as a bare integer, the duration will be in seconds). (default 1m0s) 89 --schema_change_controller string Schema change controller is responsible for finding schema changes and responding to schema change events. 90 --schema_change_dir string Directory containing schema changes for all keyspaces. Each keyspace has its own directory, and schema changes are expected to live in '$KEYSPACE/input' dir. (e.g. 'test_keyspace/input/*sql'). Each sql file represents a schema change. 91 --schema_change_replicas_timeout duration How long to wait for replicas to receive a schema change. (default 10s) 92 --schema_change_user string The user who schema changes are submitted on behalf of. 93 --security_policy string the name of a registered security policy to use for controlling access to URLs - empty means allow all for anyone (built-in policies: deny-all, read-only) 94 --service_map strings comma separated list of services to enable (or disable if prefixed with '-') Example: grpc-queryservice 95 --sql-max-length-errors int truncate queries in error logs to the given length (default unlimited) 96 --sql-max-length-ui int truncate queries in debug UIs to the given length (default 512) (default 512) 97 --stats_backend string The name of the registered push-based monitoring/stats backend to use 98 --stats_combine_dimensions string List of dimensions to be combined into a single "all" value in exported stats vars 99 --stats_common_tags strings Comma-separated list of common tags for the stats backend. It provides both label and values. Example: label1:value1,label2:value2 100 --stats_drop_variables string Variables to be dropped from the list of exported variables. 101 --stats_emit_period duration Interval between emitting stats to all registered backends (default 1m0s) 102 --stderrthreshold severity logs at or above this threshold go to stderr (default 1) 103 --tablet_dir string The directory within the vtdataroot to store vttablet/mysql files. Defaults to being generated by the tablet uid. 104 --tablet_grpc_ca string the server ca to use to validate servers when connecting 105 --tablet_grpc_cert string the cert to use to connect 106 --tablet_grpc_crl string the server crl to use to validate server certificates when connecting 107 --tablet_grpc_key string the key to use to connect 108 --tablet_grpc_server_name string the server name to use to validate server certificate 109 --tablet_health_keep_alive duration close streaming tablet health connection if there are no requests for this long (default 5m0s) 110 --tablet_manager_grpc_ca string the server ca to use to validate servers when connecting 111 --tablet_manager_grpc_cert string the cert to use to connect 112 --tablet_manager_grpc_concurrency int concurrency to use to talk to a vttablet server for performance-sensitive RPCs (like ExecuteFetchAs{Dba,AllPrivs,App}) (default 8) 113 --tablet_manager_grpc_connpool_size int number of tablets to keep tmclient connections open to (default 100) 114 --tablet_manager_grpc_crl string the server crl to use to validate server certificates when connecting 115 --tablet_manager_grpc_key string the key to use to connect 116 --tablet_manager_grpc_server_name string the server name to use to validate server certificate 117 --tablet_manager_protocol string Protocol to use to make tabletmanager RPCs to vttablets. (default "grpc") 118 --tablet_protocol string Protocol to use to make queryservice RPCs to vttablets. (default "grpc") 119 --tablet_refresh_interval duration Tablet refresh interval. (default 1m0s) 120 --tablet_refresh_known_tablets Whether to reload the tablet's address/port map from topo in case they change. (default true) 121 --tablet_url_template string Format string describing debug tablet url formatting. See getTabletDebugURL() for how to customize this. (default "http://{{.GetTabletHostPort}}") 122 --topo_consul_lock_delay duration LockDelay for consul session. (default 15s) 123 --topo_consul_lock_session_checks string List of checks for consul session. (default "serfHealth") 124 --topo_consul_lock_session_ttl string TTL for consul session. 125 --topo_consul_watch_poll_duration duration time of the long poll for watch queries. (default 30s) 126 --topo_etcd_lease_ttl int Lease TTL for locks and leader election. The client will use KeepAlive to keep the lease going. (default 30) 127 --topo_etcd_tls_ca string path to the ca to use to validate the server cert when connecting to the etcd topo server 128 --topo_etcd_tls_cert string path to the client cert to use to connect to the etcd topo server, requires topo_etcd_tls_key, enables TLS 129 --topo_etcd_tls_key string path to the client key to use to connect to the etcd topo server, enables TLS 130 --topo_global_root string the path of the global topology data in the global topology server 131 --topo_global_server_address string the address of the global topology server 132 --topo_implementation string the topology implementation to use 133 --topo_k8s_context string The kubeconfig context to use, overrides the 'current-context' from the config 134 --topo_k8s_kubeconfig string Path to a valid kubeconfig file. When running as a k8s pod inside the same cluster you wish to use as the topo, you may omit this and the below arguments, and Vitess is capable of auto-discovering the correct values. https://kubernetes.io/docs/tasks/access-application-cluster/access-cluster/#accessing-the-api-from-a-pod 135 --topo_k8s_namespace string The kubernetes namespace to use for all objects. Default comes from the context or in-cluster config 136 --topo_read_concurrency int Concurrency of topo reads. (default 32) 137 --topo_zk_auth_file string auth to use when connecting to the zk topo server, file contents should be <scheme>:<auth>, e.g., digest:user:pass 138 --topo_zk_base_timeout duration zk base timeout (see zk.Connect) (default 30s) 139 --topo_zk_max_concurrency int maximum number of pending requests to send to a Zookeeper server. (default 64) 140 --topo_zk_tls_ca string the server ca to use to validate servers when connecting to the zk topo server 141 --topo_zk_tls_cert string the cert to use to connect to the zk topo server, requires topo_zk_tls_key, enables TLS 142 --topo_zk_tls_key string the key to use to connect to the zk topo server, enables TLS 143 --tracer string tracing service to use (default "noop") 144 --tracing-enable-logging whether to enable logging in the tracing service 145 --tracing-sampling-rate float sampling rate for the probabilistic jaeger sampler (default 0.1) 146 --tracing-sampling-type string sampling strategy to use for jaeger. possible values are 'const', 'probabilistic', 'rateLimiting', or 'remote' (default "const") 147 --v Level log level for V logs 148 -v, --version print binary version 149 --vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging 150 --vtctl_healthcheck_topology_refresh duration refresh interval for re-reading the topology (default 30s) 151 --vtctld_sanitize_log_messages When true, vtctld sanitizes logging.