opentelemetry-propagator-ot-trace


Nameopentelemetry-propagator-ot-trace JSON
Version 0.49b1 PyPI version JSON
download
home_pageNone
SummaryOT Trace Propagator for OpenTelemetry
upload_time2024-11-08 19:33:17
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            OpenTelemetry OT Trace Propagator
=================================

|pypi|

.. |pypi| image:: https://badge.fury.io/py/opentelemetry-propagator-ot-trace.svg
   :target: https://pypi.org/project/opentelemetry-propagator-ot-trace/

Installation
------------

::

    pip install opentelemetry-propagator-ot-trace

.. _OpenTelemetry: https://github.com/open-telemetry/opentelemetry-python/

OTTrace Format
--------------

So far there is no "formal" specification of the OTTrace format. The best
document that servers this purpose that exists now is this_ implementation.

.. _this: https://github.com/opentracing/basictracer-python/blob/master/basictracer/text_propagator.py

===================== ======================================================================================================================================= =====================
Header Name           Description                                                                                                                             Required
===================== ======================================================================================================================================= =====================
``ot-tracer-traceid`` uint64 encoded as a string of 16 hex characters                                                                                         yes
``ot-tracer-spanid``  uint64 encoded as a string of 16 hex characters                                                                                         yes
``ot-tracer-sampled`` boolean encoded as a string with the values ``true`` or ``false``                                                                       no
``ot-baggage-*``      repeated string to string key-value baggage items; keys are prefixed with ``ot-baggage-`` and the corresponding value is the raw string if baggage is present
===================== ======================================================================================================================================= =====================

Interop and trace ids
---------------------

The OT Trace propagation format expects trace ids to be 64-bits. In order to
interop with OpenTelemetry, trace ids need to be truncated to 64-bits before
sending them on the wire. When truncating, the least significant (right-most)
bits MUST be retained. For example, a trace id of
``3c3039f4d78d5c02ee8e3e41b17ce105`` would be truncated to
``ee8e3e41b17ce105``.

References
----------

* `OpenTelemetry Project <https://opentelemetry.io/>`_

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "opentelemetry-propagator-ot-trace",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "OpenTelemetry Authors <cncf-opentelemetry-contributors@lists.cncf.io>",
    "download_url": "https://files.pythonhosted.org/packages/d3/d9/a7d13684658a7388bdac7e7269c98799992739d47dec784439243d888779/opentelemetry_propagator_ot_trace-0.49b1.tar.gz",
    "platform": null,
    "description": "OpenTelemetry OT Trace Propagator\n=================================\n\n|pypi|\n\n.. |pypi| image:: https://badge.fury.io/py/opentelemetry-propagator-ot-trace.svg\n   :target: https://pypi.org/project/opentelemetry-propagator-ot-trace/\n\nInstallation\n------------\n\n::\n\n    pip install opentelemetry-propagator-ot-trace\n\n.. _OpenTelemetry: https://github.com/open-telemetry/opentelemetry-python/\n\nOTTrace Format\n--------------\n\nSo far there is no \"formal\" specification of the OTTrace format. The best\ndocument that servers this purpose that exists now is this_ implementation.\n\n.. _this: https://github.com/opentracing/basictracer-python/blob/master/basictracer/text_propagator.py\n\n===================== ======================================================================================================================================= =====================\nHeader Name           Description                                                                                                                             Required\n===================== ======================================================================================================================================= =====================\n``ot-tracer-traceid`` uint64 encoded as a string of 16 hex characters                                                                                         yes\n``ot-tracer-spanid``  uint64 encoded as a string of 16 hex characters                                                                                         yes\n``ot-tracer-sampled`` boolean encoded as a string with the values ``true`` or ``false``                                                                       no\n``ot-baggage-*``      repeated string to string key-value baggage items; keys are prefixed with ``ot-baggage-`` and the corresponding value is the raw string if baggage is present\n===================== ======================================================================================================================================= =====================\n\nInterop and trace ids\n---------------------\n\nThe OT Trace propagation format expects trace ids to be 64-bits. In order to\ninterop with OpenTelemetry, trace ids need to be truncated to 64-bits before\nsending them on the wire. When truncating, the least significant (right-most)\nbits MUST be retained. For example, a trace id of\n``3c3039f4d78d5c02ee8e3e41b17ce105`` would be truncated to\n``ee8e3e41b17ce105``.\n\nReferences\n----------\n\n* `OpenTelemetry Project <https://opentelemetry.io/>`_\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "OT Trace Propagator for OpenTelemetry",
    "version": "0.49b1",
    "project_urls": {
        "Homepage": "https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/propagator/opentelemetry-propagator-ot-trace"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "665afd147784a7f69675b5b479741fb7108f18d6460809412b81a4f02b9d0d06",
                "md5": "48f9ef1e5afb194d73a4de7d508545da",
                "sha256": "5e71e51c90f4dba64748931ee12aaca5cb66a32af34c943b69766523876428d5"
            },
            "downloads": -1,
            "filename": "opentelemetry_propagator_ot_trace-0.49b1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "48f9ef1e5afb194d73a4de7d508545da",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 4754,
            "upload_time": "2024-11-08T19:32:31",
            "upload_time_iso_8601": "2024-11-08T19:32:31.430730Z",
            "url": "https://files.pythonhosted.org/packages/66/5a/fd147784a7f69675b5b479741fb7108f18d6460809412b81a4f02b9d0d06/opentelemetry_propagator_ot_trace-0.49b1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d3d9a7d13684658a7388bdac7e7269c98799992739d47dec784439243d888779",
                "md5": "3067eafd5e4cbfdfbde8200e866e8901",
                "sha256": "bacaa483b6c013d3ceef0b32d3e8d32d83be2170fb7a5f00dcab545a762c1dea"
            },
            "downloads": -1,
            "filename": "opentelemetry_propagator_ot_trace-0.49b1.tar.gz",
            "has_sig": false,
            "md5_digest": "3067eafd5e4cbfdfbde8200e866e8901",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 5003,
            "upload_time": "2024-11-08T19:33:17",
            "upload_time_iso_8601": "2024-11-08T19:33:17.937842Z",
            "url": "https://files.pythonhosted.org/packages/d3/d9/a7d13684658a7388bdac7e7269c98799992739d47dec784439243d888779/opentelemetry_propagator_ot_trace-0.49b1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-08 19:33:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "open-telemetry",
    "github_project": "opentelemetry-python-contrib",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "tox": true,
    "lcname": "opentelemetry-propagator-ot-trace"
}
        
Elapsed time: 3.25435s