@@ -0,0 +1 @@ | |||
The default logging handler for new installations is now `PeriodicallyFlushingMemoryHandler`, a buffered logging handler which periodically flushes itself. |
@@ -18,18 +18,31 @@ handlers: | |||
backupCount: 6 # Does not include the current log file. | |||
encoding: utf8 | |||
# Default to buffering writes to log file for efficiency. This means that | |||
# there will be a delay for INFO/DEBUG logs to get written, but WARNING/ERROR | |||
# logs will still be flushed immediately. | |||
# Default to buffering writes to log file for efficiency. | |||
# WARNING/ERROR logs will still be flushed immediately, but there will be a | |||
# delay (of up to `period` seconds, or until the buffer is full with | |||
# `capacity` messages) before INFO/DEBUG logs get written. | |||
buffer: | |||
class: logging.handlers.MemoryHandler | |||
class: synapse.logging.handlers.PeriodicallyFlushingMemoryHandler | |||
target: file | |||
# The capacity is the number of log lines that are buffered before | |||
# being written to disk. Increasing this will lead to better | |||
# The capacity is the maximum number of log lines that are buffered | |||
# before being written to disk. Increasing this will lead to better | |||
# performance, at the expensive of it taking longer for log lines to | |||
# be written to disk. | |||
# This parameter is required. | |||
capacity: 10 | |||
flushLevel: 30 # Flush for WARNING logs as well | |||
# Logs with a level at or above the flush level will cause the buffer to | |||
# be flushed immediately. | |||
# Default value: 40 (ERROR) | |||
# Other values: 50 (CRITICAL), 30 (WARNING), 20 (INFO), 10 (DEBUG) | |||
flushLevel: 30 # Flush immediately for WARNING logs and higher | |||
# The period of time, in seconds, between forced flushes. | |||
# Messages will not be delayed for longer than this time. | |||
# Default value: 5 seconds | |||
period: 5 | |||
{% endif %} | |||
console: | |||
@@ -24,18 +24,31 @@ handlers: | |||
backupCount: 3 # Does not include the current log file. | |||
encoding: utf8 | |||
# Default to buffering writes to log file for efficiency. This means that | |||
# will be a delay for INFO/DEBUG logs to get written, but WARNING/ERROR | |||
# logs will still be flushed immediately. | |||
# Default to buffering writes to log file for efficiency. | |||
# WARNING/ERROR logs will still be flushed immediately, but there will be a | |||
# delay (of up to `period` seconds, or until the buffer is full with | |||
# `capacity` messages) before INFO/DEBUG logs get written. | |||
buffer: | |||
class: logging.handlers.MemoryHandler | |||
class: synapse.logging.handlers.PeriodicallyFlushingMemoryHandler | |||
target: file | |||
# The capacity is the number of log lines that are buffered before | |||
# being written to disk. Increasing this will lead to better | |||
# The capacity is the maximum number of log lines that are buffered | |||
# before being written to disk. Increasing this will lead to better | |||
# performance, at the expensive of it taking longer for log lines to | |||
# be written to disk. | |||
# This parameter is required. | |||
capacity: 10 | |||
flushLevel: 30 # Flush for WARNING logs as well | |||
# Logs with a level at or above the flush level will cause the buffer to | |||
# be flushed immediately. | |||
# Default value: 40 (ERROR) | |||
# Other values: 50 (CRITICAL), 30 (WARNING), 20 (INFO), 10 (DEBUG) | |||
flushLevel: 30 # Flush immediately for WARNING logs and higher | |||
# The period of time, in seconds, between forced flushes. | |||
# Messages will not be delayed for longer than this time. | |||
# Default value: 5 seconds | |||
period: 5 | |||
# A handler that writes logs to stderr. Unused by default, but can be used | |||
# instead of "buffer" and "file" in the logger handlers. | |||
@@ -67,18 +67,31 @@ handlers: | |||
backupCount: 3 # Does not include the current log file. | |||
encoding: utf8 | |||
# Default to buffering writes to log file for efficiency. This means that | |||
# will be a delay for INFO/DEBUG logs to get written, but WARNING/ERROR | |||
# logs will still be flushed immediately. | |||
# Default to buffering writes to log file for efficiency. | |||
# WARNING/ERROR logs will still be flushed immediately, but there will be a | |||
# delay (of up to `period` seconds, or until the buffer is full with | |||
# `capacity` messages) before INFO/DEBUG logs get written. | |||
buffer: | |||
class: logging.handlers.MemoryHandler | |||
class: synapse.logging.handlers.PeriodicallyFlushingMemoryHandler | |||
target: file | |||
# The capacity is the number of log lines that are buffered before | |||
# being written to disk. Increasing this will lead to better | |||
# The capacity is the maximum number of log lines that are buffered | |||
# before being written to disk. Increasing this will lead to better | |||
# performance, at the expensive of it taking longer for log lines to | |||
# be written to disk. | |||
# This parameter is required. | |||
capacity: 10 | |||
flushLevel: 30 # Flush for WARNING logs as well | |||
# Logs with a level at or above the flush level will cause the buffer to | |||
# be flushed immediately. | |||
# Default value: 40 (ERROR) | |||
# Other values: 50 (CRITICAL), 30 (WARNING), 20 (INFO), 10 (DEBUG) | |||
flushLevel: 30 # Flush immediately for WARNING logs and higher | |||
# The period of time, in seconds, between forced flushes. | |||
# Messages will not be delayed for longer than this time. | |||
# Default value: 5 seconds | |||
period: 5 | |||
# A handler that writes logs to stderr. Unused by default, but can be used | |||
# instead of "buffer" and "file" in the logger handlers. | |||