Logging - update per review

Author: andreyaksenov

doc/book/admin/logs.rst

@@ -3,7 +3,7 @@
 Logs
 ====
 
-Each Tarantool instance logs important events to its own log file ``<instance-name>.log``.
+Each Tarantool instance logs important events to its own log file.
 For instances started with :ref:`tt <tt-cli>`, the log location is defined by
 the ``log_dir`` parameter in the :ref:`tt configuration <tt-config>`.
 By default, it's ``/var/log/tarantool`` in the ``tt`` :ref:`system mode <tt-config_modes>`,
@@ -43,7 +43,7 @@ Then check the logs:
 Log rotation
 ------------
 
-When :ref:`logging to a file <cfg_logging-log>`, the system administrator must ensure
+When :ref:`logging to a file <configuration_reference_log_file>`, the system administrator must ensure
 logs are rotated timely and do not take up all the available disk space.
 The recommended way to prevent log files from growing infinitely is using an external
 log rotation program, for example, ``logrotate``, which is pre-installed on most
@@ -78,22 +78,16 @@ To learn about log rotation in the deprecated ``tarantoolctl`` utility,
 check its :ref:`documentation <tarantoolctl-log-rotation>`.
 
 
-.. _admin-logs-formats:
+.. _admin-logs-destination:
 
-Log formats
------------
+Log destination
+---------------
 
-Tarantool can write its logs to a log file, to ``syslog``, or to a specified program
-through a pipe.
-
-File is the default log format for ``tt``. To send logs to a pipe or ``syslog``,
-specify the :ref:`log.to <configuration_reference_log_to>` parameter, for example:
+Tarantool can write its logs to a log file, to ``syslog``, or to a specified program through a pipe.
+For example, to send logs to ``syslog``, specify the :ref:`log.to <configuration_reference_log_to>` parameter as follows:
 
 ..  literalinclude:: /code_snippets/snippets/config/instances.enabled/log_syslog/config.yaml
     :language: yaml
     :start-at: log:
     :end-at: 127.0.0.1:514
     :dedent:
-
-In such configurations, log rotation is usually handled by the external program
-used for logging.

doc/reference/configuration/configuration_reference.rst

@@ -1909,8 +1909,8 @@ To handle logging in your application, use the :ref:`log module <log-module>`.
 
     *   ``stderr``: write logs to the standard error stream.
     *   ``file``: write logs to a file (see :ref:`log.file <configuration_reference_log_file>`).
-    *   ``pipe``: start a program and write logs to it (see :ref:`log.pipe <configuration_reference_log_pipe>`).
-    *   ``syslog``: write audit logs to a system logger (see :ref:`log.syslog.* <configuration_reference_log_syslog>`).
+    *   ``pipe``: start a program and write logs to its standard input (see :ref:`log.pipe <configuration_reference_log_pipe>`).
+    *   ``syslog``: write logs to a system logger (see :ref:`log.syslog.* <configuration_reference_log_syslog>`).
 
     |
     | Type: string
@@ -1924,6 +1924,7 @@ To handle logging in your application, use the :ref:`log module <log-module>`.
 
     Specify a file for logs destination.
     To write logs to a file, you need to set :ref:`log.to <configuration_reference_log_to>` to ``file``.
+    Otherwise, ``log.file`` is ignored.
 
     **Example**
 
@@ -2147,8 +2148,8 @@ To handle logging in your application, use the :ref:`log module <log-module>`.
 
 ..  confval:: log.pipe
 
-    Specify a pipe for logs destination.
-    To write logs to a pipe, you need to set :ref:`log.to <configuration_reference_log_to>` to ``pipe``.
+    Start a program and write logs to its standard input (``stdin``).
+    To send logs to a program's standard input, you need to set :ref:`log.to <configuration_reference_log_to>` to ``pipe``.
 
     **Example**
 
@@ -2203,7 +2204,10 @@ log.syslog.*
 ..  confval:: log.syslog.server
 
     Set a location of a syslog server.
-    This option accepts an IPv4 address or Unix socket path starting with ``unix:``.
+    This option accepts one of the following values:
+
+    *   An IPv4 address. Example: ``127.0.0.1:514``.
+    *   A Unix socket path starting with ``unix:``. Examples: ``unix:/dev/log`` on Linux or ``unix:/var/run/syslog`` on macOS.
 
     To write logs to syslog, you need to set :ref:`log.to <configuration_reference_log_to>` to ``syslog``.