Python探针用户指引.pdf

Python 探针用户指南 北京基调网络股份有限公司 1/ 32 简述 听云python 探针 （也称Python Agent）是基于Python 语言而研发的性能监 测工具客户端，其主要目标为支持WSGI协议的pythonweb框架。理论上基于 只要是基于WSGI协议的web框架都能对其监测，比如django、tornado、flask 等。当然其中也包括一些该web框架支持的一些外围组件，例如sql 数据库、 nosql数据库、第三方http调用等。其功能会随着版本的升级而得到更多的支持。 本文档所列明的支持的框架、数据库、软件环境等，是经过测试，且完全支 持的。对于没有在本文档列出的框架以、组件、安装方式等将不被支持，但随着 版本的更新会逐步完善。在使用听云python探针前请务必仔细阅读此文档，同 时我们也极力保持文档与探针功能的同步更新。 探针在性能监测时，将会对页面加载、模板渲染、中间件调用、视图层、数 据层、系统软件环境、硬件环境等数据进行跟踪和监测，更多关于监测的数据参 考/平台的数据监测。 欢迎使用听云，因为有你，我们将会做的更好！！ 听云python 团队 2/ 32 一、快速入门 1、环境要求 环境 要求 备注 操作系统 类unix 系统，如linux、FreebSD、MacOS windows 未经测试 X 等 Python Cpython 2.6.x，2.7.x web 框架 Django、flask 等 更多参考支持框架 使用范围 兼容WSGI 1.0 (PEP 333) 2、快速安装 注意：快速安装需要用到pip （推荐）或者setuptools 工具并需要连接互联 网，如您的环境无法提供，请移驾源码安装。 ·安装探针： pip installtingyun 或者 easy_installtingyun ·生成本地配置文件: tingyun-admin generate-config YourLicenseKey outputFile 如：tingyun-admingenerate-config 123-456-789-001/tmp/tingyun.ini ·设置探针配置文件环境变量。 如： export TING_YUN_CONFIG_FILE /tmp/tingyun.ini ·嵌入探针：tingyun-admin run-program 您应用的启动命令 您应用启 动参数 如：tingyun-admin run-program ./uwsgi.shstart 说明：以上步骤将会设置探针的log输出为 /tmp/tingyun-agent.log。关于探 针更详细的用法和配置，参考章节 探针工具和探针配置 3/ 32 3、部署步骤 3.1 安装探针 详情参考探针安装章节 3.2 配置探针 初次使用探针，建议对探针的默认配置进行修改，对探针配置文件提供了两 个命令行工具 tingyun-admin generate-config 和 tingyun-admin check-config，可 用这两个命令可实现生成配置文件和检查配置文件。 ①如果通过一键启动方式需要对探针配置设置环境变量。 ②如果通过手动嵌码，调用探针api 的，可设置环境变量或者传入配置文件 参数。 3.3 设置阻塞时间 （可选） 阻塞时间是用于测量前端负载均衡接受到请求，到应用层接收到请求耗时。 当并发访问量大的时候，对于衡量负载均衡 到 应用层时间非常有用。 详细设置方式参考阻塞时间章节 3.4 启动用户应用 启动详情参考探针启动章节，以及常见问题章节。