mirror of
https://github.com/open-telemetry/opentelemetry-python-contrib.git
synced 2026-03-13 08:10:39 +08:00
88e5bfc630
* Add a basic http OpAMP client * Add some docs and hook it into the system Still not building content * Add default value of 30 seconds to heartbeat message interval * Fix docs build * More docs improvements * Fix spellcheck * Remove local workaround * Generate workflows and add to release script * Fix typos in opamp lint commands * Fix requirements for pylint * Update opamp/opentelemetry-opamp-client/pyproject.toml * Recreate requirements * Add missing opentelemetry-api dependency * Fix tox test commands Drop opentelemetry api fixed version from requirements * Fix tox * Add baseline of vcrpy 7.0.0 * Ignore pb2 module in pylintrc * Bump pylint to match the version in core * Silence pylint warnings * Don't trace opamp client own http requests * Permit to pass a custom transport to client And a custom session to RequestsTransport * Don't bump pylint after all * Fix pylint * Try to typecheck opamp client * Bump version after rebase * Fix typecheck in client * Please pyright in strict mode * No need for functions and methods to be private since _opamp module is already private * Add missing protobuf package installation for typecheck * Fix docs generation * Fix pyright exclusion rule for proto Missed .pyi exclusion * Feedback * Don't flush the queue at exit * Log transport send exceptions * Update example to not assume that the config is in json format * Fix typo in exception * Looks like it's implementers * Add timeout to stop to forward to threads join * Clarify doc * Fix typo in var name * Add support for mTLS * Add helpers for handling of ReportFullState ServerToAgent flag Introducing basic handling of the ReportsEffectiveConfig capability * Remove backup file * Rewrite opamp_proto_codegen.sh to use uv * Make the package releasable independently * Send full state at connection * Add 3.14 test run * Add changelog entry * Add missing ReportsEffectiveConfig capability in documentation * Start version from 0.1b0 and re-record e2e tests * Record tests against opentelemetry-go --------- Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com>
120 lines
3.2 KiB
ReStructuredText
120 lines
3.2 KiB
ReStructuredText
OpenTelemetry-Python-Contrib
|
|
============================
|
|
|
|
Complimentary instrumentation and vendor-specific packages for use with the
|
|
Python `OpenTelemetry <https://opentelemetry.io/>`_ client.
|
|
|
|
.. image:: https://img.shields.io/badge/slack-chat-green.svg
|
|
:target: https://cloud-native.slack.com/archives/C01PD4HUVBL
|
|
:alt: Slack Chat
|
|
|
|
|
|
**Please note** that this library is currently in _beta_, and shouldn't
|
|
generally be used in production environments.
|
|
|
|
Installation
|
|
------------
|
|
|
|
There are several complimentary packages available on PyPI which can be
|
|
installed separately via pip:
|
|
|
|
.. code-block:: sh
|
|
|
|
pip install opentelemetry-exporter-{exporter}
|
|
pip install opentelemetry-instrumentation-{instrumentation}
|
|
pip install opentelemetry-sdk-extension-{sdk-extension}
|
|
|
|
A complete list of packages can be found at the
|
|
`Contrib repo instrumentation <https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/instrumentation>`_
|
|
and `Contrib repo exporter <https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/exporter>`_ directories.
|
|
|
|
Extensions
|
|
----------
|
|
|
|
Visit `OpenTelemetry Registry <https://opentelemetry.io/registry/?s=python>`_ to
|
|
find a lot of related projects like exporters, instrumentation libraries, tracer
|
|
implementations, resource, etc.
|
|
|
|
Installing Cutting Edge Packages
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
While the project is pre-1.0, there may be significant functionality that
|
|
has not yet been released to PyPI. In that situation, you may want to
|
|
install the packages directly from the repo. This can be done by cloning the
|
|
repository and doing an `editable
|
|
install <https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs>`_:
|
|
|
|
.. code-block:: sh
|
|
|
|
git clone https://github.com/open-telemetry/opentelemetry-python-contrib.git
|
|
cd opentelemetry-python-contrib
|
|
pip install -e ./instrumentation/opentelemetry-instrumentation-flask
|
|
pip install -e ./instrumentation/opentelemetry-instrumentation-botocore
|
|
pip install -e ./instrumentation-genai/opentelemetry-instrumentation-openai-v2
|
|
pip install -e ./sdk-extension/opentelemetry-sdk-extension-aws
|
|
pip install -e ./resource/opentelemetry-resource-detector-containerid
|
|
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: OpenTelemetry Instrumentations
|
|
:name: Instrumentations
|
|
:glob:
|
|
|
|
instrumentation/**
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: OpenTelemetry Generative AI Instrumentations
|
|
:name: Generative AI Instrumentations
|
|
:glob:
|
|
|
|
instrumentation-genai/**
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: OpenTelemetry Propagators
|
|
:name: Propagators
|
|
:glob:
|
|
|
|
propagator/**
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: OpenTelemetry Performance
|
|
:name: Performance
|
|
:glob:
|
|
|
|
performance/**
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: OpenTelemetry SDK Extensions
|
|
:name: SDK Extensions
|
|
:glob:
|
|
|
|
sdk-extension/**
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: OpenTelemetry Resource Detectors
|
|
:name: Resource Detectors
|
|
:glob:
|
|
|
|
resource/**
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: OpAMP
|
|
:name: OpAMP
|
|
:glob:
|
|
|
|
opamp/**
|
|
|
|
Indices and tables
|
|
------------------
|
|
|
|
* :ref:`genindex`
|
|
* :ref:`modindex`
|
|
* :ref:`search`
|