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: