{"id":45050,"library":"grpcio-admin","title":"gRPC Admin Services","description":"A collection of gRPC admin services for Python, including channelz, CSDS, and admin interface management. Latest version 1.81.0, released frequently alongside grpcio.","status":"active","version":"1.81.0","language":"python","source_language":"en","source_url":"https://github.com/grpc/grpc/tree/master/src/python/grpcio_admin","tags":["grpc","admin","channelz","csds"],"install":[{"cmd":"pip install grpcio-admin","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"core gRPC library required for admin services","package":"grpcio","optional":false},{"reason":"optional channelz service","package":"grpcio-channelz","optional":true}],"imports":[{"wrong":"from grpc_admin import AdminInterface","symbol":"add_admin_servicers","correct":"from grpc_admin import add_admin_servicers"},{"symbol":"channelz","correct":"from grpc_admin import channelz"},{"symbol":"grpc_csds","correct":"from grpc_admin import grpc_csds"}],"quickstart":{"code":"import grpc\nfrom grpc_admin import AdminInterface\nimport os\n\nserver = grpc.server(futures.ThreadPoolExecutor())\nadmin = AdminInterface(server)\nadmin.add_channelz()\nserver.add_insecure_port('[::]:50051')\nserver.start()\nserver.wait_for_termination()","lang":"python","description":"Creates a gRPC server with admin interface and channelz service enabled."},"warnings":[{"fix":"Replace `admin.add_admin_handlers()` with `admin.add_channelz()` for channelz, and check other methods.","message":"In grpcio-admin 1.81.0, the AdminInterface API changed: `add_channelz()` replaced `add_admin_handlers()`. Old code will raise AttributeError.","severity":"breaking","affected_versions":">=1.81.0"},{"fix":"Use `from grpc_admin import AdminInterface` instead of `from grpcio_admin import AdminInterface`.","message":"The `grpcio_admin` module is deprecated in favor of `grpc_admin` since version 1.81.0.","severity":"deprecated","affected_versions":">=1.81.0"},{"fix":"Install `pip install grpcio-channelz` and import `from grpc_channelz.v1 import channelz`.","message":"Channelz service requires the `grpcio-channelz` package to be installed separately. Importing from `grpc_channelz.v1` will fail if not installed.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.81.0':21 'admin':2,8,16,27 'alongsid':24 'channelz':13,28 'collect':5 'csds':14,29 'frequent':23 'grpc':1,7,26 'grpcio':25 'includ':12 'interfac':17 'latest':19 'manag':18 'python':11 'releas':22 'servic':3,9 'version':20","created_at":"2026-06-07T12:53:07.739886+00:00","updated_at":"2026-06-07T12:53:07.739886+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}