djangosampler 0.10.0

DJANGO_SAMPLER_PLUGINS

Django Sampler 具有插件架构，允许您控制要收集的数据量。

在您的 settings.py 中添加以下内容

DJANGO_SAMPLER_PLUGINS = (
    'djangosampler.plugins.sql.Sql',
    # Plugins are applied in the same order as this list
)

上面的示例将添加SQL插件。

可用的插件及其设置在下面的插件部分中描述。

DJANGO_SAMPLER_FREQ

DJANGO_SAMPLER_FREQ 配置将被记录的查询百分比。它应该在 0.0 和 1.0 之间。

如果没有设置此值，则不会安装任何插件，您的代码将正常运行。

DJANGO_SAMPLER_USE_COST

DJANGO_SAMPLER_USE_COST 将启用基于成本的采样。这会导致运行时间较长的查询比短查询采样更频繁。

查询被采样的几率将乘以查询的总时间。如果查询耗时 2 秒，那么它被采样的可能性是耗时 1 秒查询的两倍。

查询的成本将根据以下方式进行调整

cost = max(1.0, time * DJANGO_SAMPLER_FREQ) / DJANGO_SAMPLER_FREQ

Django SQL

插件类: djangosampler.plugins.sql.Sql

SQL 采样插件将对您的应用程序中发生的 SQL 查询的百分比进行采样。样本将按查询分组，并将记录堆栈跟踪以找到查询的来源。

Django 请求

插件类: djangosampler.plugins.request.Request

请求插件将安装一个 Middleware，它会采样请求所需的时间。

采样任何代码

这并不是严格意义上的插件。这是一个上下文管理器，允许您标记代码块并采样代码块运行所需的时间。例如。

from djangosampler.sampler import sampling

with sampling('my_code', 'some_fn'):
    do_something_slow()

Celery

插件类: djangosampler.plugins.celery_task.Celery

Celery 插件使用 Celery 的信号来采样任务执行所需的时间。

MongoDB

插件类: djangosampler.plugins.mongo.Mongo

MongoDB 插件将对您的应用程序中发生的 MongoDB 命令（查询、插入等）的百分比进行采样。样本将按命令分组，并将记录堆栈跟踪以找到查询的来源。