{ "info": { "author": "Anton Stonor", "author_email": "anton@headnet.dk", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Framework :: Plone", "License :: OSI Approved :: GNU General Public License (GPL)", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "===================\nTraceView for Plone\n===================\n\nThe *collective.traceview* package adds support for `TraceView`_, aka Tracelytics, to Plone. The full `TraceView documentation`_ can be read for more information.\n\nContents\n========\n\n.. contents::\n\nIntroduction\n============\n\nTraceView times the full request from the browser through frontend servers to\napplication servers. collective.traceview gives you insight into Zope/Plone\ninternals and adds these layers to TraceView:\n\n * Zope HTTP Server\n * Zope publisher\n * ZODB\n * Portal Transforms\n * Outbound calls to e.g. webservices\n * Portal Catalog searches\n * Chameleon ZPT engine\n\nIt also adds tags to the HTML header and footer to instrument TraceView Real User\nMonitoring (RUM), so you'll get metrics about user network connectivity and how\nlong time your site takes to render inside the browsers of the real users.\n\nRequirements\n============\n\nYou need a TraceView account, TraceView installed on the Plone server. And then the\nTraceView Python oboe library must be installed with the same Python that runs Plone.\n\ncollective.traceview has been tested with Plone 4.\n\nSystem dependencies: liboboe and liboboe-devel (for CentOS) or liboboe-dev (for Debian/Ubuntu)\n\n\nHow to install\n==============\n\nUpdate your ``buildout.cfg`` file:\n\n* Add tracelytics pypi under ``find-links``\n\n ::\n\n find-links += http://pypi.tracelytics.com/oboe\n\n* Add package in develop mode\n\n ::\n\n auto-checkout = collective.traceview\n\n* Add ``oboe`` and ``collective.traceview`` to the list of eggs to install\n\n ::\n\n [instance]\n recipe = plone.recipe.zope2instance\n ...\n eggs =\n ...\n collective.traceview\n oboe\n\n* Get package from collective sources (or create your own GitHub fork)\n\n ::\n\n [sources]\n ...\n collective.traceview = git https://github.com/collective/collective.traceview.git\n\n* Get ``oboe`` egg version 1.3.8, the latest one released on pypi (version 1.4.2) is not yet fully tested (RUM not working)\n\n ::\n\n [versions]\n ...\n oboe = 1.3.8\n\nRe-run buildout, e.g. with:\n\n ``$ ./bin/buildout``\n\n\nPlone tracing (NEW)\n===================\n\nUsually the X-Trace header is generated from a front-end webserver, typically apache. But\nin some cases there is no such front-end webserver, so nowhere to start the trace. We\ndid now add the possibility to get Plone to start the tracing. Just install the product\nin the usual way as described above and set the following environment variables. See example below:\n\n ::\n\n [instance]\n recipe = plone.recipe.zope2instance\n ...\n environment-vars =\n ...\n TRACEVIEW_IGNORE_EXTENSIONS js;css;png;jpeg;jpg;gif;pjpeg;x-png;pdf\n TRACEVIEW_IGNORE_FOUR_OH_FOUR 1\n TRACEVIEW_PLONE_TRACING 1\n TRACEVIEW_DETAILED_PARTITION 1\n TRACEVIEW_SAMPLE_RATE 1.0\n TRACEVIEW_TRACING_MODE always\n\n**TRACEVIEW_IGNORE_EXTENSIONS** tells TraceView not to trace urls with the following extensions,\ndefault value no extension is defined.\n\n ``TRACEVIEW_IGNORE_EXTENSIONS=js;css;png;jpeg;jpg;gif;pjpeg;x-png;pdf``\n\n**TRACEVIEW_IGNORE_FOUR_OH_FOUR** tells TraceView not to record 404 pages, default value is *0*.\n\n ``TRACEVIEW_IGNORE_FOUR_OH_FOUR=1``\n\n**TRACEVIEW_PLONE_TRACING** tells Plone to do the tracing, do not set this if you have oboe\ninstalled on apache in the front end, default value is *0*.\n\n ``TRACEVIEW_PLONE_TRACING=1``\n\n**TRACEVIEW_DETAILED_PARTITION** will split trafic into detailed partition, where the partition\nname will also include hostname and zope instance name. The default is to only partition for\nAnonymous and Authenticated trafic.\n\n ``TRACEVIEW_DETAILED_PARTITION=1``\n\n**TRACEVIEW_SAMPLE_RATE** the sample rate, *1.0* means all requests, *0.0* means no requests,\ndefault value is *0.3*.\n\n ``TRACEVIEW_SAMPLE_RATE=1.0``\n\n**TRACEVIEW_TRACING_MODE** tracing mode, *always* means that we will trace requests, none means no requests to be traced,\ndefault value is *none*.\n\n ``TRACEVIEW_TRACING_MODE=always``\n\n.. _TraceView: http://docs.appneta.com/platform-and-component-support#python-frameworks\n.. _TraceView documentation: http://docs.appneta.com/traceview\n\nChangelog\n=========\n\n1.4 (2016-04-13)\n----------------\n* Added initial support for Chameleon\n [bosim]\n* Small markup fixes to CHANGES.txt and README.rst files\n [alecghica]\n* Fixed long_description under setup.py to make changelog appear under PyPi\n package description page\n [alecghica]\n* Updated documentation.\n [alecghica]\n* Fix bug in httpserver patch when request.uri is None\n [tiberiuichim]\n* Added TRACEVIEW_DETAILED_PARTITION to split trafic in partitions\n that include hostname and zope instance name\n [tiberiuichim]\n\n1.3 (2014-07-24)\n----------------\n* Added initial plone tracing instrumentation\n [bosim]\n* Initial implementation of zserver (medusa) http server patch\n [bosim]\n\n1.2 - (2013-12-29)\n------------------\n* Handle both Plone 3 and Plone 4\n [stonor]\n* Fixed oboe and unicode\n [stonor]\n* Fixed Zodb support to sends correct keys\n [stonor]\n* Fixed case when res is None under catalog.py\n [alecghica]\n* Updade package version under CHANGES.txt\n [alecghica]\n\n1.1 - (2013-06-18)\n------------------\n* Fixed CHANGES.txt for better formatting and to reflect latest release\n [alecghica]\n\n1.0 - (2013-05-21)\n------------------\n* Initial public development release\n [bosim]", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/collective/collective.traceview", "keywords": "collective traceview tracelytics", "license": "GPL", "maintainer": null, "maintainer_email": null, "name": "collective.traceview", "package_url": "https://pypi.org/project/collective.traceview/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/collective.traceview/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/collective/collective.traceview" }, "release_url": "https://pypi.org/project/collective.traceview/1.4/", "requires_dist": null, "requires_python": null, "summary": "This package adds support for TraceView performance instrumentation in Plone", "version": "1.4" }, "last_serial": 2062197, "releases": { "1.0": [ { "comment_text": "", "digests": { "md5": "0767e1dfc935721389680b548d4ea584", "sha256": "4b1878aaf2b0f94f6b4694dd68bacec38af604bc6725260d5cc67009e7ad4564" }, "downloads": -1, "filename": "collective.traceview-1.0.tar.gz", "has_sig": false, "md5_digest": "0767e1dfc935721389680b548d4ea584", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7425, "upload_time": "2013-05-24T09:39:34", "url": "https://files.pythonhosted.org/packages/a3/a9/8bd0018b5998fcd762c89e66370f3546bc4c5aede52172a5920306fa03fd/collective.traceview-1.0.tar.gz" } ], "1.1": [ { "comment_text": "", "digests": { "md5": "589593bf1812c540167009a0cc0d8e4c", "sha256": "c0de132b8c61293d482dd48a4f691c98761f5abd05fa916a8cf1571497d7dec6" }, "downloads": -1, "filename": "collective.traceview-1.1.tar.gz", "has_sig": false, "md5_digest": "589593bf1812c540167009a0cc0d8e4c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7051, "upload_time": "2013-06-18T14:02:23", "url": "https://files.pythonhosted.org/packages/29/ed/3fc33bbdf9f2b6ce861a026a355789a92993741f03d9613bb50fbbd084ce/collective.traceview-1.1.tar.gz" } ], "1.2": [ { "comment_text": "", "digests": { "md5": "c1eec08d12607d86dcd93d3b038dba38", "sha256": "8281a5bc7ad152534d5d93dbda8af8db896a1a3dcbaf64313ed066f0b1958c74" }, "downloads": -1, "filename": "collective.traceview-1.2.tar.gz", "has_sig": false, "md5_digest": "c1eec08d12607d86dcd93d3b038dba38", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14597, "upload_time": "2013-12-29T10:58:18", "url": "https://files.pythonhosted.org/packages/8a/99/efebaa4a9b8dfc59e3c1c68a041c8216f879c1560563123c5b1f5cf4f232/collective.traceview-1.2.tar.gz" } ], "1.3": [ { "comment_text": "", "digests": { "md5": "37c353c01092a964b77dc6884f561cac", "sha256": "2e0fddd6a5e9841907579e69375b8545e846d6f4f71928651a48251082f05478" }, "downloads": -1, "filename": "collective.traceview-1.3.zip", "has_sig": false, "md5_digest": "37c353c01092a964b77dc6884f561cac", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25532, "upload_time": "2014-07-24T17:51:17", "url": "https://files.pythonhosted.org/packages/c5/ba/6e1d192a03cce678ef738366ad5c301cc5efc127b6dc6588f326aa55dbc2/collective.traceview-1.3.zip" } ], "1.4": [ { "comment_text": "", "digests": { "md5": "a3b99d24ca2ea8170a6363a1991e9540", "sha256": "4f482f934b9d2df773061db66cfd6d97d83545a72be9afc03d7d8f300ba39bbe" }, "downloads": -1, "filename": "collective.traceview-1.4.zip", "has_sig": false, "md5_digest": "a3b99d24ca2ea8170a6363a1991e9540", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30278, "upload_time": "2016-04-13T16:14:45", "url": "https://files.pythonhosted.org/packages/ea/ac/47db42fba9746106f36be108205e7cc9c8b3433283efc7926925fc44249e/collective.traceview-1.4.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a3b99d24ca2ea8170a6363a1991e9540", "sha256": "4f482f934b9d2df773061db66cfd6d97d83545a72be9afc03d7d8f300ba39bbe" }, "downloads": -1, "filename": "collective.traceview-1.4.zip", "has_sig": false, "md5_digest": "a3b99d24ca2ea8170a6363a1991e9540", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30278, "upload_time": "2016-04-13T16:14:45", "url": "https://files.pythonhosted.org/packages/ea/ac/47db42fba9746106f36be108205e7cc9c8b3433283efc7926925fc44249e/collective.traceview-1.4.zip" } ] }