From 2f6d00349139ed2f9e5223e89e59c2381ade786c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Markus=20M=C3=A4kel=C3=A4?= Date: Mon, 2 Mar 2020 10:04:21 +0200 Subject: [PATCH] MXS-2832: Document failover timing estimates The worst-case time it takes for failover to start is now documented. --- Documentation/Monitors/MariaDB-Monitor.md | 49 +++++------------------ 1 file changed, 9 insertions(+), 40 deletions(-) diff --git a/Documentation/Monitors/MariaDB-Monitor.md b/Documentation/Monitors/MariaDB-Monitor.md index aa86d1cd4..5d14c80cd 100644 --- a/Documentation/Monitors/MariaDB-Monitor.md +++ b/Documentation/Monitors/MariaDB-Monitor.md @@ -1,45 +1,6 @@ # MariaDB Monitor -Table of Contents -================= - - * [Overview](#overview) - * [Master selection](#master-selection) - * [Configuration](#configuration) - * [Common Monitor Parameters](#common-monitor-parameters) - * [MariaDB Monitor optional parameters](#mariadb-monitor-optional-parameters) - * [assume_unique_hostnames](#assume_unique_hostnames) - * [detect_replication_lag](#detect_replication_lag) - * [detect_stale_master](#detect_stale_master) - * [detect_stale_slave](#detect_stale_slave) - * [mysql51_replication](#mysql51_replication) - * [multimaster](#multimaster) - * [ignore_external_masters](#ignore_external_masters) - * [detect_standalone_master](#detect_standalone_master) - * [failcount](#failcount) - * [allow_cluster_recovery](#allow_cluster_recovery) - * [enforce_read_only_slaves](#enforce_read_only_slaves) - * [maintenance_on_low_disk_space](#maintenance_on_low_disk_space) - * [Cluster manipulation operations](#cluster-manipulation-operations) - * [Operation details](#operation-details) - * [Manual activation](#manual-activation) - * [Automatic activation](#automatic-activation) - * [Limitations and requirements](#limitations-and-requirements) - * [External master support](#external-master-support) - * [Configuration parameters](#configuration-parameters) - * [auto_failover](#auto_failover) - * [auto_rejoin](#auto_rejoin) - * [switchover_on_low_disk_space](#switchover_on_low_disk_space) - * [replication_user and replication_password](#replication_user-and-replication_password) - * [failover_timeout and switchover_timeout](#failover_timeout-and-switchover_timeout) - * [verify_master_failure and master_failure_timeout](#verify_master_failure-and-master_failure_timeout) - * [servers_no_promotion](#servers_no_promotion) - * [promotion_sql_file and demotion_sql_file](#promotion_sql_file-and-demotion_sql_file) - * [handle_events](#handle_events) - * [Troubleshooting](#troubleshooting) - * [Failover/switchover fails](#failoverswitchover-fails) - * [Slave detection shows external masters](#slave-detection-shows-external-masters) - * [Using the MariaDB Monitor With Binlogrouter](#using-the-mariadb-monitor-with-binlogrouter) +[TOC] ## Overview @@ -257,6 +218,14 @@ multiple valid master servers in the cluster. The default value is 5 failures. +The worst-case delay between the master failure and the start of the failover +can be estimated by summing up the timeout values and `monitor_interval` and +multiplying that by `failcount`: + +``` +(monitor_interval + backend_connect_timeout) * failcount +``` + ### `allow_cluster_recovery` Deprecated and unused as of MaxScale 2.3. Can be defined but is ignored.