access_mode

Определяет, как MySQL Router обрабатывает запросы только для чтения и чтения-записи. Если включено, запросы только для чтения направляются на серверы только для чтения, а запросы чтения-записи — на серверы чтения-записи. См. Раздел 3.5, «Разделение чтения/записи».

wait_for_my_writes

Запросы только для чтения ожидают завершения последней записи транзакции.

См. Раздел 3.5, «Разделение чтения/записи».

wait_for_my_writes_timeout

Максимальное время в секундах ожидания применения записанной транзакции целевым объектом read_only перед переключением на целевой объект read_write.

См. Раздел 3.5, «Разделение чтения/записи».

router_require_enforce

Если включено, MySQL Router извлекает значения, определенные в атрибуте router_requires пользователя в таблице.

Атрибут должен иметь следующий формат:

        {router_require: {value}}
      

Возможные значения:

event_source_name

Только для платформ Microsoft Windows. Определяет имя службы, используемое MySQL Router при запуске в качестве службы в Microsoft Windows. Это позволяет отличать службы при запуске нескольких экземпляров MySQL Router и их сообщения в журнале событий.

Например:

[DEFAULT]
event_source_name = MySQLRouterService

logging_folder

Путь к каталогу файла журнала MySQL Router. Файл журнала называется mysqlrouter.log, и он либо создается, либо к нему добавляется информация, если этот файл уже существует.

Установка пустого значения для logging_folder отправляет сообщения в консоль (stdout).

Пример, который отправляет журналы в /var/log/mysqlrouter/mysqlrouter.log:

[DEFAULT]
logging_folder = /var/log/mysqlrouter

При использовании параметра загрузки --directory, созданный файл конфигурации устанавливает его в $directory/log/.

plugin_folder

Путь к плагинам MySQL Router. Эта папка должна совпадать с каталогом установки MySQL Router. Вы должны устанавливать это значение только в случае пользовательской установки, где плагины находятся не в стандартном месте установки.

Значение по умолчанию: /usr/local/lib/mysqlrouter

runtime_folder

Путь к файлам времени выполнения MySQL Router.

Значение по умолчанию: /run/mysqlrouter

master-key-writer

Скрипт, который считывает главный ключ из STDIN. Устанавливается с помощью параметра загрузки командной строки --master-key-writer.

master-key-reader

Скрипт, который возвращает главный ключ в STDOUT. Устанавливается с помощью параметра загрузки командной строки --master-key-reader.

config_folder

Путь к файлам конфигурации MySQL Router.

Значение по умолчанию: /usr/local/etc/mysqlrouter

sinks

Приемник(и) (различные методы ведения журналов), в которые отправляется определенный уровень журнала.

Поддерживаемые значения приемника: consolelog, filelog, eventlog (в Windows) и syslog (в системах на основе Unix). Используйте список, разделенный запятыми, чтобы определить несколько значений.

Значение по умолчанию: filelog, если параметр logging_folder не пустой в разделе "[DEFAULT]", иначе consolelog.

Например, чтобы настроить регистратор для использования файла, консоли и журнала событий, каждый из которых использует уровень журнала отладки, настроенный в разделе [logger]:

[logger]
level=debug
sinks=consolelog,eventlog,filelog

keyring_path

Указывает на расположение файла keyring.

Системная загрузка не добавляет этот параметр в созданный конфигурационный файл и предполагает, что файл keyring находится в системном каталоге состояния времени выполнения. Если также используется --directory, то файл keyring хранится в каталоге состояния времени выполнения этого экземпляра, в run/ в указанном каталоге.

Если этот параметр не определен, используются системные пути по умолчанию.

Пример использования:

keyring_path = /opt/myrouter/data/keyring
master_key_path = /opt/myrouter/mysqlrouter.key

master_key_path

Расположение файла master key. Этот параметр позволяет выполнять автоматическое расшифрование, так как в противном случае его расположение запрашивается при запуске.

Если этот параметр не указан, используются системные пути по умолчанию.

Пример использования:

keyring_path = /opt/myrouter/data/keyring
master_key_path = /opt/myrouter/mysqlrouter.key

unknown_config_option

Определяет поведение MySQL Router при обработке неизвестных параметров конфигурации, таких как опечатки.

Поведение по умолчанию — предупреждение, а при загрузке оно определяется как ошибка в созданном конфигурационном файле. Предупреждение регистрирует предупреждающее сообщение, но не приводит к остановке, тогда как ошибка означает, что MySQL Router не может инициализироваться и завершается.

[DEFAULT]
unknown_config_option=warning

user (system)

Запустите mysqlrouter от имени пользователя с именем user_name или числовым идентификатором пользователя user_id. “User” в данном контексте относится к учетной записи входа в систему, а не к пользователю MySQL, указанному в таблицах прав доступа. Это также можно назначить во время выполнения с помощью параметра командной строки --user.

В Linux при установке Router с помощью официальных пакетов DEB или RPM создается локальный системный пользователь и группа с именем "mysqlrouter" на хосте, и MySQL Router запускается от имени этого пользователя по умолчанию. Эта учетная запись не имеет доступа к оболочке, а ее домашний каталог указывает на каталог, в котором хранится файл конфигурации по умолчанию.

Цель этого параметра — запуск MySQL Router от имени пользователя с ограниченными системными правами. Если пользователь не существует в системе или предпринимается попытка запустить Router от имени root, выводится сообщение об ошибке, и Router завершается.

MySQL Router может быть загружен и выполнен под любым пользователем операционной системы и не требует специальных привилегий, кроме прав чтения и записи для своих собственных файлов. К файлам, к которым он обращается, относятся плагины (чтение/выполнение), конфигурационный файл, журналы, файлы сокетов домена UNIX (если включено) и многое другое.

По умолчанию конфигурационные и журнальные файлы записываются в общесистемное расположение, такое как /etc и /var/log. В качестве альтернативы Router может быть загружен в автономный каталог с помощью параметра --directory. Например:

$> sudo mysqlrouter --bootstrap localhost:3310 --directory /a/path/myrouter --user snoopy

В этом примере Router создает /a/path/myrouter и добавляет сюда все созданные файлы и каталоги, и только системный пользователь snoopy может записывать в них. Кроме того, user определяется в созданном конфигурационном файле /a/path/myrouter/mysqlrouter.conf:

[DEFAULT]
user=snoopy

ssl_ca

Путь к файлу SSL CA для проверки сертификата сервера при подключении к серверам метаданных.

Может быть установлен с помощью параметра загрузки --ssl-ca.

ssl_capath

Путь к каталогу, содержащему файлы SSL CA для проверки сертификата сервера при подключении к серверам метаданных.

Может быть установлен с помощью параметра загрузки --ssl-capath.

ssl_crl

Путь к файлу SSL CRL, который используется при подключении к серверам метаданных и проверке их сертификата SSL.

Может быть установлен с помощью параметра загрузки --ssl-crl.

ssl_crlpath

Путь к каталогу, содержащему файлы SSL CRL, которые используются при подключении к серверам метаданных и проверке их сертификата SSL.

Может быть установлен с помощью параметра загрузки --ssl-crlpath.

tls_version

Список версий TLS, разделенных запятыми, которые необходимо запросить, например, 'TLSv1.2,TLSv1.3', если SSL включен.

Может быть установлен с помощью параметра загрузки --tls-version.

bind_address

Информация, связанная с дополнительным параметром bind_address:

Пример использования:

bind_address = 127.0.0.1:7001

bind_port

Необязательно, вы можете определить порт по умолчанию для bind_address с помощью bind_port. Если порт не настроен в bind_address, то bind_port обязателен и используется.

Необязательно задайте эти значения, используя опцию запуска --conf-base-port.

Три примера ниже приведут к bind_address = 127.0.0.1:7001

[routing:example_1]
bind_port = 7001

[routing:example_2]
bind_port = 7001
bind_address = 127.0.0.1

[routing:example_3]
bind_address = 127.0.0.1:7001

socket

Сокеты включаются с помощью опции socket, которую можно указать с TCP-опциями bind_port и bind_address или без них. Пример:

[routing]
socket = /tmp/mysqlrouter.sock
destinations = a.example.com:3306,b.example.com:3307

При запуске MySQL Router Router откажется от запуска, если файл сокета уже существует или в него нельзя записать.

Допустимы относительные пути, основанные на текущем рабочем каталоге, где запущен Router.

Router может одновременно прослушивать как TCP-сокеты, так и Unix-сокеты. Например, следующий пример конфигурации [routing] является корректным и настраивает Router для прослушивания соединений как на localhost:1234, так и на /tmp/mysqlrouter.sock:

[routing:my_redirect]
bind_address = localhost:1234
socket = /tmp/mysqlrouter.sock
destinations = localhost:57121, localhost:57122, localhost:57123

protocol

Используется плагином маршрутизации при подключении к целевому серверу MySQL и может быть установлено в «classic» (по умолчанию) или «x» (протокол X).

Пример использования:

[routing:basic_failover]
bind_port = 7001
destinations = 10.20.200.1:33060, 10.20.200.2:33060
protocol = x

Опция protocol также влияет на порт по умолчанию, используемый каждым целевым сервером. Если порт целевого сервера не настроен, то порт по умолчанию — 3306 для «classic» (по умолчанию) и 33060 для «x» (протокол X).

pid_file

Устанавливает расположение файла PID. Это можно задать тремя способами (в порядке приоритета): опцией командной строки --pid-file, установив опцию pid_file в файле конфигурации Router или определив переменную среды ROUTER_PID.

Если задано --bootstrap, определения pid_file и ROUTER_PID игнорируются. Это отличается от опции командной строки --pid-file, которая вызывает ошибку Router.

Если --bootstrap не задано, то следующие причины вызовут ошибку Router: файл --pid-file уже существует, pid_file или ROUTER_PID установлены, но пусты, или Router не может записать файл PID.

connect_timeout

Значение тайм-аута, используемое MySQL Router при подключении к целевому серверу MySQL. Значение не может быть неограниченным, и неверное значение приводит к ошибке конфигурации. Допустимый диапазон составляет от 1 до 65536. Это значение следует держать низким.

Пример использования:

[routing]
connect_timeout = 5

Может быть задано при запуске с помощью --conf-set-option=routing.connect_timeout.

connect_timeout

Значение тайм-аута, используемое MySQL Router при подключении к серверу метаданных MySQL.

Пример использования:

[DEFAULT]
connect_timeout = 5

Может быть задано при запуске с помощью либо --connect-timeout, либо --conf-set-option=DEFAULT.connect_timeout.

read_timeout

Значение тайм-аута, используемое MySQL Router при чтении из сервера метаданных MySQL. Значение по умолчанию — 30 секунд.

Пример использования:

[DEFAULT]
read_timeout = 30

destinations

Предоставляет информацию о хосте для установления соединений. Принимает либо список адресов пунктов назначения, разделенных запятыми, либо ссылку на кэш метаданных InnoDB кластера. Адреса пунктов назначения могут быть комбинацией вида hostname[:port], ip-address[:port] или local: URI для Unix-сокеттов.

Пример использования со специфическими хостами (статический маршрутизации):

destinations = a.example.com,b.example.com,c.example.com

Пример использования с Unix-сокеттом:

destinations=local:/tmp/mysql.sock

Специфика поддержки Unix-сокеттов:

Пример использования с кэшем метаданных кластера InnoDB:

destinations=metadata-cache://mycluster/default?role=PRIMARY

Доступные параметры URI:

dynamic_state

Этот параметр отслеживает и хранит адреса активных серверов метаданных MySQL InnoDB кластера и загружает их при перезапуске Router. Эта функциональность активируется параметром --bootstrap.

Инициализация определяет параметр dynamic_state в файле mysqlrouter.conf в разделе [DEFAULT]. Значение – путь к JSON-файлу с именем state.json, который создаётся после инициализации Router. Файл state.json инициализируется адресами серверов метаданных InnoDB кластера и идентификатором группы репликации (group_replication_name, возвращаемым InnoDB кластером); дополнительная информация добавляется и обновляется во время работы Router.

Пример записи mysqlrouter.conf:

[DEFAULT]
dynamic_state=/opt/myrouter/data/state.json

Пример state.json, сгенерированный --bootstrap:

{
    "metadata-cache": {
        "group-replication-id": "4b9e817a-0254-11e9-9cc0-080027bb5030",
        "cluster-metadata-servers": [
            "mysql://localhost:3310",
            "mysql://localhost:3320",
            "mysql://localhost:3330"
        ]
    },
    "version": "1.0.0"
}

routing_strategy

Стратегия маршрутизации определяет, как MySQL Router выбирает серверы MySQL для подключения.

Доступные стратегии:

Недоступные пункты назначения помещаются в карантин и пропускаются, а их доступность проверяется каждые error_quarantine_interval секунд. Все стратегии маршрутизации, кроме next-available, используют это поведение.

Значения role по умолчанию и доступные комбинации:

max_connections

Каждый маршрут может ограничивать количество маршрутов или подключений. Одно из возможных применений — предотвращение возможных атак типа «отказ в обслуживании» (DoS). Значение по умолчанию — 512, а допустимый диапазон — от 1 до 65536.

Это аналогично системной переменной сервера.

[routing:mycluster_default_rw]
max_connections = 512

В качестве альтернативы используйте новый параметр конфигурации max_total_connections, который устанавливает одно значение для всех разделов маршрутизатора вместе.

Максимальное значение зависит как от ограничений системы опроса (или linux_epoll), так и от количества доступных ядер/потоков процессора. См. также параметры конфигурации [IO] backend и threads.

При необходимости установка max_connections в разделе [DEFAULT] устанавливает значение по умолчанию для каждого пункта назначения маршрутизации.

max_total_connections

Максимальное количество подключений клиентов, обрабатываемых маршрутизатором, для предотвращения исчерпания дескрипторов файлов.

Это аналогично системной переменной сервера.

[DEFAULT]
max_total_connections = 512

Значение по умолчанию — 512, оно задается в разделе [DEFAULT].

thread_stack_size

Размер стека, выделенный для каждого потока. Измеряется в килобайтах и по умолчанию равен 64.

[DEFAULT]
thread_stack_size=128

net_buffer_length

Устанавливает параметр MySQL-сервера.

max_connect_errors

Значение по умолчанию — 100, допустимый диапазон — от 1 до 2³² (4294967295, беззнаковое целое).

Это аналогично системной переменной сервера.

Это может немного снизить производительность, если приложение выполняет частые повторные подключения, так как MySQL Router пытается определить, существуют ли ошибки, связанные с подключением.

Успешное подключение сбрасывает счетчик ошибок.

У каждого маршрута есть свой собственный список заблокированных хостов. Заблокированные клиенты получают ошибку MySQL Server 1129 с немного другим сообщением об ошибке: «1129: Слишком много ошибок подключения с fail.example.com». В журнале Router содержится дополнительная информация о заблокированных клиентах, например: INFO [...] 1 ошибки аутентификации для fail.example.com (максимум 100) WARNING [...] блокирование клиента-хоста fail.example.com

max_connect_errors = 100

client_connect_timeout

Это аналогично системной переменной сервера.

Значение по умолчанию — 9, на единицу меньше значения по умолчанию MySQL 5.7. Допустимый диапазон — от 2 до 31536000.

client_connect_timeout = 9

auth_cache_refresh_interval

Время (в секундах) между попытками обновления кэша аутентификации. По умолчанию 2. Значение должно быть меньше auth_cache_ttl и больше ttl, иначе Router не запустится.

Этот параметр применяется, если параметр http_auth_backend раздела backend установлен в metadata_cache; это функция Router REST API.

auth_cache_ttl

Время (в секундах) до истечения срока действия кэша, если он не обновлен. По умолчанию -1 (бесконечно). Значение должно быть больше auth_cache_refresh_interval и ttl, иначе Router не запустится.

Этот параметр применяется, если параметр http_auth_backend раздела backend установлен в metadata_cache; это функция Router REST API.

close_connection_after_refresh

Определяет, следует ли закрывать подключение к MySQL-серверу metadata_cache после обновления метаданных. По умолчанию 0.

Если close_connection_after_refresh=0, metadata_cache сохраняет подключение открытым после обновления метаданных, если известно, что следующее обновление происходит к тому же серверу и обновление прошло успешно.

Если close_connection_after_refresh=0 и metadata_cache знает, что следующее подключение будет к другому серверу или обновление завершилось ошибкой, то подключение закрывается после обновления. Максимально одно подключение остается открытым, даже если требуется подключение к нескольким серверам, как в случае с набором кластеров.

Если close_connection_after_refresh=1, подключение metadata_cache закрывается после обновления метаданных. Связанный параметр ttl управляет частотой проверки кэша метаданных.

[metadata_cache]
close_connection_after_refresh=0

router_id

Идентификатор MySQL Router.

server_ssl_cert

Имя файла сертификата открытого ключа SSL в формате PEM. Используется для обеспечения аутентификации на стороне сервера во время процесса загрузки.

server_ssl_key

Имя файла закрытого ключа SSL в формате PEM, используемого для шифрования соединений маршрутизатора с сервером. См. также Раздел 4.4, «Конфигурация TLS» .

server_ssl_curves

По умолчанию используется защищённый список кривых SSL. Сформируйте эту строку как список имён кривых, разделённых двоеточиями.

server_ssl_cipher

По умолчанию используется защищённый список шифров SSL. Сформируйте эту строку как список имён шифров, разделённых двоеточиями.

server_ssl_verify

Проверка сертификатов SSL, предоставленных сервером маршрутизатору.

server_ssl_mode

Режим соединения SSL, используемый при соединении между MySQL Router и сервером. См. также Раздел 4.4, «Конфигурация TLS» .

server_ssl_ca

Имя файла сертификата центра сертификации (ЦС) в формате PEM. Файл содержит список доверенных центров сертификации SSL. См. также Раздел 4.4, «Конфигурация TLS» .

server_ssl_capath

Имя каталога, содержащего файлы сертификатов доверенных центров сертификации SSL (ЦС) в формате PEM. См. также Раздел 4.4, «Конфигурация TLS» .

client_ssl_cert

Имя файла сертификата открытого ключа SSL в формате PEM. Используется для обеспечения аутентификации на стороне клиента во время процесса загрузки.

Как и -client_ssl_key, этот параметр используется только во время загрузки, которая использует учётную запись root. Это полезно, когда учётная запись root была создана с REQUIRE X509, и поэтому для входа в систему как root требуется, чтобы клиент аутентифицировал себя.

server_ssl_crlpath

Путь к каталогу, содержащему файлы списков отзыва сертификатов в формате PEM. См. также Раздел 4.4, «Конфигурация TLS» .

server_ssl_crl

Имя файла, содержащего списки отзыва сертификатов в формате PEM. См. также Раздел 4.4, «Конфигурация TLS» .

client_ssl_key

Имя файла закрытого ключа SSL в формате PEM, используемого для шифрования соединений клиента с маршрутизатором. См. также Раздел 4.4, «Конфигурация TLS» .

client_ssl_dh_params

Имя файла параметров DH. Если указано и не пусто, параметры DH из этого файла используются вместо внутренних параметров DH по умолчанию. Отформатируйте файл параметров DH в формате PEM.

client_ssl_curves

Какие кривые разрешены между клиентом и MySQL Router, по умолчанию используется защищённый список кривых SSL. Сформируйте эту строку как список имён кривых, разделённых двоеточиями.

client_ssl_cipher

Какие шифры разрешены между клиентом и MySQL Router, по умолчанию используется защищённый список шифров SSL. Сформируйте эту строку как список имён шифров, разделённых двоеточиями.

client_ssl_mode

Управляет тем, должны ли соединения от клиента к MySQL Router быть зашифрованы. См. также Раздел 4.4, «Конфигурация TLS» .

ssl_mode

Режим SSL для подключения к серверу метаданных MySQL. По умолчанию используется PREFERRED, если не задано иное.

При значении PREFERRED (по умолчанию) при запуске будет выведено предупреждение, если SSL не используется, а подключение к серверу метаданных не зашифровано.

Допустимые значения: DISABLED, PREFERRED, REQUIRED, VERIFY_CA и VERIFY_IDENTITY. Как и в случае с клиентом mysql, это значение нечувствительно к регистру.

Существует также параметр runtime для запуска; см. --ssl-mode.

user (MySQL)

Сгенерированный пользователь MySQL с правами доступа к схеме метаданных сервера MySQL. Пароль этого пользователя автоматически генерируется и хранится в зашифрованном ключевом хранилище. По умолчанию ключ шифрования для этого хранилища хранится в защищенном от чтения файле главного ключа, который определен в файле конфигурации. Чаще всего этот пользователь и связанный с ним пароль автоматически генерируются во время запуска. Соответствующие параметры командной строки — --force-password-validation и --password-retries. По умолчанию сгенерированный пароль проходит проверку на прочность STRONG validate_password.

Пароль полностью управляется Router и никогда не отображается, а хранится в локальной системе ключевых хранилищ, используя учетную запись операционной системы, под которой работает MySQL Router. Он может затем использоваться Router для подключения к InnoDB Cluster и получения текущей информации о топологии. Сессии между Router и сервером метаданных по умолчанию шифруются с помощью SSL.

Место хранения сгенерированных файлов ключевого хранилища зависит от того, как настроен запуск. Для автономных установок (когда используется --directory) он хранится в run/ в каталоге автономной установки. Для системных установок он хранится в системном каталоге состояния runtime, и этот путь специфичен для платформы. Дополнительную информацию можно найти в master_key_path и keyring_path

Этому пользователю назначены следующие привилегии (и они необходимы):

Privileges needed by the Router account:

	On Metadata Server:

		SELECT ON mysql_innodb_cluster_metadata.*

	On Target Replica Sets:

		SELECT ON performance_schema.replication_group_members
		SELECT ON performance_schema.replication_group_member_stats

Сгенерированное имя пользователя имеет следующий формат: mysql_router_{router_id}_[0-9a-z]{7}, где {router_id} — числовой идентификатор маршрутизатора, а [0-9a-z]{7} — 7 случайных символов строчных латинских букв и цифр. Идентификатор маршрутизатора повторно используется, если он уже присутствует в mysqlrouter.conf, и его значение не может превышать 4294967295 (2^32-1).

metadata_cluster

Название InnoDB Cluster.

use_gr_notifications

Включает уведомления Group Replication. При включении Router асинхронно получает уведомления о большинстве изменений кластера. Он может быть включен вручную в mysqlrouter.conf или включен там с помощью параметра командной строки --conf-use-gr-notifications во время запуска.

При получении Router любого из следующих уведомлений от Group Replication, он обновляет метаданные кластера:

При включении функция уведомлений Group Replication позволяет использовать более высокое значение ttl, поскольку обновления метаданных, выполняемые с интервалами ttl, становятся дополнительной защитой, а не основным способом поддержания актуальности информации о состоянии кластера. При отключении рекомендуется использовать низкое значение ttl (например, 0,5 с, по умолчанию), чтобы избежать избыточной нагрузки от повторного подключения к экземплярам и частого запроса данных о изменениях метаданных.

ttl

Время жизни (в секундах) информации в кэше метаданных.

Принимает целые или вещественные значения. Разрешение ограничено миллисекундами, где 0,001 соответствует одной миллисекунде. Точность усекается до поддерживаемого диапазона; например, TTL=0.0119 обрабатывается как 11 миллисекунд. Значение 0 означает, что модуль кэша метаданных постоянно запрашивает метаданные в тесном цикле.

Сопутствующий параметр close_connection_after_refresh контролирует, должно ли подключение metadata_cache к серверу MySQL закрываться или оставаться открытым после успешного обновления метаданных.

Значение должно быть меньше auth_cache_refresh_interval и auth_cache_ttl, в противном случае Router не запустится.

Единный поддерживаемый десятичный разделитель — «.» (точка), независимо от локали, а также поддерживается научная запись, например TTL=1.6E-2.

destination

Прямой вывод логов консоли в это устройство назначения; задается в разделе [consolelog]. По умолчанию /dev/stderr, пустое значение использует значение по умолчанию.

Допустимые значения: /dev/stdout, /dev/stderr и /dev/null; или CON и NUL в Windows.

[DEFAULT]
logging_folder=

[consolelog]
destination=/dev/null

filename

Перенаправить вывод журнала в определённый файл с именем filename, расположенный в каталоге logging_folder. Он должен быть определён как имя файла, а не путь к файлу, и работает как с разделами [logger], так и с [filelog].

Использование filename с [logger] для определения значения по умолчанию для раздела [filelog], а также изменяет файл журнала маршрутизатора с mysqlrouter.log на это новое значение.

[DEFAULT]
logging_folder=/path/to/logs/

[logger]
filename = router_error.log

Маршрутизатор не сообщает об ошибке, если filename установлен в разделе [logger], но не используется файловый регистратор.

Использование filename с [filelog]:

[DEFAULT]
logging_folder=/path/to/logs/

[filelog:a]
filename = a_router_error.log

[filelog:b]
filename = b_router_error.log

Если filename пуст или не установлен в разделе [filelog], то используется определение filename в разделе [logger]; и используется файл журнала по умолчанию (mysqlrouter.log), если filename не установлен ни в разделе [logger].

Соответственно, перенаправление вывода консоли в /dev/null:

[DEFAULT]
logging_folder=

[consolelog]
destination=/dev/null

level

Используйте плагин logger для регистрации уведомлений, ошибок и информации для отладки. Доступные уровни журнала: DEBUG, NOTE, INFO (по умолчанию), WARNING, ERROR, SYSTEM и FATAL. Эти значения нечувствительны к регистру.

Уровень INFO отображает все информационные сообщения, предупреждения и сообщения об ошибках. Уровень DEBUG отображает дополнительную диагностическую информацию из кода маршрутизатора, включая успешные маршруты. SYSTEM включает сообщения, такие как сообщения о запуске.

[logger]
level = DEBUG

Поведение вывода зависит от параметра logging_folder. Установка logging_folder в папку сохраняет файл журнала с именем mysqlrouter.log в эту папку. Установка logging_folder в пустое значение или его отсутствие выводит журнал в консоль. Он установлен в разделе [DEFAULT].

Загрузка принимает файл конфигурации с использованием --config и использует определение уровня журнала.

timestamp_precision

Точность метки времени журнала; доступные определения с примерами значений:

port

TCP-порт, прослушивающий HTTP-запросы; по умолчанию 8081.

bind_address

IP-адрес, привязанный к HTTP port; по умолчанию 0.0.0.0.

static_folder

Базовый каталог для запросов статических файлов; по умолчанию пуст. Пустое значение означает, что статические файлы не обслуживаются.

require_realm

Имя экземпляра [http_auth_realm].

ssl

Значение 1 включает SSL, а 0 отключает его. Требуются TLS-клиенты, поддерживающие TLSv1.2 или более поздние версии. Это определено в разделе [http_server].

ssl_cert

Имя файла сертификата и его цепочки сертификатов в формате PEM; требуется, если ssl=1. Это определено в разделе [http_server].

ssl_key

Имя файла ключа в формате PEM; требуется, если ssl=1. Это определено в разделе [http_server].

ssl_cipher

Спецификация шифра (см. список «шифров» openssl). По умолчанию используется разделенный запятыми список всех утвержденных шифров. Неизвестные шифры игнорируются без сообщений об ошибках. Возникает ошибка, если список шифров пуст и ssl=1. Это определено в разделе [http_server].

ssl_dh_param

Прочитать параметр DH из этого файла в формате PEM. По умолчанию используется dh-param из RFC 5114, если ssl=1. Это определено в разделе [http_server].

interval

Определяет частоту (в секундах), с которой MySQL Router отправляет сообщение ping keepalive. Общее количество ping-запросов определяется параметром конфигурации runs.

[keepalive]
interval = 42
runs = 0

runs

Ограничивает количество интервалов, в течение которых MySQL Router отправляет сообщение keepalive ping. Установка значения 0 (по умолчанию) означает, что он выполняется до тех пор, пока MySQL Router не будет выключен. Частота определяется параметром interval.

[keepalive]
interval = 42
runs = 0

backend

Бэкэнд IO, который обрабатывает асинхронные операции. Универсальный бэкэнд poll доступен на всех платформах, в то время как каждая платформа может предоставлять альтернативные бэкэнды.

Варианты: poll (все платформы) и linux_epoll (Linux). По умолчанию используется linux_epoll в Linux.

[io]
backend=linux_epoll
threads=32

threads

Количество потоков IO, которые обрабатывают соединения.

По умолчанию 0 (использует все доступные ядра/потоки ЦП), но также принимает число от 1 до 1024. Во время выполнения система может ограничить верхний предел за этим значением.

[io]
backend=linux_epoll
threads=32

connection_sharing_delay

Секунды ожидания, прежде чем неактивное серверное соединение станет доступно для повторного использования другим клиентским соединением.

См. Раздел 3.4, «Общий доступ к соединениям и повторное использование».

connection_sharing

Включать ли общий доступ к соединениям.

См. Раздел 3.4, «Общий доступ к соединениям и повторное использование».

idle_timeout

Секунды для хранения неактивного соединения в пуле соединений перед его закрытием. Этот параметр задается в разделе [connection_pool] и влияет на все маршруты в пуле соединений. По умолчанию 5, принимает значение от 1 до 4294967296.

max_idle_server_connections

Соединения, которые необходимо держать открытыми в пуле соединений после отключения клиента; и устанавливается в разделе [connection_pool]. Значение по умолчанию равно 0, что отключает пул соединений.

client_ssl_session_cache_mode

Включает или отключает кэш для сеансов TLS клиент-маршрутизатор.

client_ssl_session_cache_size

Определяет максимальное количество кэшированных сеансов. Если добавление нового сеанса в кэш приводит к тому, что количество кэшированных сеансов превышает заданный максимум, самый старый кэшированный сеанс отбрасывается, чтобы разрешить кэширование самого нового.

client_ssl_session_cache_timeout

Определяет максимальное время, в секундах, в течение которого сеанс остается в кэше. Если время ожидания истекло, и этот сезон не используется повторно, сеанс удаляется из кэша, а соединение закрывается.

server_ssl_session_cache_mode

Включает или отключает кэш для сеансов TLS маршрутизатор-сервер.

server_ssl_session_cache_size

Определяет максимальное количество кэшированных сеансов. Если добавление нового сеанса в кэш приводит к тому, что количество кэшированных сеансов превышает заданный максимум, самый старый кэшированный сеанс отбрасывается, чтобы разрешить кэширование самого нового.

server_ssl_session_cache_timeout

Время в секундах, по истечении которого сессии TLS удаляются из кэша сессий TLS сервера.

connect_retry_timeout

Если классическое соединение завершается неудачей с преходящей ошибкой, такой как max-connections reached, MySQL Router ожидает указанное количество секунд, прежде чем повторить попытку соединения. Повторная попытка соединения осуществляется в соответствии с заданной стратегией маршрутизации.

Если connect_retry_timeout не определено, по умолчанию используется 7 секунд. Если значение connect_retry_timeout выходит за пределы допустимого диапазона значений, MySQL Router не запустится.

Если соединение завершается неудачей с преходящей ошибкой после успешной аутентификации, повторная попытка соединения возможна только в том случае, если соединение клиент-маршрутизатор зашифровано с помощью TLS или имеет открытый ключ.

backend

Имя раздела [http_auth_backend].

method

Метод HTTP-аутентификации; по умолчанию используется basic.

name

Имя области, представленное пользователю для аутентификации.

require

Требует, чтобы пользователь прошел проверку с помощью серверной части аутентификации; по умолчанию используется valid-user, что включает эту проверку.

backend

Имя реализации серверной части; допустимые значения — file (по умолчанию) или metadata_cache.

[http_auth_backend:name]
backend=metadata_cache

[metadata_cache]
auth_cache_refresh_interval=2
auth_cache_ttl=-1

filename

Имя файла хранилища серверной части, указывается относительно каталога data_folder.

cluster_type

Тип объекта AdminAPI, с которым был запущен маршрутизатор, — это либо InnoDB ReplicaSet (rs), либо InnoDB Cluster (gr). Используйте 'gr' для кластерных наборов.

На этапе загрузки выполняется оценка целевого экземпляра, и этот параметр устанавливается соответствующим образом в сгенерированном конфигурационном файле.

error_quarantine_interval

Определяет интервал в секундах между проверками подключения к помещенному в карантин целевому узлу. Если подключение возможно, целевой узел перемещается из карантина и становится доступным для соединений.

Если задано недопустимое значение, MySQL Router не запустится, и в журнал будет записана ошибка.

Например:

        [destination_status]
         error_quarantine_threshold=5
         error_quarantine_interval=20
      

error_quarantine_threshold

Определяет порог неудачных попыток подключения к целевому узлу маршрутизации, после которого MySQL Router помещает целевой узел в карантин и прекращает его использование в качестве целевого узла, пока он не будет очищен механизмом карантина. Например, если значение установлено равным 5, целевой узел помещается в карантин после 5 последовательных неудачных попыток подключения к нему.

Если задано недопустимое значение, MySQL Router не запустится, и в журнал будет записана ошибка.

Например:

        [destination_status]
         error_quarantine_threshold=5
         error_quarantine_interval=20