configuration: Add section regarding JSON formatted access logs

Signed-off-by: Andrew Clayton <[email protected]>

Author: ac000

source/configuration/index.rst

@@ -5679,6 +5679,31 @@ to define the log format:
        }
    }
 
+===============
+JSON log format
+===============
+
+Starting with NGINX Unit 1.34.0, `format` can instead be an object describing
+JSON field name/value pairs, e.g.,
+
+.. code-block:: json
+
+  {
+      "access_log": {
+          "path": "/tmp/access.log",
+          "format": {
+              "remote_addr": "$remote_addr",
+              "time_local": "$time_local",
+              "request_line": "$request_line",
+              "status": "$status",
+              "body_bytes_sent": "$body_bytes_sent",
+              "header_referer": "$header_referer",
+              "header_user_agent": "$header_user_agent"
+          }
+      }
+  }
+
+The JSON *values* support being strings, variables and JavaScript.
 
 ======================
 Conditional access log
@@ -5738,4 +5763,4 @@ Example with njs and the use of a template literal:
          "if": "`${uri == '/health' ? false : true}`",
          "path": "..."
       }
-   }
+   }