Configuration file¶
Note
You are not reading the most recent version of this documentation. Go to the latest version of Scylla Manager Documentation.
Scylla Manager has a single configuration file /etc/scylla-manager/scylla-manager.yaml
.
Note that the file will open as read-only unless you edit it as the root user or by using sudo.
Usually, there is no need to edit the configuration file.
HTTP/HTTPS server settings¶
With server settings, you may specify if Scylla Manager should be available over HTTP, HTTPS, or both.
# Bind REST API to the specified TCP address using HTTP protocol.
# http: 127.0.0.1:56080
# Bind REST API to the specified TCP address using HTTPS protocol.
https: 127.0.0.1:56443
Prometheus settings¶
# Bind prometheus API to the specified TCP address using HTTP protocol.
# By default it binds to all network interfaces, but you can restrict it
# by specifying it like this 127:0.0.1:56090 or any other combination
# of ip and port.
prometheus: ':56090'
If changing prometheus IP or port, please remember to adjust rules in prometheus server.
- targets:
- IP:56090
Debug endpoint settings¶
In this section, you can specify the pprof debug server address.
It allows you to run profiling on demand on a live application.
By default, the server is running on port 56112
.
debug: 127.0.0.1:56112
Logging settings¶
Logging settings specify log output and level.
# Logging configuration.
logger:
# Where to output logs, syslog or stderr.
mode: syslog
# Available log levels are error, info, and debug.
level: info
Database settings¶
Database settings allow for using a remote cluster to store Scylla Manager data.
# Scylla Manager database, used to store management data.
database:
hosts:
- 127.0.0.1
# Enable or disable client/server encryption.
# ssl: false
#
# Database credentials.
# user: user
# password: password
#
# Local datacenter name, specify if using a remote, multi-dc cluster.
# local_dc:
#
# Database connection timeout.
# timeout: 600ms
#
# Keyspace for management data, for create statement see /etc/scylla-manager/create_keyspace.cql.tpl.
# keyspace: scylla_manager
# replication_factor: 1
# Optional custom client/server encryption options.
#ssl:
# CA certificate used to validate server cert. If not set, will use he host's root CA set.
# cert_file:
#
# Verify the hostname and server cert.
# validate: true
#
# Client certificate and key in PEM format. It has to be provided when
# client_encryption_options.require_client_auth=true is set on server.
# user_cert_file:
# user_key_file
Health check settings¶
Health check settings let you specify the timeout threshold.
If there is no response from a node after this time period is reached, the status report (sctool status
) shows the node as DOWN
.
# Healthcheck service configuration.
#healthcheck:
# Timeout for CQL status checks.
# timeout: 250ms
# ssl_timeout: 750ms
Backup settings¶
Backup settings let you specify backup parameters.
# Backup service configuration.
#backup:
# Minimal amount of free disk space required to take a snapshot.
# disk_space_free_min_percent: 10
#
# Maximal time for a backup run to be considered fresh and can be continued from
# the same snapshot. If exceeded, a new run with a new snapshot will be created.
# Zero means no limit.
# age_max: 12h
Repair settings¶
Repair settings let you specify repair parameters.
# Repair service configuration.
#repair:
# Number of segments repaired by Scylla in a single repair command. Increase
# this value to make repairs faster, note that this may result in increased load
# on the cluster.
# segments_per_repair: 1
#
# Maximal number of shards on a host repaired at the same time. By default all
# shards are repaired in parallel.
# shard_parallel_max: 0
#
# Maximal allowed number of failed segments per shard. In case of a failure
# to repair a segment Scylla Manager will try to repair it multiple times
# depending on the specified number of retries (default 3). If the
# shard_failed_segments_max limit is exceeded repair task will immediately
# fail, and the next repair run will start the repair procedure from the beginning.
# shard_failed_segments_max: 25
#
# In case of an error, hold back repair for the specified amount of time.
# error_backoff: 5m
#
# Frequency Scylla Manager poll Scylla node for repair command status.
# poll_interval: 200ms
#
# Maximal time a paused repair is considered fresh and can be continued,
# if an exceeded repair will start from the beginning. Zero means no limit.
# age_max: 0
#
# Distribution of data among cores (shards) within a node.
# Copy value from Scylla configuration file.
# murmur3_partitioner_ignore_msb_bits: 12