gRPC Python CSM observability package
Project description
Package for gRPC Python CSM Observability.
Supported Python Versions
Python >= 3.8
Installation
Currently gRPC Python CSM Observability is only available for Linux.
Installing From PyPI
$ pip install grpcio-csm-observability
Installing From Source
$ export REPO_ROOT=grpc # REPO_ROOT can be any directory of your choice $ git clone -b RELEASE_TAG_HERE https://github.com/grpc/grpc $REPO_ROOT $ cd $REPO_ROOT $ git submodule update --init $ cd src/python/grpcio_csm_observability # For the next command do `sudo pip install` if you get permission-denied errors $ pip install .
Dependencies
gRPC Python CSM Observability Depends on the following packages:
grpcio grpcio-observability opentelemetry-sdk
Usage
Example usage is similar to the example here, instead of importing from grpc_observability, you should import from grpc_csm_observability:
import grpc_csm_observability
csm_otel_plugin = grpc_csm_observability.CsmOpenTelemetryPlugin(
meter_provider=provider
)We also provide several environment variables to help you optimize gRPC python observability for your particular use.
Note: The term “Census” here is just for historical backwards compatibility reasons and does not imply any dependencies.
- GRPC_PYTHON_CENSUS_EXPORT_BATCH_INTERVAL
This controls how frequently telemetry data collected within gRPC Core is sent to Python layer.
Default value is 0.5 (Seconds).
- GRPC_PYTHON_CENSUS_MAX_EXPORT_BUFFER_SIZE
This controls the maximum number of telemetry data items that can be held in the buffer within gRPC Core before they are sent to Python.
Default value is 10,000.
- GRPC_PYTHON_CENSUS_EXPORT_THRESHOLD
This setting acts as a trigger: When the buffer in gRPC Core reaches a certain percentage of its capacity, the telemetry data is sent to Python.
Default value is 0.7 (Which means buffer will start export when it’s 70% full).
- GRPC_PYTHON_CENSUS_EXPORT_THREAD_TIMEOUT
This controls the maximum time allowed for the exporting thread (responsible for sending data to Python) to complete.
Main thread will terminate the exporting thread after this timeout.
Default value is 10 (Seconds).
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
File details
Details for the file grpcio_csm_observability-1.67.0rc1.tar.gz.
File metadata
- Download URL: grpcio_csm_observability-1.67.0rc1.tar.gz
- Upload date:
- Size: 16.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a0bf79672e1817c9c6425e11ab1845ad4526e13dc2f22117f39cbf719d0af92a |
|
| MD5 | 847d1d755488c1a4fccc2f950087c0a0 |
|
| BLAKE2b-256 | 56901613ac843d45ddec0e520cb3ba5214d6c917100ed0e8582b29e2dba37b9c |
File details
Details for the file grpcio_csm_observability-1.67.0rc1-py3-none-any.whl.
File metadata
- Download URL: grpcio_csm_observability-1.67.0rc1-py3-none-any.whl
- Upload date:
- Size: 16.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9375b5d859524f3383a59723ad4f116199299f9a8db7a10ec6c2c37471c4c327 |
|
| MD5 | b840e819ff9c831369af180cd3ae362a |
|
| BLAKE2b-256 | 169ba0df5f7e4ebe9690778e29cfd514b9c4ef5f99887c52397ded796d706dfe |
