You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by wu...@apache.org on 2026/10/08 06:28:20 UTC

(skywalking-website) branch master updated: Release Apache SkyWalking Java Agent 9.8.0 (#941)

This is an automated email from the ASF dual-hosted git repository.

wu-sheng pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/skywalking-website.git


The following commit(s) were added to refs/heads/master by this push:
     new c8df8a926009 Release Apache SkyWalking Java Agent 9.8.0 (#941)
c8df8a926009 is described below

commit c8df8a9260093e37a6537590ddc3c483e7193a39
Author: 吴晟 Wu Sheng <wu...@foxmail.com>
AuthorDate: Thu Oct 8 14:28:14 2026 +0800

    Release Apache SkyWalking Java Agent 9.8.0 (#941)
    
    * Release Apache SkyWalking Java Agent 9.8.0
    
    * Withdraw Java Agent 9.7.0 from downloads and docs, and explain it in the 9.8.0 post
    
    The 9.7.0 binary archive carries macOS AppleDouble ._ files that the agent
    tries to load as plugins (apache/skywalking#14080).
---
 .../index.md                                       | 90 ++++++++++++++++++++++
 data/projects.yml                                  | 20 ++---
 2 files changed, 100 insertions(+), 10 deletions(-)

diff --git a/content/events/release-apache-skywalking-java-agent-9-8-0/index.md b/content/events/release-apache-skywalking-java-agent-9-8-0/index.md
new file mode 100644
index 000000000000..50e7e54ce487
--- /dev/null
+++ b/content/events/release-apache-skywalking-java-agent-9-8-0/index.md
@@ -0,0 +1,90 @@
+---
+title: Release Apache SkyWalking Java Agent 9.8.0
+date: 2026-10-08
+author: SkyWalking Team
+description: "Release Apache SkyWalking Java Agent 9.8.0."
+---
+
+SkyWalking Java Agent 9.8.0 is released. Go to [downloads](/downloads) page to find release tars.
+
+**Notice on 9.7.0.** The 9.7.0 binary distribution, `apache-skywalking-java-agent-9.7.0.tgz`, was packaged on macOS
+and carries AppleDouble `._*` metadata files next to every jar, see
+[apache/skywalking#14080](https://github.com/apache/skywalking/issues/14080). The agent tries to load the `._*.jar`
+entries as plugins and activations, logs `could not be resolved` errors at startup, and the Logback activation can
+fail to initialize, which breaks `GRPCLogClientAppender` log reporting. Traces and metrics still work, but the
+distribution is not what was intended. 9.7.0 has therefore been removed from the downloads and documentation pages
+on this site. Users on 9.7.0 should upgrade to 9.8.0, whose source and binary archives are built without these files.
+Changes by Version
+
+9.8.0
+------------------
+
+* Fix the `spring-cloud-gateway-4.x` plugin propagating another request's context. Since Spring Cloud
+  Gateway 4.1.2 the outbound chain is assembled in `NettyRoutingFilter#filter` but subscribed later, so the
+  plugin parked the request's `ContextSnapshot` on the `HttpClient` returned by
+  `NettyRoutingFilter#getHttpClient`, which is the single shared bean unless a connect timeout is configured.
+  A concurrent request could overwrite it before the chain was subscribed, and the outbound `sw8` header then
+  carried a context the downstream service joined by mistake. The snapshot is held by a client derived per
+  request now (apache/skywalking#14095).
+* Fix the `httpclient-5.x-plugin` async client tracing (apache/skywalking#14097):
+  * `FutureCallback` no longer stops a span. With `HttpAsyncClients.classic(...)` the callback runs on the caller
+    thread, where it used to close the caller's own active span.
+  * The HTTP exit span is now created in the caller's context when the request is sent, detached right away, and
+    finished by reference when the response ends. Nothing is left on the I/O reactor thread's span stack any more,
+    so overlapping requests on one reactor thread no longer nest into or close each other's spans.
+  * The `httpasyncclient/local` span and its cross-thread segment are removed. The HTTP exit span now lives in the
+    caller's own segment.
+  * HttpClient 5.4+ async requests are traced now. Previously the plugin produced no spans for them, because
+    `doExecute` received a `null` `HttpContext` and the request was not yet in the context when `IOSessionImpl#poll`
+    ran.
+  * A response that fails after its head, while the body is read or when the consumer builds the result at EOF,
+    now ends the span as an error with the exception logged, instead of as a success or an error without a cause.
+  * The destination is taken from the explicit target or the request authority, as the client routes it, so
+    routable names that `java.net.URI` does not parse as a host (e.g. `service_name`) are traced and propagated.
+  * The `url` tag keeps the path encoded as it was sent (e.g. `%2F` stays `%2F`).
+* Fix the `NullPointerException` thrown by the `spring-webflux-5.x-webclient` and
+  `spring-webflux-6.x-webclient` plugins when `DefaultClientRequestBuilder$BodyInserterRequest#writeTo` runs
+  before any exit span exists. Connectors such as `JdkClientHttpConnector` call `writeTo` eagerly at assembly
+  time, while the exchange interceptor creates the exit span and its `ContextCarrier` only at subscription, so
+  the interception failed and the `sw8` header was not propagated. The carrier injection is now null-guarded
+  and, if the carrier is still absent, retried when the returned `Mono` is subscribed (apache/skywalking#13589).
+* Fix the `spring-ai-1.x-plugin` `ChatModelStreamInterceptor` leaking its async span when
+  `ChatModel#stream(Prompt)` fails synchronously, which silently dropped the whole `TraceSegment`
+  of the request (apache/skywalking#14098).
+* Fix `jedis-4.x-plugin`'s `AbstractConnectionInterceptor` double-stopping the span stack on any
+  Redis-level exception (or a null dynamic field on a pooled/recycled `Connection`), which corrupted
+  the parent trace for the rest of the request (apache/skywalking#14085).
+* Add Spring LDAP 3.3.x-4.x plugin.
+* Exclude macOS metadata files from source and binary release archives (apache/skywalking#14080).
+* Fix `NoSuchMethodError: org.apache.skywalking.apm.plugin.spring.webflux.v6.DispatcherHandlerHandleMethodInterceptor`
+  on Spring Framework 7 (Spring Boot 4). `HttpHeaders` no longer implements `MultiValueMap`, so
+  `List get(Object)` was removed; the entry span was never created and the service produced no
+  traces. Affects `spring-webflux-6.x` and, through its shaded copy, `spring-cloud-gateway-4.x`
+  (apache/skywalking#14047).
+* Extend `spring-webflux-6.x`, `spring-webflux-6.x-webclient`, `springmvc-annotation-6.x`,
+  `spring-resttemplate-6.x` and `spring-cloud-gateway-4.x` plugins to support Spring Framework 7,
+  Spring Boot 4 and Spring Cloud Gateway 5.x.
+* Add Spring version witnesses to the `spring-webflux-5.x` and `spring-webflux-6.x` plugins, so they
+  no longer both match `DispatcherHandler#handle` on Reactor 3.4 (Spring Boot 2.4-2.7).
+* **Breaking:** rename `apm-toolkit-webflux` to `apm-toolkit-webflux-5.x` and move its package to
+  `org.apache.skywalking.apm.toolkit.webflux.v5`; add `apm-toolkit-webflux-6.x`
+  (`org.apache.skywalking.apm.toolkit.webflux.v6`) for Reactor 3.5+ / Spring Boot 3.x and 4.x, where
+  `WebFluxSkyWalkingOperators#continueTracing` previously threw `NoSuchMethodError` because Reactor
+  removed `Signal#getContext()` in 3.5.0. Existing `apm-toolkit-webflux` jars (9.7.0 and earlier)
+  remain instrumented by the agent, so upgrading the agent alone does not force a change.
+* Fix the Log4j2 plugin descriptor (`Log4j2Plugins.dat`) missing from the `apm-toolkit-log4j-2.x` jar since 9.5.0, which broke `%traceId` and `%sw_ctx` resolution in Log4j2 `PatternLayout` (apache/skywalking#14006).
+* Deploy the root `java-agent` POM to Maven Central again. It is the parent of
+  `apm-application-toolkit` and therefore of every published toolkit artifact, but 9.7.0 skipped it,
+  so resolving any `org.apache.skywalking:apm-toolkit-*:9.7.0` failed with `Non-resolvable parent POM
+  ... Could not find artifact org.apache.skywalking:java-agent:pom:9.7.0` (apache/skywalking#13988).
+* Stop reporting datasource timeout configuration as metrics. The c3p0 `maxIdleTime`, DBCP `maxWaitMillis`
+  and HikariCP `connectionTimeout`, `validationTimeout`, `idleTimeout` and `leakDetectionThreshold` gauges are no longer reported.
+* Support logback 1.6.x in `apm-toolkit-logback-1.x` (apache/skywalking#14120). `TraceIdPatternLogbackLayout` and
+  `TraceIdMDCPatternLogbackLayout` failed with `NoSuchFieldError: defaultConverterMap`, because logback 1.6.0 removed
+  `PatternLayout.defaultConverterMap`. The layouts now register their conversion words in the logging context's
+  conversion rule registry when they start, which logback 1.2.x to 1.6.x all read, so the same toolkit artifact keeps
+  working on older logback. Logback 1.5.13 is not supported because of an upstream regression fixed in 1.5.14
+  (qos-ch/logback#885). The words are no longer registered for the whole JVM, so using `%tid` or `%sw_ctx` in
+  other encoders, such as a plain `<encoder><pattern>`, requires declaring them as `<conversionRule>`s.
+
+All issues and pull requests are [here](https://github.com/apache/skywalking/milestone/263?closed=1)
diff --git a/data/projects.yml b/data/projects.yml
index 1123fbd4e946..5ac32bd0e00c 100644
--- a/data/projects.yml
+++ b/data/projects.yml
@@ -576,23 +576,23 @@ catalogs:
             link: https://hub.docker.com/r/apache/skywalking-java-agent
         archive: https://archive.apache.org/dist/skywalking/java-agent/
         releases:
-          - version: v9.7.0
+          - version: v9.8.0
             latest: true
             docs:
-              link: /docs/skywalking-java/v9.7.0/readme/
-              commitId: 7a6c1e46c9c8ee7f26988caf57c5023c1ff4fb42
+              link: /docs/skywalking-java/v9.8.0/readme/
+              commitId: 805f9418a7fe5ffc8cfbf789c7977b1b670d2c2e
             downloads:
               - name: Source archive
                 type: source
-                link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.7.0/apache-skywalking-java-agent-9.7.0-src.tgz
-                asc: https://downloads.apache.org/skywalking/java-agent/9.7.0/apache-skywalking-java-agent-9.7.0-src.tgz.asc
-                sha512: https://downloads.apache.org/skywalking/java-agent/9.7.0/apache-skywalking-java-agent-9.7.0-src.tgz.sha512
+                link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.8.0/apache-skywalking-java-agent-9.8.0-src.tgz
+                asc: https://downloads.apache.org/skywalking/java-agent/9.8.0/apache-skywalking-java-agent-9.8.0-src.tgz.asc
+                sha512: https://downloads.apache.org/skywalking/java-agent/9.8.0/apache-skywalking-java-agent-9.8.0-src.tgz.sha512
               - name: Binary archive
                 type: binary
-                link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.7.0/apache-skywalking-java-agent-9.7.0.tgz
-                asc: https://downloads.apache.org/skywalking/java-agent/9.7.0/apache-skywalking-java-agent-9.7.0.tgz.asc
-                sha512: https://downloads.apache.org/skywalking/java-agent/9.7.0/apache-skywalking-java-agent-9.7.0.tgz.sha512
-            date: Aug. 14th, 2026
+                link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.8.0/apache-skywalking-java-agent-9.8.0.tgz
+                asc: https://downloads.apache.org/skywalking/java-agent/9.8.0/apache-skywalking-java-agent-9.8.0.tgz.asc
+                sha512: https://downloads.apache.org/skywalking/java-agent/9.8.0/apache-skywalking-java-agent-9.8.0.tgz.sha512
+            date: Oct. 8th, 2026
           - version: v9.6.0
             latest: false
             docs: