grpcio-csds

library1.81.1pypypi✓ verified 79d ago

Provides a client for the gRPC Client Status Discovery Service (CSDS), enabling retrieval of xDS configuration dumps for debugging and observability. Version 1.80.0 requires Python >=3.9, follows gRPC's major release cadence.

observability http-networking

pip install grpcio-csds

package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · GRPCIO-CSDS

grpcio-csds

observabilitypythonv1.81.1

Install

3.9s avg

Import

—

Disk

59MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.81.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 61.7MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.9s · import 0.000s · 60MB

59MB installed

● package 59MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ClientStatusDiscoveryServiceServicer

✓ from grpc_csds import ClientStatusDiscoveryServiceServicer

✗ from grpc_csds import ClientStatusDiscoveryServiceClient

add_csds_servicer

✓ from grpc_csds import add_csds_servicer

csds_pb2

✓ from grpc_csds import csds_pb2

Fetch xDS configuration from a CSDS server (assumes gRPC server on localhost:8080).

import grpc from grpc_csds import ClientStatusDiscoveryServiceStub from grpc_csds.v2.client_status_pb2 import ClientStatusRequest channel = grpc.insecure_channel('localhost:8080') stub = ClientStatusDiscoveryServiceStub(channel) request = ClientStatusRequest(node_identifiers=[]) response = stub.FetchClientStatus(request) print(response.config)

Debug

Known issues

gotchaImport uses underscore (grpc_csds), not hyphen (grpcio-csds) as in the package name.

fix

Use `from grpc_csds import ...` as the import path.

affects: all

gotchaCSDS is only available if the gRPC channel is configured with xDS. Calling FetchClientStatus without xDS bootstrapping will cause errors.

fix

Ensure GRPC_XDS_BOOTSTRAP environment variable is set or use `xds_credentials` when creating the channel.

affects: all

deprecatedThe v1alpha1 API is deprecated; use v2 API instead.

fix

Use `from grpc_csds.v2 import ...` instead of `from grpc_csds.v1alpha1 import ...`.

affects: >=1.60.0

Upgrade

Version history

1.81.1latest on PyPI · released Jun 11, 2026

Audit

Dependencies

grpciorequiredCore gRPC library with xDS support

protobufrequiredProtocol Buffers for CSDS messages

Agent activity

27 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/grpcio-csds/ ↗

homepagehttps://grpc.io ↗

docshttps://grpc.github.io/grpc/python/grpc_csds.html ↗