OpenTelemetry Google Cloud Integration
======================================
.. image:: https://badge.fury.io/py/opentelemetry-exporter-gcp-trace.svg
:target: https://badge.fury.io/py/opentelemetry-exporter-gcp-trace
.. 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 exporting traces to Google Cloud Trace.
To get started with instrumentation in Google Cloud, see `Generate traces and metrics with
Python <https://cloud.google.com/stackdriver/docs/instrumentation/setup/python>`_.
To learn more about instrumentation and observability, including opinionated recommendations
for Google Cloud Observability, visit `Instrumentation and observability
<https://cloud.google.com/stackdriver/docs/instrumentation/overview>`_.
For resource detection and GCP trace context propagation, see
`opentelemetry-tools-google-cloud
<https://pypi.org/project/opentelemetry-tools-google-cloud/>`_. For the
Google Cloud Monitoring exporter, see
`opentelemetry-exporter-gcp-monitoring
<https://pypi.org/project/opentelemetry-exporter-gcp-monitoring/>`_.
Installation
------------
.. code:: bash
pip install opentelemetry-exporter-gcp-trace
Usage
-----
.. code:: python
from opentelemetry import trace
from opentelemetry.exporter.cloud_trace import CloudTraceSpanExporter
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import (
SimpleSpanProcessor,
)
trace.set_tracer_provider(TracerProvider())
cloud_trace_exporter = CloudTraceSpanExporter(
project_id='my-gcloud-project',
)
trace.get_tracer_provider().add_span_processor(
SimpleSpanProcessor(cloud_trace_exporter)
)
tracer = trace.get_tracer(__name__)
with tracer.start_as_current_span('foo'):
print('Hello world!')
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-exporter-gcp-trace",
"name": "opentelemetry-exporter-gcp-trace",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Google",
"author_email": "opentelemetry-pypi@google.com",
"download_url": "https://files.pythonhosted.org/packages/af/d9/f428c0787adf93776f6341802efcca239d72cd1d1ce41d0bf861d9827cec/opentelemetry_exporter_gcp_trace-1.8.0.tar.gz",
"platform": "any",
"description": "OpenTelemetry Google Cloud Integration\n======================================\n\n.. image:: https://badge.fury.io/py/opentelemetry-exporter-gcp-trace.svg\n :target: https://badge.fury.io/py/opentelemetry-exporter-gcp-trace\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 exporting traces to Google Cloud Trace.\n\nTo get started with instrumentation in Google Cloud, see `Generate traces and metrics with\nPython <https://cloud.google.com/stackdriver/docs/instrumentation/setup/python>`_.\n\nTo learn more about instrumentation and observability, including opinionated recommendations\nfor Google Cloud Observability, visit `Instrumentation and observability\n<https://cloud.google.com/stackdriver/docs/instrumentation/overview>`_.\n\nFor resource detection and GCP trace context propagation, see\n`opentelemetry-tools-google-cloud\n<https://pypi.org/project/opentelemetry-tools-google-cloud/>`_. For the\nGoogle Cloud Monitoring exporter, see\n`opentelemetry-exporter-gcp-monitoring\n<https://pypi.org/project/opentelemetry-exporter-gcp-monitoring/>`_.\n\nInstallation\n------------\n\n.. code:: bash\n\n pip install opentelemetry-exporter-gcp-trace\n\nUsage\n-----\n\n.. code:: python\n\n from opentelemetry import trace\n from opentelemetry.exporter.cloud_trace import CloudTraceSpanExporter\n from opentelemetry.sdk.trace import TracerProvider\n from opentelemetry.sdk.trace.export import (\n SimpleSpanProcessor,\n )\n\n trace.set_tracer_provider(TracerProvider())\n\n cloud_trace_exporter = CloudTraceSpanExporter(\n project_id='my-gcloud-project',\n )\n trace.get_tracer_provider().add_span_processor(\n SimpleSpanProcessor(cloud_trace_exporter)\n )\n tracer = trace.get_tracer(__name__)\n with tracer.start_as_current_span('foo'):\n print('Hello world!')\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 Trace exporter for OpenTelemetry",
"version": "1.8.0",
"project_urls": {
"Homepage": "https://github.com/GoogleCloudPlatform/opentelemetry-operations-python/tree/main/opentelemetry-exporter-gcp-trace"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8f2d4efb4682b7e9fd0bf3c23131b82db4d8c991696eb2d7e5d545963e6e50de",
"md5": "30b164d7ab58f83647ab3b7c38a6d8c9",
"sha256": "ffd4fe9c78683b4e70f0f59df7e9e76c65dcf9b928decfdb4da47facdad26871"
},
"downloads": -1,
"filename": "opentelemetry_exporter_gcp_trace-1.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "30b164d7ab58f83647ab3b7c38a6d8c9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 13973,
"upload_time": "2025-01-08T19:38:54",
"upload_time_iso_8601": "2025-01-08T19:38:54.600656Z",
"url": "https://files.pythonhosted.org/packages/8f/2d/4efb4682b7e9fd0bf3c23131b82db4d8c991696eb2d7e5d545963e6e50de/opentelemetry_exporter_gcp_trace-1.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "afd9f428c0787adf93776f6341802efcca239d72cd1d1ce41d0bf861d9827cec",
"md5": "706612b1c2dfd3c0a7e14d652211fc1e",
"sha256": "b0dd95228567da814ac638da8c66f5aaeac384df55f6b0da2c6e5fb93ca2a8c8"
},
"downloads": -1,
"filename": "opentelemetry_exporter_gcp_trace-1.8.0.tar.gz",
"has_sig": false,
"md5_digest": "706612b1c2dfd3c0a7e14d652211fc1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 18677,
"upload_time": "2025-01-08T19:39:01",
"upload_time_iso_8601": "2025-01-08T19:39:01.200776Z",
"url": "https://files.pythonhosted.org/packages/af/d9/f428c0787adf93776f6341802efcca239d72cd1d1ce41d0bf861d9827cec/opentelemetry_exporter_gcp_trace-1.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-08 19:39:01",
"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-exporter-gcp-trace"
}
JSON
