Skip to content

Commit e716723

Browse files
committed
New configuration options failover.log.to and failover.log.file added in config reference
Fixes #4657
1 parent 52cbbf7 commit e716723

File tree

1 file changed

+51
-0
lines changed

1 file changed

+51
-0
lines changed

doc/reference/configuration/configuration_reference.rst

+51
Original file line numberDiff line numberDiff line change
@@ -1646,13 +1646,64 @@ The ``failover`` section defines parameters related to a :ref:`supervised failov
16461646

16471647
``failover`` can be defined in the global :ref:`scope <configuration_scopes>` only.
16481648

1649+
- :ref:`failover.call_timeout <configuration_reference_failover_log_to>`
1650+
- :ref:`failover.call_timeout <configuration_reference_failover_log_file>`
16491651
- :ref:`failover.call_timeout <configuration_reference_failover_call_timeout>`
16501652
- :ref:`failover.connect_timeout <configuration_reference_failover_connect_timeout>`
16511653
- :ref:`failover.lease_interval <configuration_reference_failover_lease_interval>`
16521654
- :ref:`failover.probe_interval <configuration_reference_failover_probe_interval>`
16531655
- :ref:`failover.renew_interval <configuration_reference_failover_renew_interval>`
16541656
- :ref:`failover.stateboard.* <configuration_reference_failover_stateboard>`
16551657

1658+
.. _configuration_reference_failover_log_to:
1659+
1660+
.. confval:: failover.log.to
1661+
1662+
**Since:** :doc:`3.3.0 </release/3.3.0>`
1663+
1664+
.. admonition:: Enterprise Edition
1665+
:class: fact
1666+
1667+
Configuring ``failover.log.to`` and ``failover.log.file`` parameters is available in the `Enterprise Edition <https://www.tarantool.io/compare/>`_ only.
1668+
1669+
Define a location Tarantool sends failover logs.
1670+
This option accepts the following values:
1671+
1672+
* ``stderr``: write logs to the standard error stream.
1673+
* ``file``: write logs to a file (see :ref:`failover.log.file <configuration_reference_failover_log_file>`).
1674+
1675+
|
1676+
| Type: string
1677+
| Default: 'stderr'
1678+
| Environment variable: TT_FAILOVER_LOG_TO
1679+
1680+
1681+
.. _configuration_reference_failover_log_file:
1682+
1683+
.. confval:: failover.log.file
1684+
1685+
**Since:** :doc:`3.3.0 </release/3.3.0>`
1686+
1687+
Specify a file for failover logs destination.
1688+
To write logs to a file, you need to set :ref:`failover.log.to <configuration_reference_failover_log_to>` to ``file``.
1689+
Otherwise, ``failover.log.file`` is ignored.
1690+
1691+
**Example**
1692+
1693+
The example below shows how to write failover logs to a file placed in the specified directory:
1694+
1695+
.. code-block:: yaml
1696+
1697+
failover:
1698+
log:
1699+
to: file
1700+
file: var/log/failover.log
1701+
1702+
|
1703+
| Type: string
1704+
| Default: nil
1705+
| Environment variable: TT_FAILOVER_LOG_FILE
1706+
16561707
.. _configuration_reference_failover_call_timeout:
16571708

16581709
.. confval:: failover.call_timeout

0 commit comments

Comments
 (0)