OpenTelemetry Google Cloud Propagator
======================================
.. image:: https://badge.fury.io/py/opentelemetry-propagator-gcp.svg
:target: https://badge.fury.io/py/opentelemetry-propagator-gcp
.. image:: https://readthedocs.org/projects/google-cloud-opentelemetry/badge/?version=latest
:target: https://google-cloud-opentelemetry.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
This library provides support for propagating trace context in the Google
Cloud ``X-Cloud-Trace-Context`` format.
Installation
------------
.. code:: bash
pip install opentelemetry-propagator-gcp
Usage
-----
The ``CloudTraceOneWayPropagator`` reads the Google Cloud
``X-Cloud-Trace-Context`` format, but does not write the
``X-Cloud-Trace-Context`` header on outgoing requests. It is intended for use
with a CompositePropagator as below.
.. code-block:: python
from opentelemetry.propagate import set_global_textmap
from opentelemetry.propagators.composite import CompositePropagator
from opentelemetry.propagators.cloud_trace_propagator import (
CloudTraceOneWayPropagator,
)
set_global_textmap(
CompositePropagator([
CloudTraceOneWayPropagator(),
propagate.get_global_textmap(),
]),
)
The ``CloudTraceFormatPropagator`` reads and writes the
``X-Cloud-Trace-Context`` header formats. Note that when using this propagator,
the ``sampled`` bit is interpreted as the ``TRACE_TRUE`` flag, which may cause a
higher sampling rate than desired. See the `Trace documentation
<https://cloud.google.com/trace/docs/setup#force-trace>` for additional context.
.. code-block:: python
from opentelemetry.propagate import set_global_textmap
from opentelemetry.propagators.cloud_trace_propagator import (
CloudTraceFormatPropagator,
)
# Set the X-Cloud-Trace-Context header
set_global_textmap(CloudTraceFormatPropagator())
.. code-block:: python
from opentelemetry.propagate import set_global_textmap
from opentelemetry.propagators.cloud_trace_propagator import (
CloudTraceFormatPropagator,
)
# Set the X-Cloud-Trace-Context header
set_global_textmap(CloudTraceFormatPropagator())
References
----------
* `Cloud Trace <https://cloud.google.com/trace/>`_
* `OpenTelemetry Project <https://opentelemetry.io/>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/GoogleCloudPlatform/opentelemetry-operations-python/tree/main/opentelemetry-propagator-gcp",
"name": "opentelemetry-propagator-gcp",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Google",
"author_email": "opentelemetry-pypi@google.com",
"download_url": "https://files.pythonhosted.org/packages/19/ba/8222dd2e17aa15e049f91b8bd70e44f9c2751cb983063cc79348bb68a30d/opentelemetry-propagator-gcp-1.6.0.tar.gz",
"platform": "any",
"description": "OpenTelemetry Google Cloud Propagator\n======================================\n\n.. image:: https://badge.fury.io/py/opentelemetry-propagator-gcp.svg\n :target: https://badge.fury.io/py/opentelemetry-propagator-gcp\n\n.. image:: https://readthedocs.org/projects/google-cloud-opentelemetry/badge/?version=latest\n :target: https://google-cloud-opentelemetry.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\nThis library provides support for propagating trace context in the Google\nCloud ``X-Cloud-Trace-Context`` format.\n\nInstallation\n------------\n\n.. code:: bash\n\n pip install opentelemetry-propagator-gcp\n\nUsage\n-----\n\nThe ``CloudTraceOneWayPropagator`` reads the Google Cloud\n``X-Cloud-Trace-Context`` format, but does not write the\n``X-Cloud-Trace-Context`` header on outgoing requests. It is intended for use\nwith a CompositePropagator as below.\n\n.. code-block:: python\n\n from opentelemetry.propagate import set_global_textmap\n from opentelemetry.propagators.composite import CompositePropagator\n from opentelemetry.propagators.cloud_trace_propagator import (\n CloudTraceOneWayPropagator,\n )\n set_global_textmap(\n CompositePropagator([\n CloudTraceOneWayPropagator(),\n propagate.get_global_textmap(),\n ]),\n )\n\nThe ``CloudTraceFormatPropagator`` reads and writes the\n``X-Cloud-Trace-Context`` header formats. Note that when using this propagator,\nthe ``sampled`` bit is interpreted as the ``TRACE_TRUE`` flag, which may cause a\nhigher sampling rate than desired. See the `Trace documentation\n<https://cloud.google.com/trace/docs/setup#force-trace>` for additional context.\n\n.. code-block:: python\n\n from opentelemetry.propagate import set_global_textmap\n from opentelemetry.propagators.cloud_trace_propagator import (\n CloudTraceFormatPropagator,\n )\n\n # Set the X-Cloud-Trace-Context header\n set_global_textmap(CloudTraceFormatPropagator())\n.. code-block:: python\n\n from opentelemetry.propagate import set_global_textmap\n from opentelemetry.propagators.cloud_trace_propagator import (\n CloudTraceFormatPropagator,\n )\n\n # Set the X-Cloud-Trace-Context header\n set_global_textmap(CloudTraceFormatPropagator())\n\n\nReferences\n----------\n\n* `Cloud Trace <https://cloud.google.com/trace/>`_\n* `OpenTelemetry Project <https://opentelemetry.io/>`_\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Google Cloud propagator for OpenTelemetry",
"version": "1.6.0",
"project_urls": {
"Homepage": "https://github.com/GoogleCloudPlatform/opentelemetry-operations-python/tree/main/opentelemetry-propagator-gcp"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d3544236b67c4549b5bb4d7f3ef845c557f4a980271671816f3b67b521a84c2b",
"md5": "c2f4b031444f534dc97380896f49251c",
"sha256": "4c5f56050ab590aebde1c8caa266dfb5932dc3ea3c6e394b47d5325a9b7452f3"
},
"downloads": -1,
"filename": "opentelemetry_propagator_gcp-1.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c2f4b031444f534dc97380896f49251c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 9455,
"upload_time": "2023-10-16T22:12:09",
"upload_time_iso_8601": "2023-10-16T22:12:09.620059Z",
"url": "https://files.pythonhosted.org/packages/d3/54/4236b67c4549b5bb4d7f3ef845c557f4a980271671816f3b67b521a84c2b/opentelemetry_propagator_gcp-1.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "19ba8222dd2e17aa15e049f91b8bd70e44f9c2751cb983063cc79348bb68a30d",
"md5": "217be3fe9c7f1d048007c64e3ebc2714",
"sha256": "6395556dd57612b69bdd93448325afbb0f2ea02d912f9fccf836c99b5776914a"
},
"downloads": -1,
"filename": "opentelemetry-propagator-gcp-1.6.0.tar.gz",
"has_sig": false,
"md5_digest": "217be3fe9c7f1d048007c64e3ebc2714",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 10352,
"upload_time": "2023-10-16T22:12:15",
"upload_time_iso_8601": "2023-10-16T22:12:15.168397Z",
"url": "https://files.pythonhosted.org/packages/19/ba/8222dd2e17aa15e049f91b8bd70e44f9c2751cb983063cc79348bb68a30d/opentelemetry-propagator-gcp-1.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-16 22:12:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GoogleCloudPlatform",
"github_project": "opentelemetry-operations-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "opentelemetry-propagator-gcp"
}
JSON
