audit log: apply review suggestions

Author: xuniq

doc/code_snippets/snippets/config/instances.enabled/audit_log/myapp.lua

@@ -2,7 +2,7 @@
 
 -- Create space
 function create_space()
-    box.schema.space.create('Bands')
+    box.schema.space.create('bands')
     box.space.bands:format({
         { name = 'id', type = 'unsigned' },
         { name = 'band_name', type = 'string' },

doc/enterprise/audit_log.rst

@@ -617,9 +617,9 @@ Tips
 How many events can be recorded?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you write to a file, the size of the Tarantool audit module is limited by the disk space.
-If you write to a system logger, the size of the Tarantool audit module is limited by the system logger.
-If you write to a pipe, the size of the Tarantool audit module is limited by the system buffer.
+If you write to a file, the size of the Tarantool audit log is limited by the disk space.
+If you write to a system logger, the size of the Tarantool audit log is limited by the system logger.
+If you write to a pipe, the size of the Tarantool audit message is limited by the system buffer.
 If the ``audit_log.nonblock = false``, if ``audit_log.nonblock`` = ``true``, there is no limit.
 However, it is not recommended to use the entire memory, as this may cause performance degradation
 and even loss of some logs.

doc/reference/configuration/configuration_reference.rst

@@ -80,9 +80,17 @@ The ``audit_log`` section defines configuration parameters related to :ref:`audi
     *   Event names (for example, ``password_change``). For details, see :ref:`Audit log events <audit-log-events>`.
     *   Event groups (for example, ``audit``).  For details, see :ref:`Event groups <audit-log-event-groups>`.
 
-    The option contains either one value from above or a combination of them.
+    The option contains either one value from ``Possible values`` section (see below) or a combination of them.
 
-    To enable :ref:`user-defined audit log events <audit-log-custom>`, specify the ``custom`` value in this option.
+    To enable :ref:`custom audit log events <audit-log-custom>`, specify the ``custom`` value in this option.
+
+    **Example**
+
+    ..  literalinclude:: /code_snippets/snippets/config/instances.enabled/audit_log/myapp.lua
+        :language: lua
+        :start-at: filter:
+        :end-at: custom ]
+        :dedent:
 
     |
     | Type: array
@@ -218,7 +226,7 @@ The ``audit_log`` section defines configuration parameters related to :ref:`audi
 
 ..  confval:: audit_log.syslog_identity
 
-    Specify an arbitrary string that will be placed at the beginning of all messages.
+    Specify an application name to show in logs.
     You can enable logging to a system logger using the :ref:`audit_log.to <configuration_reference_audit_to>` option.
 
     See also: :ref:`syslog configuration example <configuration_reference_audit_syslog-example>`.
@@ -314,7 +322,7 @@ The ``audit_log`` section defines configuration parameters related to :ref:`audi
 
     -   ``devnull``: disable audit logging.
     -   ``file``: write audit logs to a file (see :ref:`audit_log.file <configuration_reference_audit_file>`).
-    -   ``pipe``: write audit logs to a pipe (see :ref:`audit_log.pipe <configuration_reference_audit_pipe>`).
+    -   ``pipe``: start a program and write audit logs to it (see :ref:`audit_log.pipe <configuration_reference_audit_pipe>`).
     -   ``syslog``: write audit logs to a system logger (see :ref:`audit_log.syslog <configuration_reference_audit_pipe>`).
 
     By default, audit logging is disabled.