Metadata-Version: 2.4
Name: guance-opentelemetry-distro
Version: 0.63b3
Summary: Guance OpenTelemetry Python Distro
Project-URL: Homepage, https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/guance-opentelemetry-distro
Project-URL: Repository, https://github.com/open-telemetry/opentelemetry-python-contrib
Author-email: OpenTelemetry Authors <cncf-opentelemetry-contributors@lists.cncf.io>
License-Expression: Apache-2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: opentelemetry-api~=1.12
Requires-Dist: opentelemetry-contrib-instrumentations==0.61b0
Requires-Dist: opentelemetry-exporter-otlp==1.40.0
Requires-Dist: opentelemetry-instrumentation==0.61b0
Requires-Dist: opentelemetry-sdk~=1.13
Provides-Extra: profiling
Requires-Dist: opentelemetry-sdk-extension-profiling==0.63b3; extra == 'profiling'
Description-Content-Type: text/x-rst

Guance OpenTelemetry Distro
===========================

|pypi|

.. |pypi| image:: https://badge.fury.io/py/guance-opentelemetry-distro.svg
   :target: https://pypi.org/project/guance-opentelemetry-distro/

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

::

    pip install guance-opentelemetry-distro

To install the distro with Python profiling support:

::

    pip install guance-opentelemetry-distro[profiling]

This package provides entrypoints to configure OpenTelemetry.

Command Line
------------

The package also installs a ``gtrace`` command as a shorthand for
auto-instrumented launches:

::

    gtrace uvicorn fastapi-demo:app --host 127.0.0.1 --port 18082

Profiling
---------

The ``profiling`` extra installs the
``opentelemetry-sdk-extension-profiling`` package, which registers an
``opentelemetry_pre_instrument`` entry point. Enable it with:

::

    export OTEL_PYTHON_PROFILING_ENABLED=true
    gtrace python app.py

When ``OTEL_PYTHON_PROFILING_PPROF_UPLOAD_URL`` is configured and
``OTEL_PYTHON_PROFILING_EXPORTER`` is unset, profiling defaults to a
legacy-compatible ``pprof`` upload layout. Explicit
``OTEL_PYTHON_PROFILING_*`` settings take precedence.

References
----------

* `OpenTelemetry Project <https://opentelemetry.io/>`_
* `Example using guance-opentelemetry-distro <https://opentelemetry.io/docs/instrumentation/python/distro/>`_
