zperfmetrics 1.0b5

Zope和Plone的性能配置

zperfmetrics类似于perfmetrics，并额外提供statsd的ZConfig配置

• 。

• 使用当前请求路径作为statd点分路径的前缀，

• 还提供了一个补丁来测量Plone.app.theming的diazo编译和diazo转换（如果Plone可用），

安装

首先正确配置您的statsd。这超出了本模块的范围。

在您的包的setup.py中依赖此模块。

如果您使用zc.buildout来设置Zope2或Plone，请在您的[instance]部分或包含recipe = plone.recipe.zope2instance的部分中添加以下行

[instance01]
recipe = plone.recipe.zope2instance
...
zope-conf-imports =
    zperfmetrics
zope-conf-additional =
    <perfmetrics>
        uri statsd://localhost:8125
        before MyFancyProject
        hostname on
        virtualhost on
        after ${:_buildout_section_name_}
    </perfmetrics>
...

假设该程序在一个名为w-plone1的主机上运行，这将导致前缀MyFancyProject.w-plone1.instance01。

uri

statd的完整URI。

之前

在主机名之前的路径前缀。

hostname

获取主机名并将其插入前缀中。（布尔值：开启或关闭）

virtualhost

获取虚拟主机并在ZPerfmetrics中使用静态前缀之后。（布尔值：开启或关闭）

之后

在主机名之后的路径前缀。

使用

您需要使用装饰器或使用with语句来测量代码块。

使用

from zperfmetrics import ZMetric
from zperfmetrics import zmetric
from zperfmetrics import zmetricmethod

@zmetric
def some_function():
    # whole functions timing and call counts will be measured
    pass

@ZMetric(stat='a_custom_prefix')
def some_other_function():
    # set a custom prefix instead of module path and fucntion name.
    pass

class Foo(object):

    @zmetricmethod
    def some_method(self):
        # whole methods timing and call counts will be measured
        pass

    @ZMetric(method=True, timing=False):
    def some_counted_method(self):
        # whole methods number of calls will be measured, but no times
        pass

    @ZMetric(method=True, count=False):
    def some_timed_method(self):
        # whole methods timing be measured, but no counts
        pass

    def some_method_partly_measured(self):
        # do something here you dont want to measure
        with ZMetric(stat='part_of_other_method_time'):
            # do something to measure
            # call counts and timing will be measured
            pass
        # do something here you dont want to measure

    @ZMetric(method=True, rate=0.5):
    def some_random_recorded_method(self):
        # randomly record 50% of the calls.
        pass

请求生命周期集成

所有传递请求的ZPerfmetrics都被视为在request_lifecycle部分。

这里的所有指标都是按照以下格式构建的：$PREFIX.request_lifecycle.[$VIRTUAL_HOST].$PATH.*。

Docker中的Statd、Graphite & Grafana

设置Statsd、Graphite和Grafana可能很复杂。对于本地测试——以及生产环境——启动一些Docker容器非常有用。

这是一个非常简化的版本，用于设置Docker中的Statd、Graphite和Grafana（请参阅此处的原始版本）。这有助于最初启动和运行。请安装Docker和安装docker-compose（只需pip install docker-compose），然后克隆仓库，并在其docker目录中运行docker-compose up -d。

让Zperfmetrics指向uri statsd://localhost:8125并收集一些数据。在浏览器中打开Grafana，网址为http://localhost:3000。

首先访问Grafana入门指南，10分钟的视频确实有助于发现UI的隐藏部分。

源代码

源代码存储在GIT版本控制系统中，主分支在github上。

我们很高兴看到许多分支、分叉和pull请求，以使zperfmetrics变得更加出色。

贡献者

• Jens W. Klein <jens@bluedynamics.com>

• Zalán Somogyváry

历史

许可证

版权所有（c）2016，BlueDynamics Alliance，奥地利，德国，瑞士。保留所有权利。

在满足以下条件的情况下，允许重新分发和使用源代码和二进制形式，无论是否修改：

• 源代码的重新分发必须保留上述版权声明、本条件列表和以下免责声明。

• 二进制形式的重新分发必须复制上述版权声明、本条件列表和以下免责声明在随分布提供的文档和/或其他材料中。

• 未经BlueDynamics Alliance事先书面许可，不得使用BlueDynamics Alliance的名称或其贡献者的名称来推广或支持由本软件派生的产品。

本软件由BlueDynamics Alliance提供“按原样”且不承担任何明示或暗示的保证，包括但不限于适销性和适用于特定目的的隐含保证。在任何情况下，BlueDynamics Alliance均不对因使用本软件而产生的任何直接、间接、偶然、特殊、示范性或后果性损害（包括但不限于替代商品或服务的采购；使用、数据或利润的损失；或业务中断）承担责任，无论这些损害是由何种原因引起，无论根据何种法律理论，无论是基于合同、严格责任还是侵权（包括疏忽或其他），即使已被告知此类损害的可能性。