fix(ci): repair sw_grpc on grpcio 1.83 and sw_websockets under uvicorn >= 0.50

Both plugin tests have been failing on every master CI run since 88d30ab;
neither failure changes the supported version scope.

- sw_grpc (grpcio == 1.*): grpcio 1.83.0 added an isinstance(x, Channel)
  validation in grpc.aio._channel resolved from the module global, which
  the plugin had rebound to a factory function -> TypeError on every aio
  stub creation. Replace the factory with a Channel subclass; verified
  against grpcio 1.83.0 and 1.82.1 with full trace validation.
- sw_websockets (10.3/10.4): uvicorn 0.50.0 (2026-07-04) removed its
  legacy websockets fallback and unconditionally imports
  websockets.server.ServerProtocol (websockets >= 11 only), so the
  unpinned test harness crashed at startup with websockets 10.x. Pin
  uvicorn < 0.50 in the test compose; websockets 10.3/10.4 stay tested.
  Also extend the support matrix with websockets 17.0.1 (latest), which
  passes span validation with the plugin unmodified.

Note: both uvicorn < 0.50's server impl and the plugin's client
instrumentation rest on websockets.legacy (deprecated since websockets
14); when upstream removes it the plugin needs a rewrite against
websockets.asyncio.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: wu-sheng

docs/en/setup/Plugins.md

@@ -51,7 +51,7 @@ or a limitation of SkyWalking auto-instrumentation (welcome to contribute!)
 | [urllib3](https://urllib3.readthedocs.io/en/latest/) | Python >=3.12 - NOT SUPPORTED YET; Python >=3.10 - ['1.26', '1.25'];  | `sw_urllib3` |
 | [urllib3](https://urllib3.readthedocs.io/en/latest/) | Python >=3.12 - ['2.3', '2.0'];  | `sw_urllib3_v2` |
 | [urllib_request](https://docs.python.org/3/library/urllib.request.html) | Python >=3.7 - ['*'];  | `sw_urllib_request` |
-| [websockets](https://websockets.readthedocs.io) | Python >=3.7 - ['10.3', '10.4'];  | `sw_websockets` |
+| [websockets](https://websockets.readthedocs.io) | Python >=3.7 - ['10.3', '10.4', '17.0.1'];  | `sw_websockets` |
 ### Notes
 - The celery server running with "celery -A ..." should be run with the HTTP protocol
 as it uses multiprocessing by default which is not compatible with the gRPC protocol implementation

skywalking/plugins/sw_grpc.py

@@ -448,25 +448,32 @@ async def intercept_stream_stream(
             ) -> grpc.aio._call.StreamStreamCall:
                 return await self._intercept(continuation, client_call_details, request_iterator)
 
-        def _sw_grpc_aio_channel_factory(
-            target: str,
-            options: grpc.aio.ChannelArgumentType,
-            credentials: Optional[grpc.ChannelCredentials],
-            compression: Optional[grpc.Compression],
-            interceptors: Optional[Sequence[grpc.aio.ClientInterceptor]],
-        ):
-            if target == config.agent_collector_backend_services:
-                return _aio_grpc_channel(target, options, credentials, compression, interceptors)
-            _sw_interceptors: List[grpc.aio.ClientInterceptor] = [
-                _AioClientUnaryUnaryInterceptor(target),
-                _AioClientUnaryStreamInterceptor(target),
-                _AioClientStreamUnaryInterceptor(target),
-                _AioClientStreamStreamInterceptor(target),
-            ]
-            _sw_interceptors.extend(interceptors or [])
-            return _aio_grpc_channel(target, options, credentials, compression, _sw_interceptors)
-
-        _aio_channel.Channel = _sw_grpc_aio_channel_factory
+        # Must remain a class assigned to the module-global name `Channel`:
+        # since grpcio 1.83.0, grpc.aio._channel._BaseMultiCallable.__init__ validates
+        # `isinstance(self._references[0], Channel)` against this module global, so
+        # rebinding it to a plain factory function raises
+        # `TypeError: isinstance() arg 2 must be a type, ...` on every stub creation.
+        class _SWAioChannel(_aio_grpc_channel):
+            def __init__(
+                self,
+                target: str,
+                options: grpc.aio.ChannelArgumentType,
+                credentials: Optional[grpc.ChannelCredentials],
+                compression: Optional[grpc.Compression],
+                interceptors: Optional[Sequence[grpc.aio.ClientInterceptor]],
+            ):
+                if target != config.agent_collector_backend_services:
+                    _sw_interceptors: List[grpc.aio.ClientInterceptor] = [
+                        _AioClientUnaryUnaryInterceptor(target),
+                        _AioClientUnaryStreamInterceptor(target),
+                        _AioClientStreamUnaryInterceptor(target),
+                        _AioClientStreamStreamInterceptor(target),
+                    ]
+                    _sw_interceptors.extend(interceptors or [])
+                    interceptors = _sw_interceptors
+                super().__init__(target, options, credentials, compression, interceptors)
+
+        _aio_channel.Channel = _SWAioChannel
 
     install_async_client()
     install_async_server()

skywalking/plugins/sw_websockets.py

@@ -21,7 +21,7 @@
 link_vector = ['https://websockets.readthedocs.io']
 support_matrix = {
     'websockets': {
-        '>=3.7': ['10.3', '10.4']
+        '>=3.7': ['10.3', '10.4', '17.0.1']
     }
 }
 note = """The websocket instrumentation only traces client side connection handshake,

tests/plugin/http/sw_websockets/docker-compose.yml

@@ -34,7 +34,7 @@ services:
     depends_on:
       collector:
         condition: service_healthy
-    command: ['bash', '-c', 'pip install fastapi uvicorn && pip install -r /app/requirements.txt && sw-python run python3 /app/services/provider.py']
+    command: ['bash', '-c', 'pip install fastapi "uvicorn<0.50" && pip install -r /app/requirements.txt && sw-python run python3 /app/services/provider.py']
     healthcheck:
       test: ["CMD", "bash", "-c", "cat < /dev/null > /dev/tcp/127.0.0.1/9091"]
       interval: 5s
@@ -52,7 +52,7 @@ services:
       - 9090:9090
     volumes:
       - .:/app
-    command: ['bash', '-c', 'pip install fastapi uvicorn && pip install -r /app/requirements.txt && sw-python run python3 /app/services/consumer.py']
+    command: ['bash', '-c', 'pip install fastapi "uvicorn<0.50" && pip install -r /app/requirements.txt && sw-python run python3 /app/services/consumer.py']
     depends_on:
       collector:
         condition: service_healthy