{ "info": { "author": "LightStep", "author_email": "", "bugtrack_url": null, "classifiers": [ "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3" ], "description": "# LightStep Streaming: Our Streaming Python Tracer\n\nThe Streaming Python Tracer, is an [OpenTracing](http://opentracing.io) tracer which sends data to [LightStep Satellites](https://docs.lightstep.com/docs/satellite-setup).\n\nThis tracer sends data to multiple Satellites concurrently using non-blocking I/O writes. Memory is carefully managed so that spans are only copied a single time during the reporting process and streamed to Satellites as they are generated to avoid filling up memory. The Streaming Python Tracer is written in C++. There is a thin Python wrapper around this C++ core so the library can be imported just like any other Python module.\n\n## Setup\n\nIf you aren't familiar with OpenTracing or LightStep, we recommend reading up before continuing.\n\nBefore installing, make sure that you system meets these requirements:\n\n- Linux\n- Python 2.7 or >= 3.2.0 (and pip)\n- opentracing PyPI Module (>=2.2.0)\n\nTo install the Streaming Python Tracer, run `pip install lightstep-streaming`.\n\n## Getting Started\n\nThe beauty of OpenTracing is that all tracers follow a well-defined API. The only step which varies from tracer to tracer is the setup step when `lightstep_streaming.Tracer`'s constructor is called. Below is a sample program which illustrates how to create a new Tracer object using the Streaming Python Tracer. For more details on how to use a `Tracer` object once it has been created, checkout the [OpenTracing Python API Guide](https://opentracing.io/guides/python/tracers/).\n\n```python\nimport lightstep_streaming\n\ntracer = lightstep_streaming.Tracer(\n component_name='[your service name]',\n access_token='[your LightStep access token]',\n\n # Use these defaults unless you know what you're doing\n use_stream_recorder=True,\n collector_plaintext=True,\n\n # You can put any number of Satellite endpoints in this list and the tracer\n # will rotate through them and send spans to each one.\n satellite_endpoints=[{'host': 'localhost', 'port': 8360}],\n\n # Turns off verbose logging, which is really only useful for debugging.\n verbose=False\n)\n\n# Generates one span\nwith tracer.start_active_span('[your operation name]'):\n pass\n\n# Makes sure that the tracer has sent the span to a Satellite\ntracer.flush()\n```\n\nA complete list of Streaming Python Tracer configuration parameters can be found in [tracer_configuration.schema.json](https://github.com/lightstep/lightstep-tracer-cpp/blob/master/lightstep-tracer-configuration/tracer_configuration.schema.json). If you are interested in peeking at the source code, this is available in the [LightStep C++ Tracer repo](https://github.com/lightstep/lightstep-tracer-cpp).\n", "description_content_type": "text/markdown; charset=UTF-8", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "opentracing,lightstep,traceguide,tracing,microservices,distributed", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "lightstep-streaming", "package_url": "https://pypi.org/project/lightstep-streaming/", "platform": "Linux", "project_url": "https://pypi.org/project/lightstep-streaming/", "project_urls": null, "release_url": "https://pypi.org/project/lightstep-streaming/0.11.0/", "requires_dist": [ "opentracing (>=2.2.0)" ], "requires_python": ">=2.7,!=3.0.*,!=3.1.*", "summary": "High performace C++ implementation of LightStep tracing", "version": "0.11.0" }, "last_serial": 5762767, "releases": { "0.11.0": [ { "comment_text": "", "digests": { "md5": "6e2aaaf8e2edd44434e056d08ae6fb61", "sha256": "e747f222cc4d38da48b04f1511aa24cb32b83ee042c9a96ac59f6516903ba91c" }, "downloads": -1, "filename": "lightstep_streaming-0.11.0-cp27-cp27m-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "6e2aaaf8e2edd44434e056d08ae6fb61", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": ">=2.7,!=3.0.*,!=3.1.*", "size": 1217973, "upload_time": "2019-08-31T00:30:12", "url": "https://files.pythonhosted.org/packages/ed/35/dbe0abd2052e0f8485663874f2c68330e7dfa95864826c8623a38872ecbf/lightstep_streaming-0.11.0-cp27-cp27m-manylinux1_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "b668febd1214b0ac348802c1f076385f", "sha256": "a19286ccd1cbd041c0b58f5573cb59362ad079c54e232ba20997f95920021e92" }, "downloads": -1, "filename": "lightstep_streaming-0.11.0-cp27-cp27mu-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "b668febd1214b0ac348802c1f076385f", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": ">=2.7,!=3.0.*,!=3.1.*", "size": 1217961, "upload_time": "2019-08-31T00:30:14", "url": "https://files.pythonhosted.org/packages/50/a3/b387d0858e93278995703e306450edcc713a0ca5cedb617bad84238e5947/lightstep_streaming-0.11.0-cp27-cp27mu-manylinux1_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "69da781da01bce7269e3f220b6fe47d8", "sha256": "1f5dace660498dd78db841d5111d778a3f856b2b6588bb432ed512fa297c638f" }, "downloads": -1, "filename": "lightstep_streaming-0.11.0-cp32-abi3-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "69da781da01bce7269e3f220b6fe47d8", "packagetype": "bdist_wheel", "python_version": "cp32", "requires_python": ">=2.7,!=3.0.*,!=3.1.*", "size": 1218145, "upload_time": "2019-08-31T00:30:16", "url": "https://files.pythonhosted.org/packages/53/37/d9bcab1f451cf253f5fecc94dbfbe19eaff8b5c5d934f7917099367a4245/lightstep_streaming-0.11.0-cp32-abi3-manylinux1_x86_64.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6e2aaaf8e2edd44434e056d08ae6fb61", "sha256": "e747f222cc4d38da48b04f1511aa24cb32b83ee042c9a96ac59f6516903ba91c" }, "downloads": -1, "filename": "lightstep_streaming-0.11.0-cp27-cp27m-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "6e2aaaf8e2edd44434e056d08ae6fb61", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": ">=2.7,!=3.0.*,!=3.1.*", "size": 1217973, "upload_time": "2019-08-31T00:30:12", "url": "https://files.pythonhosted.org/packages/ed/35/dbe0abd2052e0f8485663874f2c68330e7dfa95864826c8623a38872ecbf/lightstep_streaming-0.11.0-cp27-cp27m-manylinux1_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "b668febd1214b0ac348802c1f076385f", "sha256": "a19286ccd1cbd041c0b58f5573cb59362ad079c54e232ba20997f95920021e92" }, "downloads": -1, "filename": "lightstep_streaming-0.11.0-cp27-cp27mu-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "b668febd1214b0ac348802c1f076385f", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": ">=2.7,!=3.0.*,!=3.1.*", "size": 1217961, "upload_time": "2019-08-31T00:30:14", "url": "https://files.pythonhosted.org/packages/50/a3/b387d0858e93278995703e306450edcc713a0ca5cedb617bad84238e5947/lightstep_streaming-0.11.0-cp27-cp27mu-manylinux1_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "69da781da01bce7269e3f220b6fe47d8", "sha256": "1f5dace660498dd78db841d5111d778a3f856b2b6588bb432ed512fa297c638f" }, "downloads": -1, "filename": "lightstep_streaming-0.11.0-cp32-abi3-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "69da781da01bce7269e3f220b6fe47d8", "packagetype": "bdist_wheel", "python_version": "cp32", "requires_python": ">=2.7,!=3.0.*,!=3.1.*", "size": 1218145, "upload_time": "2019-08-31T00:30:16", "url": "https://files.pythonhosted.org/packages/53/37/d9bcab1f451cf253f5fecc94dbfbe19eaff8b5c5d934f7917099367a4245/lightstep_streaming-0.11.0-cp32-abi3-manylinux1_x86_64.whl" } ] }