diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst index cf5b693d8e38514..316b16aa796af44 100644 --- a/Doc/howto/logging.rst +++ b/Doc/howto/logging.rst @@ -382,8 +382,8 @@ Logging Flow The flow of log event information in loggers and handlers is illustrated in the following diagram. -.. image:: logging_flow.png - :class: invert-in-dark-mode +.. raw:: html + :file: logging_flow.svg Loggers ^^^^^^^ diff --git a/Doc/howto/logging_flow.png b/Doc/howto/logging_flow.png deleted file mode 100644 index d65e597f811db5e..000000000000000 Binary files a/Doc/howto/logging_flow.png and /dev/null differ diff --git a/Doc/howto/logging_flow.svg b/Doc/howto/logging_flow.svg new file mode 100644 index 000000000000000..273f8608bdb0629 --- /dev/null +++ b/Doc/howto/logging_flow.svg @@ -0,0 +1,280 @@ + + + + + + + + + + + + + + Logger flow + + + + + Create + LogRecord + + + + + + + + + + + + + + + + + + Logging call in user + code, e.g. + + + logging.info(...) + + + + + + + + + Stop + + + + + + Does a filter attached + to logger reject the + record? + + + + + + + + + + Pass to + handlers of + current logger + + + + + + Is propagate true for + current logger? + + + + + + Is there a parent + logger? + + + + + + Set current + logger to parent + + + + + + At least one handler + in hierarchy? + + + + + + Use lastResort + + + + + + Handler enabled for + level of LogRecord? + + + + + + Does a filter attached + to handler reject the + record? + + + + + + Stop + + + + + + Emit (includes formatting) + + + + Handler flow + + + + + Logger enabled for + level of call? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No + + + Yes + + + Yes + + + No + + + No + + + Yes + + + Yes + + + No + + + No + + + Yes + + + + + + No + + + + + + + + + Yes + + + No + + + + + + Yes + + + LogRecord passed + to handler + + + + + + + +