This release is a pre-release and may not be stable for production use.
Package for gRPC Python CSM Observability.
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).
1 maintainer
Release files for grpcio-csm-observability 1.84.0rc1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| grpcio_csm_observability-1.84.0rc1.tar.gz | 16.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| grpcio_csm_observability-1.84.0rc1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 32.6 kB
Release files / grpcio_csm_observability-1.84.0rc1.tar.gz
| Download URL | grpcio_csm_observability-1.84.0rc1.tar.gz |
|---|---|
| Size | 16.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d7e97bd4f3251bfa1cbb045f8bd4e7e1968542153bb729f1fd46979a765f93e
|
|
BLAKE2b-256 checksum How to use checksums |
6b2fe8c4c896fea052be9a1a7b7429f6ba27c6ce3a2a3f4a26db8c85848f7676
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.15
|
Release files / grpcio_csm_observability-1.84.0rc1-py3-none-any.whl
| Download URL | grpcio_csm_observability-1.84.0rc1-py3-none-any.whl |
|---|---|
| Size | 16.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e86889b49f64d12de85c9c6c1b599101fadbdfbe383638d56919ef59ff3c440
|
|
BLAKE2b-256 checksum How to use checksums |
6f66f6fb37b7c7a947213a5f1cba3b2ebd2a3624044298b2446dcc73cf177186
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.15
|
