{ "info": { "author": "SignalFx, Inc.", "author_email": "info@signalfx.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Natural Language :: English", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6" ], "description": "###################\nPyMongo OpenTracing\n###################\n\nThis package enables tracing `Mongo`_ commands in a `PyMongo`_ ``MongoClient`` via `The OpenTracing Project`_. \nOnce a production system contends with real concurrency or splits into many services, crucial (and\nformerly easy) tasks become difficult: user-facing latency optimization, root-cause analysis of backend\nerrors, communication about distinct pieces of a now-distributed system, etc. Distributed tracing\nfollows a request on its journey from inception to completion from mobile/browser all the way to the\nmicroservices. \n\nAs core services and libraries adopt OpenTracing, the application builder is no longer burdened with\nthe task of adding basic tracing instrumentation to their own code. In this way, developers can build\ntheir applications with the tools they prefer and benefit from built-in tracing instrumentation.\nOpenTracing implementations exist for major distributed tracing systems and can be bound or swapped\nwith a one-line configuration change.\n\nIf you want to learn more about the underlying Python API, visit the Python `source code`_.\n\n.. _Mongo: https://www.mongodb.com/\n.. _PyMongo: http://api.mongodb.com/python/current/\n.. _The OpenTracing Project: http://opentracing.io/\n.. _source code: https://github.com/signalfx/python-pymongo/\n\nInstallation\n============\n\nRun the following command:\n\n.. code-block:: \n\n $ pip install pymongo-opentracing\n\nUsage\n=====\n\nThis PyMongo monitor allows the tracing of database queries and commands using the OpenTracing API.\nAll that it requires is for a ``CommandTracing`` listener instance to be initialized using an instance\nof an OpenTracing tracer and registered via the ``pymongo.monitoring`` module.\n\nInitialize\n----------\n\n``CommandTracing`` takes the ``Tracer`` instance that is supported by OpenTracing and an optional\ndictionary of desired tags for each created span. To create a ``CommandTracing`` object, you can\neither pass in a tracer object directly or default to the ``opentracing.tracer`` global tracer that's\nset elsewhere in your application:\n\n.. code-block:: python\n\n from pymongo_opentracing import CommandTracing\n from pymongo import monitoring\n\n opentracing_tracer = ## some OpenTracing tracer implementation\n # All future clients will have CommandTracing registered for their events\n monitoring.register(CommandTracing(opentracing_tracer,\n span_tags={'MyCustomTag': 'HelpfulVal'}))\n\nor\n\n.. code-block:: python\n\n from pymongo_opentracing import CommandTracing\n import opentracing\n import pymongo\n\n opentracing.tracer = ## some OpenTracing tracer implementation\n # Only this client will have CommandTracing trace their events\n client = pymongo.MongoClient(event_listeners=[CommandTracing()])\n\nFurther Information\n===================\n\nIf you're interested in learning more about the OpenTracing standard, please visit\n`opentracing.io`_ or `join the mailing list`_. If you would like to implement OpenTracing\nin your project and need help, feel free to send us a note at `community@opentracing.io`_.\n\n.. _opentracing.io: http://opentracing.io/\n.. _join the mailing list: http://opentracing.us13.list-manage.com/subscribe?u=180afe03860541dae59e84153&id=19117aa6cd\n.. _community@opentracing.io: community@opentracing.io", "description_content_type": "", "docs_url": null, "download_url": "http://github.com/signalfx/python-pymongo/tarball/master", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/signalfx/python-pymongo", "keywords": "", "license": "Apache Software License v2", "maintainer": "", "maintainer_email": "", "name": "PyMongo-OpenTracing", "package_url": "https://pypi.org/project/PyMongo-OpenTracing/", "platform": "any", "project_url": "https://pypi.org/project/PyMongo-OpenTracing/", "project_urls": { "Download": "http://github.com/signalfx/python-pymongo/tarball/master", "Homepage": "http://github.com/signalfx/python-pymongo" }, "release_url": "https://pypi.org/project/PyMongo-OpenTracing/0.0.2/", "requires_dist": null, "requires_python": "", "summary": "OpenTracing support for PyMongo", "version": "0.0.2" }, "last_serial": 4741413, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "8def1577d58b385da8fd174b90aad6bd", "sha256": "525796580e69d9861b42b60952d83f6c6dff016f1da57d72eb5f355ad747534a" }, "downloads": -1, "filename": "PyMongo-OpenTracing-0.0.1.tar.gz", "has_sig": false, "md5_digest": "8def1577d58b385da8fd174b90aad6bd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3935, "upload_time": "2018-12-13T18:35:49", "url": "https://files.pythonhosted.org/packages/7f/58/692d5ae93cf094ea12d1c13ff148b4e5ad3ad7a778980ddf5a41590354fe/PyMongo-OpenTracing-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "96496861336124402018698c91594a36", "sha256": "4480978927e41e8b0ee7809cdde7d3ff4fd1bd4d9346d16facd55bf175407cc7" }, "downloads": -1, "filename": "PyMongo-OpenTracing-0.0.2.tar.gz", "has_sig": false, "md5_digest": "96496861336124402018698c91594a36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3966, "upload_time": "2019-01-25T19:13:30", "url": "https://files.pythonhosted.org/packages/c7/63/29dca4d1c065de95e7735653d02dae531f537c125e7a9dcb2ffea8d99e13/PyMongo-OpenTracing-0.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "96496861336124402018698c91594a36", "sha256": "4480978927e41e8b0ee7809cdde7d3ff4fd1bd4d9346d16facd55bf175407cc7" }, "downloads": -1, "filename": "PyMongo-OpenTracing-0.0.2.tar.gz", "has_sig": false, "md5_digest": "96496861336124402018698c91594a36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3966, "upload_time": "2019-01-25T19:13:30", "url": "https://files.pythonhosted.org/packages/c7/63/29dca4d1c065de95e7735653d02dae531f537c125e7a9dcb2ffea8d99e13/PyMongo-OpenTracing-0.0.2.tar.gz" } ] }