{ "info": { "author": "SolarWinds, LLC", "author_email": "traceviewsupport@solarwinds.com", "bugtrack_url": null, "classifiers": [], "description": "# python-traceview\n\nThe 'oboe' and 'oboeware' modules provide support for instrumenting\nprograms for use with the TraceView Oboe instrumentation library.\n\nThe oboe module provides a Pythonic interface to liboboe for C, and\nthe oboeware module provides middleware and other components for\npopular web frameworks such as Django, Tornado, Pylons, and WSGI.\n\n## Installing\n\nThe Python instrumentation for TraceView uses a module named `oboe`, which you\ncan get from pip by running:\n\n```sh\npip install oboe\n```\n\nNOTE: Make sure you've first done the [base TraceView install](http://docs.traceview.solarwinds.com/TraceView/install-instrumentation.html) so the appropriate dependencies are available.\n\n## Configuring\n\nSee our documentation on [configuring TraceView for python](http://docs.traceview.solarwinds.com/Instrumentation/python.html#configuring-instrumentation).\n\n# Upgrading\n\nTo upgrade an existing installation, you simply need to run:\n\n```sh\npip install oboe --upgrade\n```\n\n## Running the Tests\n\n### Test dependencies\n\nThe test suite depends on the presence of several database and cache servers.\n\n- mysql\n- postgres\n- mongodb\n- memcached\n- redis\n\nThe test suite uses [tox](https://testrun.org/tox/latest/), a tool for running\ntests against different versions of python and depended modules. You can get it\nfrom apt by running `sudo apt-get install python-tox` or from pip with\n`sudo pip install tox`.\n\nThe tests currently run against python 2.6 and 2.7, so you will need both.\n\nTo set up multiple versions of python:\n\n sudo apt-get install python-software-properties software-properties-common\n sudo add-apt-repository ppa:fkrull/deadsnakes\n sudo apt-get update\n sudo apt-get install python2.6 python2.6-dev\n\n### Configuring test database and cache servers\n\nMySQL SQLAlchemy tests require no-auth TCP connection (as testing user).\n\nPostgreSQL SQLAlchemy tests requires no-auth (trust) TCP connection (as testing user).\n\n```\n# in pg_hba.conf: Don't use this in production!!\nhost all all 127.0.0.1/32 trust\n```\n\n### Running the tests\n\nTo run tests, simply run:\n\n```sh\ntox\n```\n\n### Test directory layout\n\nTests in test/unit are actually functional tests; naming is for historic\nreasons. Tests in test/manual are for manual verification of certain\nbehaviors.\n\n## Support\n\nIf you find a bug or would like to request an enhancement, feel free to file\nan issue. For all other support requests, see our [support portal](tracelytics.freshdesk.com).\n\n## Contributing\n\nYou are obviously a person of great sense and intelligence. We happily\nappreciate all contributions to the oboe module whether it is documentation,\na bug fix, new instrumentation for a library or framework or anything else\nwe haven't thought of.\n\nWe welcome you to send us PRs. We also humbly request that any new\ninstrumentation submissions have corresponding tests that accompany\nthem. This way we don't break any of your additions when we (and others)\nmake changes after the fact.\n\n## Developer Resources\n\nWe have made a large effort to expose as much technical information\nas possible to assist developers wishing to contribute to the traceview module.\nBelow are the three major sources for information and help for developers:\n\n* The [TraceView Knowledge Base](http://docs.traceview.solarwinds.com/)\nhas a large collection of technical articles or, if needed, you can submit a\nsupport request directly to the team.\n\nIf you have any questions or ideas, don't hesitate to contact us anytime.\n\n## Compiling the C extension\n\nThis module utilizes a C++ extension to interface with the system `liboboe.so`\nlibrary. This system library is installed with the TraceView host packages\n(tracelyzer, liboboe0, liboboe-dev) and is used to report\nhost and performance metrics\nfrom multiple sources (nodejs, nginx, python etc.) back to TraceView servers.\n\nNote: Make sure you have the development package `liboboe0-dev` installed\nbefore attempting to compile the C extension.\n\n```bash\n>$ dpkg -l | grep liboboe\nii liboboe-dev 1.2.1-trusty1 TraceView common library -- development files\nii liboboe0 1.2.1-trusty1 Traceview common library\n```\n\nSee [Installing Base Packages on Debian and Ubuntu](http://docs.traceview.solarwinds.com/TraceView/install-instrumentation.html#debian-and-ubuntu)\nin the Knowledge Base for details.\n\nTo see the code related to the C++ extension, take a look in `oboe`.\n\n## License\n\nCopyright (c) 2016 SolarWinds, LLC\n\nReleased under the [Librato Open License](http://docs.traceview.solarwinds.com/Instrumentation/librato-open-license.html)", "description_content_type": null, "docs_url": null, "download_url": "https://pypi.python.org/pypi/oboe", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://traceview.solarwinds.com/TraceView/Python", "keywords": "traceview tracelytics oboe liboboe instrumentation performance wsgi middleware django", "license": "LICENSE.txt", "maintainer": null, "maintainer_email": null, "name": "oboe", "package_url": "https://pypi.org/project/oboe/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/oboe/", "project_urls": { "Download": "https://pypi.python.org/pypi/oboe", "Homepage": "https://traceview.solarwinds.com/TraceView/Python" }, "release_url": "https://pypi.org/project/oboe/1.5.11/", "requires_dist": null, "requires_python": null, "summary": "TraceView Oboe libraries, instrumentation, and web middleware components for WSGI, Django, and Tornado.", "version": "1.5.11" }, "last_serial": 3102103, "releases": { "1.3.8": [ { "comment_text": "", "digests": { "md5": "35b797afa88b85cbb9e84a6f3aefa61b", "sha256": "154d078ea17d8bc6ff83bb26ef24eb1ad481e5e96f761225239ac9002b02726f" }, "downloads": -1, "filename": "oboe-1.3.8.tar.gz", "has_sig": false, "md5_digest": "35b797afa88b85cbb9e84a6f3aefa61b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 65885, "upload_time": "2013-02-13T23:05:46", "url": "https://files.pythonhosted.org/packages/54/26/0e150280f1e974da6f6ff659ec059f70f50c79ef0001c2a222d45e5e168c/oboe-1.3.8.tar.gz" } ], "1.4.1": [ { "comment_text": "", "digests": { "md5": "7b52596809dc6ac9b8759c457462aa22", "sha256": "dd1afd18556471690e5ad7723843a7a34b0032e81d1b11d5fad3d3f2eac656a4" }, "downloads": -1, "filename": "oboe-1.4.1.tar.gz", "has_sig": false, "md5_digest": "7b52596809dc6ac9b8759c457462aa22", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 65286, "upload_time": "2013-03-20T15:39:31", "url": "https://files.pythonhosted.org/packages/5c/d5/2d3febd8fd6a90b22fab8fd842b5ee9e0ff7c538e98145f535382dcfea89/oboe-1.4.1.tar.gz" } ], "1.4.2": [ { "comment_text": "", "digests": { "md5": "6665003be68f90d9e3c8151dd3f75a4b", "sha256": "cbdf8b2e88478bf92e04bd990d6d3b4f9a3c4d042f635bba5fc372cf45ae6622" }, "downloads": -1, "filename": "oboe-1.4.2.tar.gz", "has_sig": false, "md5_digest": "6665003be68f90d9e3c8151dd3f75a4b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 65421, "upload_time": "2013-03-25T19:01:02", "url": "https://files.pythonhosted.org/packages/a6/ec/d27811e1fd24d2b3c8d49f04a7ee5b58fe7257c9d06fc69ab095bc5f769c/oboe-1.4.2.tar.gz" } ], "1.5.0": [ { "comment_text": "", "digests": { "md5": "d384c4cb82d211783d024ce804afa531", "sha256": "c28027d786535530187297cfcf2af39b6fb52cf46d7f9df96b4118fb958e1db0" }, "downloads": -1, "filename": "oboe-1.5.0.tar.gz", "has_sig": false, "md5_digest": "d384c4cb82d211783d024ce804afa531", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 71148, "upload_time": "2013-10-10T18:51:59", "url": "https://files.pythonhosted.org/packages/10/c0/db7ab866ce93742f3363532d80ea171ae9295f561b7fa7b80ddf4dd9a4c9/oboe-1.5.0.tar.gz" } ], "1.5.10": [ { "comment_text": "", "digests": { "md5": "39f4d09b39cb97b923818633d57d9649", "sha256": "8351996f68cdee559e4a38ae8b56ee680cb84bc40cfa4fa110909041cf7b2747" }, "downloads": -1, "filename": "oboe-1.5.10.tar.gz", "has_sig": false, "md5_digest": "39f4d09b39cb97b923818633d57d9649", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 77257, "upload_time": "2015-11-09T18:43:39", "url": "https://files.pythonhosted.org/packages/50/c5/cb564c34b1e46cd8fd20f72c00747aa26b7f97a0200bbbd97a55cd1e3ac4/oboe-1.5.10.tar.gz" } ], "1.5.11": [ { "comment_text": "", "digests": { "md5": "8c9d4781b20a3a6f41f2f332eb7f4a8a", "sha256": "801462247c0a19acba6b13e5465fac7f0cbb2682b62be71a63304642019d66e2" }, "downloads": -1, "filename": "oboe-1.5.11.tar.gz", "has_sig": false, "md5_digest": "8c9d4781b20a3a6f41f2f332eb7f4a8a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 81283, "upload_time": "2016-10-12T20:32:55", "url": "https://files.pythonhosted.org/packages/02/e5/e698e4f726cc0029d55030f2421e97ec8977b8f4cfd08c98e2862410a1f3/oboe-1.5.11.tar.gz" } ], "1.5.5": [ { "comment_text": "", "digests": { "md5": "15532d9cb54117d70fe635faca97f10d", "sha256": "32d9c93aa5a61f9d9590a175c6b2dc0cd63c3bb1383cd085f14c072f9342e837" }, "downloads": -1, "filename": "oboe-1.5.5.tar.gz", "has_sig": false, "md5_digest": "15532d9cb54117d70fe635faca97f10d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 72655, "upload_time": "2014-01-15T23:57:36", "url": "https://files.pythonhosted.org/packages/b0/84/b0ec02b8d76592235689e53e1d93b338169a09c516ff187f22e6304bf73d/oboe-1.5.5.tar.gz" } ], "1.5.8": [ { "comment_text": "", "digests": { "md5": "3db7dce52dd29025467b661a72d3b3c8", "sha256": "3953cabc87a688d63f0f79af996ac521b895b1942507bad3cb1d48c5ce65c7b4" }, "downloads": -1, "filename": "oboe-1.5.8.tar.gz", "has_sig": false, "md5_digest": "3db7dce52dd29025467b661a72d3b3c8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 72296, "upload_time": "2014-10-27T22:16:28", "url": "https://files.pythonhosted.org/packages/b3/3b/500bc039740c386dec792e0cfc2fa7e08e7f291f9a3edbae7851df139ac9/oboe-1.5.8.tar.gz" } ], "1.5.9": [ { "comment_text": "", "digests": { "md5": "65c02138703e0330626af5a6709ee4c4", "sha256": "bb4adf48fc5506e0e60f95a2fb1925124aa004d37795536978d658dae50bfca6" }, "downloads": -1, "filename": "oboe-1.5.9.tar.gz", "has_sig": false, "md5_digest": "65c02138703e0330626af5a6709ee4c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 76482, "upload_time": "2015-02-11T00:02:56", "url": "https://files.pythonhosted.org/packages/29/a7/4c33ffcd6ed3710af41cc777da1e2ba79b13f509134b42d16dbdc10847bb/oboe-1.5.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8c9d4781b20a3a6f41f2f332eb7f4a8a", "sha256": "801462247c0a19acba6b13e5465fac7f0cbb2682b62be71a63304642019d66e2" }, "downloads": -1, "filename": "oboe-1.5.11.tar.gz", "has_sig": false, "md5_digest": "8c9d4781b20a3a6f41f2f332eb7f4a8a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 81283, "upload_time": "2016-10-12T20:32:55", "url": "https://files.pythonhosted.org/packages/02/e5/e698e4f726cc0029d55030f2421e97ec8977b8f4cfd08c98e2862410a1f3/oboe-1.5.11.tar.gz" } ] }