From 0525e3cd9fa445c65f1906d38ba67a5b72d0152c Mon Sep 17 00:00:00 2001 From: "kedia,Akanksha" Date: Thu, 25 Jan 2024 20:56:06 +0530 Subject: [PATCH] Update Logging Properties Documentation Update documentation Cherry-pick of https://github.com/trinodb/trino/commit/047aab57738546cd5f0a1b0b71384cd45047001b#diff-a197d91dfd249f91aac3d130c0ff0f1e813651cfaf205c77b177b407db7435ab(trinodb/trino#4452) Co-authored-by: David Phillips --- .../src/main/sphinx/admin/properties.rst | 68 ++++++++++++++++++- 1 file changed, 67 insertions(+), 1 deletion(-) diff --git a/presto-docs/src/main/sphinx/admin/properties.rst b/presto-docs/src/main/sphinx/admin/properties.rst index 4c4de93937d00..b75014cc6dd2a 100644 --- a/presto-docs/src/main/sphinx/admin/properties.rst +++ b/presto-docs/src/main/sphinx/admin/properties.rst @@ -898,4 +898,70 @@ CTE Materialization Properties The name of the catalog to be used for Common Table Expressions (CTE) and which provides custom partitioning for Common Table Expression (CTE) materialization. This setting specifies which catalog should be used for CTE materialization and for determining how to partition the materialization of CTEs in queries. - This can also be specified on a per-query basis using the ``cte_partitioning_provider_catalog`` session property. \ No newline at end of file + This can also be specified on a per-query basis using the ``cte_partitioning_provider_catalog`` session property. + + +Logging Properties +------------------ + +``log.max-history`` +^^^^^^^^^^^^^^^^^^^ + + * **Type:** ``integer`` + * **Default value:** ``30`` + + The ``log.max-history`` property controls the number of archive log periods that the application retains. + In Presto, one log period corresponds to one day. For instance, if ``log.max-history`` is set to 30, the system will keep logs for the + past 30 days. + +``log.max-size`` +^^^^^^^^^^^^^^^^ + + * **Type:** ``data size`` + * **Default value:** ``100MB`` + + The maximum file size for the general application log file. + +``http-server.log.enabled`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + * **Type:** ``boolean`` + * **Default value:** ``true`` + + Flag to enable or disable logging for the HTTP server. + +``http-server.log.compression.enabled`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + * **Type:** ``boolean`` + * **Default value:** ``true`` + + Flag to enable or disable compression of the log files of the HTTP server. + +``http-server.log.path`` +^^^^^^^^^^^^^^^^^^^^^^^^ + + * **Type:** ``string`` + * **Default value:** ``var/log/http-request.log`` + + The path to the log file used by the HTTP server. The path is relative to + the data directory, configured by the launcher script as detailed in + :ref:`running_presto`. + +``http-server.log.max-history`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + * **Type:** ``integer`` + * **Default value:** ``15`` + + The ``http-server.log.max-history`` property controls the number of archive log periods that the HTTP server retains. + In Presto, one log period corresponds to one day. For instance, if ``http-server.log.max-history`` is set to 15, the + system will keep logs for the past 15 days. + +``http-server.log.max-size`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + * **Type:** ``data size`` + * **Default value:** ``100MB`` + + The maximum file size for the log file of the HTTP server. \ No newline at end of file