django-dynamic-logging 2.0.0

概述

使用django-dynamic-logging，您可以在运行时更新日志配置，包括

• 更新处理程序级别和过滤器，但仅限于此（出于安全目的）

• 创建/删除/更新记录器。这包括级别、处理程序、过滤器以及传播标志。

日志配置可能存在于数据库中，但只能有一个是活跃的。最新的触发器（start_date）具有优先级，并将激活其配置。

例如：您想将应用“myproject.import”设置为调试模式，以便在今晚运行：您设置触发器，它将只为今晚启用调试。白天，将运行默认的日志配置。

截图

安装

1. 使用pip安装

   pip install django-dynamic-logging

2. 或者，您可以安装下载或克隆此存储库，然后调用

   pip install -e ..

需求

支持版本与当前django相同

• python 2.7, 3.4, 3.5

• django 1.8, 1.9, 1.10

源代码中的配置

1. 将dynamic_logging添加到您的INSTALLED_APPS

就这么多

运行系统配置

1. 转到您的管理界面，创建一个配置

2. 创建一个触发器，以便您可以在需要时启用它。

新配置的传播

每次配置或触发器被更新/删除/创建时，dynamic_logging系统必须重新计算新的配置。但要工作，它必须意识到有东西被更新。为了使其可用，有三种可能性。在单进程（如gunicorn设置）中，日志配置对所有线程是全局的，这不是问题，但在多进程（如多服务器）中，我们必须传播一个正在运行实例已更改配置的信息。

为此，dynamic_logging提供了4种传播器

• ThreadSignalPropagator：默认的，它在一个单服务器、单进程设置中实时工作。在真实生产环境中可能无法设置此设置。

• DummyPropagator：当配置更新时，不会发生任何事情。所有触发器和后续触发器应用仅在启动时计算

• TimerPropagator：每隔一个时间间隔检查一次配置的修改。这可行，但效率低下。

• AmqpPropagator：生产环境中的最佳选择，但需要运行Amqp消息队列代理（在RabbitMQ上测试过）。它接受配置中的服务器URL，并将每个正在运行的实例连接到它。每次实例更新配置时，所有实例都会被触发，并将实时近似的配置重新加载。

可以使用on_error配置来在传播器设置失败时抛出异常，或pass``[默认]但将错误记录在``dynamic_logging.apps``中。

要更改传播器，您可以使用以下设置

DYNAMIC_LOGGING = {
    "upgrade_propagator": {'class': "dynamic_logging.propagator.AmqpPropagator",
                           'config': {'url': 'amqp://guest:guest@localhost:5672/%2F'},
                           'on_error': 'raise',  # or by default : 'pass'
                           }
}

特殊情况

django-dynamic-logging默认为您处理一些特殊情况。

• 如果您更新配置或触发器，它将计算您网站所有运行实例的当前配置和下一个配置（见传播）

• 如果您在django.db.backends上启用DEBUG（或更低）级别，它将更改数据库连接的设置，以确保使用CursorDebugWrapper并调用所有查询的调试。如果不这样做，默认情况下您将看不到任何查询。

您可以通过在dynamic_logging.signals.AutoSignalsHandler.extra_signals中添加自己的特殊情况来自定义或添加一些特殊情况。

设置

您可以在设置中添加一个具有以下键的DYNAMIC_LOGGING字典来自定义动态日志记录器的行为

• signals_auto：特殊日志处理程序列表。目前只有db_debug被启用

• config_upgrade_propagator：负责触发网站所有运行实例的调度器重新加载的类。见传播

接下来是什么？

一些即将推出的功能可以是

• 实时日志浏览器（通过websocket）

• 从/到其他服务器的推送/拉取配置（通过amqp）