| Name | opentelemetry-propagator-ot-trace JSON |
| Version |
0.51b0
JSON |
| download |
| home_page | None |
| Summary | OT Trace Propagator for OpenTelemetry |
| upload_time | 2025-02-04 18:21:59 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| 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/75/f7/9e5fe55cc09ba2a0974a35e20053c60d21b6275cd12dfd938a9acb4001bb/opentelemetry_propagator_ot_trace-0.51b0.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.51b0",
"project_urls": {
"Homepage": "https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/propagator/opentelemetry-propagator-ot-trace",
"Repository": "https://github.com/open-telemetry/opentelemetry-python-contrib"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "909479101a95d45b9816f751cbf717f46e850b67fa17b5aaccafdebb6af39756",
"md5": "4cf0058e59434ceb1c6d67437329499d",
"sha256": "ceb52e364debdd531d362bbe178818c4681bf3e14ea8e725c704874afed4371d"
},
"downloads": -1,
"filename": "opentelemetry_propagator_ot_trace-0.51b0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4cf0058e59434ceb1c6d67437329499d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 4770,
"upload_time": "2025-02-04T18:21:04",
"upload_time_iso_8601": "2025-02-04T18:21:04.580303Z",
"url": "https://files.pythonhosted.org/packages/90/94/79101a95d45b9816f751cbf717f46e850b67fa17b5aaccafdebb6af39756/opentelemetry_propagator_ot_trace-0.51b0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "75f79e5fe55cc09ba2a0974a35e20053c60d21b6275cd12dfd938a9acb4001bb",
"md5": "a4a9f4b0c11131fc6af146e813e16814",
"sha256": "24982cd4fd3d4c5ed9dd0a6bb3e2b5fc05b2f697c7b4302ebee6b8dbb8484c94"
},
"downloads": -1,
"filename": "opentelemetry_propagator_ot_trace-0.51b0.tar.gz",
"has_sig": false,
"md5_digest": "a4a9f4b0c11131fc6af146e813e16814",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 5028,
"upload_time": "2025-02-04T18:21:59",
"upload_time_iso_8601": "2025-02-04T18:21:59.103812Z",
"url": "https://files.pythonhosted.org/packages/75/f7/9e5fe55cc09ba2a0974a35e20053c60d21b6275cd12dfd938a9acb4001bb/opentelemetry_propagator_ot_trace-0.51b0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-04 18:21:59",
"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"
}
