pytest extensions for OpenTelemetry
Project description
otel-extensions-pytest: A pytest extension for OpenTelemetry
otel-extensions-pytest
is a pytest plugin that will automatically instrument a pytest-based test session,
wrapping the test session in a span and wrapping each test in a child span.
Dependencies
- Python >= 3.6
- pytest >= 6.2
Installation
pip install
You can install through pip using:
pip install otel-extensions-pytest
(you may need to run pip
with root permission: sudo pip install otel-extensions-pytest
)
Setuptools
Install via Setuptools.
python setup.py install --user
(or sudo python setup.py install
to install the package for all users)
Usage
Enable the plugin by adding
pytest_plugins = ("otel_extensions_pytest",)
to your conftest.py
, or by adding the option -p otel_extensions_pytest
to the pytest command line.
For tracing to be enabled, you need to specify a trace receiver endpoint using the command-line option
--otel-endpoint
or by setting the environment variable OTEL_EXPORTER_OTLP_ENDPOINT
.
e.g. --otel-endpoint http://localhost:4317/
The full set of options are shown here:
Command-line Option | Environment Variable | Description |
---|---|---|
--otel_service_name |
OTEL_SERVICE_NAME |
Name of resource/service for traces |
--otel_session_name |
OTEL_SESSION_NAME |
Name of parent session span |
--otel_endpoint |
OTEL_EXPORTER_OTLP_ENDPOINT |
OTLP Receiver Endpoint |
--otel_protocol |
OTEL_EXPORTER_OTLP_PROTOCOL |
protocol for OTLP receiver (supported: gprc , http/protobuf , custom ) |
--otel_processor_type |
OTEL_PROCESSOR_TYPE |
Span Processor type (batch: use BatchSpanProcessor , simple: use SimpleSpanProcessor |
--otel_traceparent |
TRACEPARENT |
Parent span id. Will be injected into current context (useful when running automated tests using the OpenTelemetry Jenkins plugin) |
n/a | OTEL_EXPORTER_OTLP_CERTIFICATE |
path to CA bundle for verifying TLS cert of receiver endpoint |
n/a | OTEL_EXPORTER_CUSTOM_SPAN_EXPORTER_TYPE |
Custom span exporter class (needed if protocol set to custom ) |
Additional Features
@instrumented_fixture
decorator
You can decorate fixtures by using the @instrumented_fixture
decorator. If the fixture is a generator (i.e. has a yield
statement), separate spans will be created for the setup and teardown phases.
from otel_extensions_pytest import instrumented_fixture
# note: all options of pytest.fixture() are supported (autouse, etc)
@instrumented_fixture(scope="function")
def my_fixture():
""" Span is automatically created using `my_fixture` as span name """
return "foo"
@instrumented_fixture(scope="function")
def my_generator_fixture():
# A span named `my_generator_fixture (setup)` is automatically created for this section
time.sleep(5)
yield "foo"
# A span named `my_generator_fixture (teardown)` is automatically created for this section
time.sleep(5)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for otel-extensions-pytest-0.1.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e05d2572ba61504f555890dba8f66234245f635cdcc5bcf520007161caca1b33 |
|
MD5 | 31beb59f69c79c32e6e21d25c13fb2e8 |
|
BLAKE2b-256 | 0037a2eafe5814e63696cdd296212d4c6e91a1526cb83457edc9824055ee632f |
Hashes for otel_extensions_pytest-0.1.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3b37379da55a0d4e01ea0718b2946d5fdae4b5a13ad5675074427a9f10694455 |
|
MD5 | b76c81d7121ec90b9847f2107cd29efd |
|
BLAKE2b-256 | 1c2b1dc52fe026445b729854147e24ca00e9b21d597dbf1e5b35ef03c7793c6a |