# What's New
## Highlights
### ApplicationName: 254-Character Support
```properties
-Dpinpoint.modules.uid.version=v3
# This property must be added when starting the agent.
# It is compatible with collector versions 3.1.0 and higher.
```
The maximum length of `applicationName` has been expanded from 24 to 254 characters, aligning it with `SERVICE_NAME_MAX_LEN`.
**Impact**: Users with long, structured application identifiers (e.g., `team.service.environment.region`) can now register them as-is, removing the prior naming constraint that forced abbreviations.
### ServerMap V3 — Performance Improvements
ServerMap has been rebuilt as **ServerMap V3** with a redesigned storage layout and query path.
* New Map Tables: `MapAppSelf`, `MapAgentSelf`, `MapAppOut`, `MapAppIn`, `MapAppHost`
* Schema: [`hbase-create-snappy.hbase`](https://github.com/pinpoint-apm/pinpoint/blob/master/hbase/scripts/hbase-create-snappy.hbase#L23)
**Impact**: Faster initial render and time-range navigation on large topologies, lower HBase read amplification, and improved support for 254-character ApplicationName values.
### GrpcBatchDataSender — Unary Span Transport
A new span transport, `SpanBatchGrpcDataSender`, replaces the long-lived gRPC bidirectional stream (`SpanGrpcDataSender`) with a unary `SendSpanList` RPC that ships spans in independent batches.
Starting from 3.1.0, `BATCH` is the default in both local and release profiles:
```properties
# pinpoint-root.config
profiler.transport.grpc.span.sender.type=BATCH # BATCH | STREAM
```
**Collector-side support**: the receiver-side `SpanService` exposes the new `SendSpanList` RPC and returns batch-level results. **Requires a 3.1.0+ collector.** Older collectors should keep `sender.type=STREAM`.
**Impact**: simpler operational model (no stream restarts on partial failures), better resilience behind L7 proxies and rolling collector deploys, and tunable batching that lets operators trade latency versus RPC overhead per workload.
### OpenTelemetry Metric Collection
Pinpoint Collector now supports receiving metrics via the **OTLP protocol**. Applications can send metrics using the OpenTelemetry SDK or OpenTelemetry Collector without requiring the Pinpoint Agent.
📖 [Manual](https://pinpoint-apm.gitbook.io/pinpoint/documents/otel_metric)
### Heatmap View
A new **Heatmap** view is now available alongside Scatter Chart. While Scatter Chart plots individual transactions, Heatmap provides a statistics-based visualization for faster data overview.
📖 [Manual](https://pinpoint-apm.gitbook.io/pinpoint/documents/heatmap)
### Error Reason Categorization
Errors are now categorized (e.g. `exception`, `http-status`, `sql`) and the category is shown on the call stack in the web UI, so you can tell at a glance why a span was marked as an error.
Opt-in via agent configuration:
```properties
profiler.error.enable=true
```
Choose which categories should mark a span as an error (default: all enabled):
```properties
# Allow-list
profiler.error.mark=http-status,sql
# Or deny-list
profiler.error.mark.exclude=exception
```
### JDBC SQL Cache Expiration
The SQL cache now expires entries after a configurable time, causing the agent to re-send the metadata periodically.
```properties
# Default: 168 hours (7 days). Set 0 or negative to disable.
profiler.jdbc.sqlcacheexpirehours=168
```
### TraceIndex — Scatter Chart and Transaction List Performance Improvements
Scatter Chart and Transaction List now use the new `TraceIndex` table for transaction lookup and filtering.
**Impact**: Faster scatter chart loading, improved filtering efficiency for large transaction volumes, and support for longer `applicationName` values.
### Application and Agent List Performance Improvements
Application List and Agent List now use the new `Application` and `AgentId` tables with optimized lookup and active agent validation.
**Impact**: Faster application and agent list queries with reduced backend processing overhead.
### System Metric — Multi-table Mode
System Metric now supports **multi-table mode** for improved performance and scalability in large environments.
***
## Deprecation
### Flink-based Inspector
The legacy Inspector that relied on Apache Flink for statistics aggregation has been **deprecated**. The new Inspector uses **Apache Pinot** for data collection and display. Please migrate to the new Pinot-based Inspector.
***
### Compatibility Improvements
* Apache HttpClient 5.6
* MongoDB Java Driver 5.6
* Kafka 4.x
* async-http-client 3.x
* ClickHouse Java Client V2 (0.8.0)
* Spring R2DBC plugin: `io.asyncer:r2dbc-mysql` support
* New plugin: **IBM DB2**
### Observability and Tracing Improvements
* **Reactor / reactor-netty**: reduced excessive span event generation to lower trace noise
* **Kafka Streams**: entry point changed so requests are traced individually rather than only at the queue polling level
* **Spring Kafka**: new entry point options for `KafkaMessageListenerContainer`, including container-level tracing and error marking
* **Lettuce Pub/Sub**: transaction tracing for `RedisPubSubListener` implementations
* **HTTP clients (Apache HttpClient, JDK HTTP, Ning, Google, OkHttp)**: configurable `mark.error` option to control whether client-side errors mark a transaction as failed
### What's Changed
* \[#11607] Prepare 3.1.0-SNAPSHOT by @intr3p1d in
* \[#7497] ErrorAnalysis > Show groupedFieldName.uriTemplate by @jihea-park in
* \[#10776] Adding sortkey for kafka partition distribution by @minwoo-jung in
* \[#11433] Add Application agent list query options by @donghun-cho in
* \[#7374] Apply help popover to v3 by @jihea-park in
* \[#noissue] Update README by @intr3p1d in
* \[#noissue] Bump actions/setup-java\@v3 to actions/setup-java\@v4 by @intr3p1d in
* \[#noissue] Fix type error of HelpPopover by @jihea-park in
* \[#noissue] Fix type error of HelpPopover2 by @jihea-park in
* \[#11620] Bump springframework from 6.1.5 to 6.1.14 by @emeroad in
* \[#11622] Bump spring-boot from 3.2.4 to 3.3.5 by @emeroad in
* \[#noissue] Cleanup springframework dependency by @emeroad in
* \[#noissue] Update README.md by @emeroad in
* \[#noissue] Update README.md by @emeroad in
* \[#10776] add test code by @minwoo-jung in
* \[#10776] If metricGroup, metric, and field name are empty string, put the default value by @minwoo-jung in
* \[#10776] OpenTelemetry > Prepare beta open by @jihea-park in
* \[#noissue] Update plugins url by @intr3p1d in
* \[#11628] Bump spring-boot2 from 2.7.13 to 2.7.17 for plugin-test by @emeroad in
* \[#11626] Bump springframework5 from 5.3.28 to 5.3.39 for plugin-test by @emeroad in
* \[#noissue] Fix renderHelpContent error by @jihea-park in
* \[#11638] Bump spring-data from 3.2.2 to 3.3.3 by @emeroad in
* \[#noissue] Remove unnecessary zk cluster from web module by @emeroad in
* \[#7374] Apply help popover to v3 (NAVBAR, REAL\_TIME, CALL\_TREE) by @jihea-park in
* \[#NOISSUE] Disable KafkaAutoConfiguration. Because it is not used. by @minwoo-jung in
* \[#11643] Bump spring-batch from 5.1.1 to 5.1.2 by @emeroad in
* \[#11611] Update mysql-jdbc-plugin support to mysql-connector-j 9.x by @jaehong-kim in
* \[#noissue] Add docs on sql related configs by @kojandy in
* \[#11647] Update httpclient5-plugin support to httpclient5 5.4 by @jaehong-kim in
* \[#11640] Introduce redis-timeseries module by @emeroad in
* \[#11653] Bump kafka-client from 3.3.2 to 3.7.1 by @emeroad in
* \[#10776] Improve logic for parsing names of metricGroup, metric, and field. by @minwoo-jung in
* \[#noissue] Cleanup kafka dependency by @emeroad in
* \[#11433] Change servermap agent list condition by @donghun-cho in
* \[#11659] Replaced log4 1.x with reload4j by @emeroad in
* \[#11659] Remove log4j 1.x dependency by @emeroad in
* \[#10776] Add index to tables and schema of otlpmetric. by @minwoo-jung in
* \[#11663] Update mark.error option of httpclient plugins by @jaehong-kim in
* \[#noissue] Fix support version range of vertx-plugin by @jaehong-kim in
* \[#10776] Change id to name in the otlp logic. by @minwoo-jung in
* \[#11670] Bump spring-cloud from 4.1.2 to 4.1.4 by @emeroad in
* \[#11672] Bump spring-cloud from 3.1.8 to 3.1.9 by @emeroad in
* \[#noissue] Improve compatibility with thrift 0.21 by @emeroad in
* \[#11674] Bump guava from 32.1.2-jre to 33.3.1-jre by @emeroad in
* \[#11677] Bump gson from Gson 2.10.1 to Gson 2.11.0 by @emeroad in
* \[#11679] Bump grpc from 1.64.1 to 1.68.1 by @emeroad in
* \[#noissue] export ui/table by @jihea-park in
* \[#NOISSUE] reserved ports for use by OpenTelemetry data collection. by @minwoo-jung in
* \[#11681] add dameng-jdbc plugin by @yjqg6666 in
* \[#noissue] Add network metrics by @intr3p1d in
* \[#11681] plugin, dameng-jdbc, update urlparser. Add UI V3 servermap image. by @yjqg6666 in
* \[#7374] Change style of popover by @jihea-park in
* \[#noissue] Bump jna from 5.14.0 to 5.15.0 by @intr3p1d in
* \[#6807] Config > Admin > Users by @jihea-park in
* \[#7370] Chang UserForm, UsersTableFetcher by @jihea-park in
* \[#noissue] Add allOfAsync to FutureUtils by @emeroad in
* \[#11703] Bump mockito-junit-jupiter from 4.8.1 to 4.11.0 by @emeroad in
* \[#11705] Bump junit-jupiter 5.10.2 from to 5.11.3 by @emeroad in
* \[#noissue] Remove unnecessary pinpoint-pugins-test-utils by @emeroad in
* If it is today's date, it shows the seconds. by @jihea-park in
* \[#noissue] Generalize CachingSqlNormalizer by @kojandy in
* \[#noissue] Optimize hashing by reusing hasher instance by @kojandy in
* \[#10776] Returns whether the OtlpMetric menu is visible. by @minwoo-jung in
* \[#7680] Check isWithinFiveMinutes by @jihea-park in
* \[#6839] Always show seconds in ReChart & Apply configuration.showExce… by @jihea-park in
* \[#11503] Delegate cache creation to SimpleCacheFactory by @kojandy in
* \[#11705] Improve compatibility of Junit with It tests by @emeroad in
* \[#noissue] Fix agent management list by @donghun-cho in
* \[#7693] OpenTelemetry > Change url from /openTelemetry to /openTeleme… by @jihea-park in
* \[#noissue] fix: datepicker's maxrange validation by @BillionaireDY in
* \[#noissue] Remove deprecated PLogger API by @emeroad in
* \[#noissue] Fix deprecated API by @emeroad in
* \[#11726] Bump maven-surefire-plugin from 3.1.2 to 3.5.2 by @emeroad in
* \[#noissue] Cleanup protobuf-maven-plugin by @emeroad in
* \[#7674] Update billboard.js to 3.14.0 by @jihea-park in
* \[#noissue] Fix deprecated API by @emeroad in
* \[#10776] Use the SamplingInterval value as the minimum time slotwhen searching data. by @minwoo-jung in
* \[#noissue] Fix visibility of node histogram during concurrent execution by @emeroad in
* \[#noissue] Remove Thrift serializer by @emeroad in
* \[#noissue] Use general character to mark replaced tokens by @intr3p1d in
* \[#11729] RFC 7239 Forwarded Header based RealIpHeaderResolver by @beyond-seunghyun in
* \[#7371] Config > Admin > Agent Management by @jihea-park in
* \[#noissue] Cleanup ThreadDump serializer by @emeroad in
* \[#noissue] Fix it test failure by @emeroad in
* \[#11729] Update agent's realipheader value to the list type. by @jaehong-kim in
* \[#noissue] Cleanup kafka test by @emeroad in
* \[#11705] Refactor PluginTestEngine by @emeroad in
* \[#11745] Replace groovy-maven-plugin with templating-maven-plugin by @emeroad in
* \[#11745] Cleanup by @emeroad in
* \[#noissue] Remove deprecated Charsets.java by @emeroad in
* \[#noissue] Move commons.task package to commons-server module by @emeroad in
* \[#noissue] Fix `testRecordNotChainedException` test failure by @intr3p1d in
* \[#11745] Apply templating-maven-plugin to TestcontainersOption version by @emeroad in
* \[#11745] Apply log4j2 templating to plugin-test module by @emeroad in
* \[#noissue] Refactor DefaultExceptionRecorderTest by @intr3p1d in
* \[#noissue] Add newDriver to JDBCDriverClass by @emeroad in
* \[#11758] Separate banner into module by @emeroad in
* \[#noissue] Delete testcase directory by @emeroad in
* \[#noissue] Memory Optimization for ChainedTaskDecorator by @emeroad in
* \[#noissue] Apply junit AutoClose by @emeroad in
* \[#11763] Bump maven-compiler-plugin from 3.11.0 to 3.13.0 by @emeroad in
* \[#noissue] Bump slash-command-dispatch from v2 to v4 by @emeroad in
* \[#noissue] Replace ChainedTaskDecorator with CompositeTaskDecorator by @emeroad in
* \[#11768] Migrate TimerTaskDecorator to TaskDecorator by @emeroad in
* \[#11745] Apply Version templating to plugin-test module by @emeroad in
* \[#noissue] Reduce commons dependency of test-plugin by @emeroad in
* \[#11768] Cleanup by @emeroad in
* \[#noissue] Extract JavaHomeResolver by @emeroad in
* \[#7716] Config > Admin > Agent Statistic by @jihea-park in
* \[#noissue] Cleanup plugins-test by @emeroad in
* \[#7722] OpenTelemetryMetric > Change title & icon by @jihea-park in
* \[#7722] OpenTelemetryMetric > Change title & icon by @jihea-park in
* \[#11640] Async timeseries command support by @emeroad in
* \[#7728] Check permission to create alarm by @jihea-park in
* \[#7733] Fix application favorite list by @jihea-park in
* \[#7688] Toast clear all by @jihea-park in
* \[#noissue] Add ExceptionRecordingStateTest by @intr3p1d in
* \[#noissue] Cleanup IdValidateUtils by @emeroad in
* \[#noissue] Add permission to slashCommandDispatch by @intr3p1d in
* \[#noissue] Cleanup AgentIdResolver by @emeroad in
* \[#noissue] Apply MoreExecutors by @emeroad in
* \[#11792] Refactor ModuleBootLoader by @emeroad in
* \[#7758] Does not call metric data api if the metric is not inView by @jihea-park in
* \[#noissue] Cleanup PinpointStarter by @emeroad in
* \[#noissue] Revert #11791 by @jihea-park in
* \[#noissue] Replace SimpleProperty with Properties by @emeroad in
* \[#noissue] Remove TransportModule by @emeroad in
* \[#noissue] Cleanup AgentProperties by @emeroad in
* \[#noissue] Remove pinpoint-bootstrap dependency from pinpoint-profile… by @emeroad in
* \[#7737] Make the drag area of the scatter chart loose by @jihea-park in
* \[#noissue] Cleanup Bootstrap by @emeroad in
* \[#7758] Apply lazy loading to OpenTelemetryMetricFetcher by @jihea-park in
* \[#noissue] Admin > Agent Management > Change delete application/agent method from DELETE to GET by @jihea-park in
* \[#11805] Fix reactor-plugin empty mono and flux by @jaehong-kim in
* \[#noissue] Cleanup Path by @emeroad in
* \[#noissue] Implement EvenRangeSplitter by @kojandy in
* \[#7774] FlameGraph > zoom in/out by @jihea-park in
* \[#noissue] Cleanup plugins-test by @emeroad in
* \[#11813] Add trim to StringUtils by @emeroad in
* \[#11816] Remove noLookups warning log from Log4j2 by @emeroad in
* \[#11818] Bump log4j2 from 2.22.0 to 2.24.2 by @emeroad in
* \[#11818] Add log4j module permission by @emeroad in
* \[#NOISSUE] Change the package name for consistency. by @minwoo-jung in
* \[#noissue] Update http request header size format by @intr3p1d in
* \[#11822] Replace commons-logging with spring-jcl by @emeroad in
* \[#noissue] Remove CommonLogger Adapter by @emeroad in
* \[#noissue] Remove CommonLogger by @emeroad in
* \[#noissue] Cleanup ValueResolver by @emeroad in
* \[#11828] Remove duplicate JdbcConfig code by @emeroad in
* \[#noissue] Replace deprecated API by @emeroad in
* \[#noissue] Replace File with Path by @emeroad in
* \[#11854] Fix possible NPE in ConnectionCountServerTransportFilter by @kojandy in
* \[#11828] Fix Cassandra test failures by @emeroad in
* \[#11834] Extract JdbcOption from ProfilerConfig by @emeroad in
* \[#noissue] Add suffix for hbase DistributionSummary metrics by @intr3p1d in
* \[#11828] Fix incorrect name for JdbcAutoCommitConfig by @emeroad in
* \[#11842] Support for property placeholders in ProfilerConfig.readXXX by @emeroad in
* \[#7785] Admin > Agent Management > Show agentVersion instead of vmVer… by @jihea-park in
* \[#11828] Fix Cassandra test failures by @emeroad in
* \[#11828] Cleanup by @emeroad in
* \[#noissue] Fix CXF client test failures by @emeroad in
* \[#11828] Fix testcase failures on Windows Env by @emeroad in
* \[#11852] Support for MAVEN\_REPOSITORY in plugin integration tests by @emeroad in
* \[#noissue] Cleanup ClickHouseIT by @emeroad in
* \[#11858] Bump httpcomponents5 to 5.2.3 by @emeroad in
* \[#noissue] Cleanup JDBC by @emeroad in
* \[#noissue] Fix JDBC test failures by @emeroad in
* \[#noissue] Fix JDBC test failures by @emeroad in
* \[#noissue] Cleanup JDBC test by @emeroad in
* \[#11867] Bump slf4j from 2.0.9 to 2.0.16 by @emeroad in
* \[#11869] Bump kotlin-maven-plugin from 1.7.22 to 1.8.22 by @emeroad in
* \[#noissue] Cleanup DisableOptions by @emeroad in
* \[#noissue] Cleanup Agent boot log by @emeroad in
* \[#noissue] Apply @AutoClose by @emeroad in
* \[#noissue] Apply @AutoClose by @emeroad in
* \[#noissue] Apply @AutoClose by @emeroad in
* \[#noissue] Cleanup PluginTest by @emeroad in
* \[#noissue] Remove deprecated logic and simplify query for clarity by @intr3p1d in
* \[#noissue] Remove unnecessary Thrift SpanFactory by @emeroad in
* \[#noissue] Use MapStruct to map query entities to models by @intr3p1d in
* \[#noissue] Cleanup PluginTest by @emeroad in
* Fix compilation - execution still fails by @DaGeRe in
* \[#noissue] Fix missing LauncherSession.close by @emeroad in
* \[#noissue] Remove pinpoint-commons dependency of bootstrap module by @emeroad in
* \[#noissue] Fix quickstart test app by @donghun-cho in
* \[#11892] Bump springframework from 6.1.14 to 6.1.16 by @emeroad in
* \[#11894] Bump springboot from 3.3.5 to 3.3.7 by @emeroad in
* \[#11896] Bump springdata from 3.3.5 to 3.3.7 by @emeroad in
* \[#noissue] Remove unused javax.servlet property by @emeroad in
* \[#noissue] Remove pinpoint-commons dependency of bootstrap module by @emeroad in
* Change package structure by @jihea-park in
* \[#11877] Improved Agent initialization by @emeroad in
* \[#11903] Bump spring-security from 6.1.8 to 6.4.2 by @emeroad in
* \[#11905] Disable the batch for checking Flink server operation. by @minwoo-jung in
* \[#11906] Switch log4j2 configuration format from XML to YAML by @intr3p1d in
* \[#11908] Improve JVM compatibility of the bootstrap classloader by @emeroad in
* \[#11912] Fix missing close on Jar InputStream in Plugin by @emeroad in
* \[#11906] Use jackson instead of snakeyaml by @intr3p1d in
* \[#7795] Modify UserGroupMember for API key by @jihea-park in
* \[#noissue] FlameGraph > fix bug & add zoom in/out button' by @jihea-park in
* \[#noissue] Allow blank agentId for global txId search by @kojandy in
* \[#11905] Delete the logic associated with flink. by @minwoo-jung in
* \[#11924] Update kafka plugin for compatibility with kafka 3.x version by @jaehong-kim in
* Fix link to feature guide by @DaGeRe in
* \[#11921] FlameGraph > Set colors for each application name by @jihea-park in
* \[#11905] Delete the logic associated with flink. by @minwoo-jung in
* \[#noissue] Remove deprecated TCP configuration by @emeroad in
* \[#noissue] V2 inspector notice message by @jihea-park in
* \[#11933] Bump zookeeper from 3.8.1 to 3.8.4 by @emeroad in
* \[#11905] Deprecated the application stat api. by @minwoo-jung in
* \[#11905] Remove deprecated module by @emeroad in
* \[#noissue] Fix missing RegionLocator.close by @emeroad in
* \[#noissue] Improved error logs in PluginTest by @emeroad in
* \[#11940] Add DBCP integration tests by @emeroad in
* \[#11942] Bump micrometer from 1.13.2 to 1.13.9 by @emeroad in
* \[#11942] Remove micrometer-jakarta9 dependency by @emeroad in
* \[#noissue] Remove netty3 dependency by @emeroad in
* \[#11905] Add thrift dependency for pinot driver by @emeroad in
* \[#11949] Bump mysql driver from 8.0.28 to 8.4.0 by @emeroad in
* \[#noissue] Add applicationName as parmeters to getAgentStatusTimeline api by @jihea-park in
* \[#11953] Update io.asyncer:r2dbc-mysql of spring r2dbc plugin by @jaehong-kim in
* \[#11955] Bump lettuce from 6.5.0 to 6.5.2 by @emeroad in
* \[#noissue] Remove unused javax.annotation dependency by @emeroad in
* \[#11963] Improve the logic for retrieving deadlock stat data to fetch it from Pinot instead of HBase. by @minwoo-jung in
* \[#11959] Bump opentelemetry to 1.46.0 by @emeroad in
* \[#11944] Include chart in `/uriStat/summary` response by @intr3p1d in
* \[#11963] Adds an empty object when the inspector module is disable. by @minwoo-jung in
* \[#11905] Fixing invalid message handlers by @emeroad in
* \[#11971] Extract micrometer module by @emeroad in
* \[#noissue] Remove deprecated @Mappings annotations by @intr3p1d in
* \[#noissue] Refactor DataSender by @emeroad in
* \[#11963] Add test code by @minwoo-jung in
* \[#11980] Add async nested of reactor plugin by @jaehong-kim in
* \[#11962] Equalizer Bar Chart to replace real time chart by @jihea-park in
* \[#noissue] Refactor TransactionId by @emeroad in
* \[#noissue] Add missing dependency by @kojandy in
* \[#noissue] FlameGraph > Application name info by @jihea-park in
* \[#11982] URL stat > mini chart by @jihea-park in
* \[#11967] Skip leading space when binding values by @kojandy in
* \[#noissue] Handle opentelemetry getMetricData api error by @jihea-park in
* \[#11990] Suppress MultiStageEngine query ClassCastException in logs by @intr3p1d in
* \[#11982] Math.round to long maxValue by @jihea-park in
* \[#11997] Delete logic that stores stat data in hbase. by @minwoo-jung in
* \[#11944] Fix incorrect logic for chart calculations by @intr3p1d in
* \[##11962] Handle not OK data & ThreadDump open button by @jihea-park in
* \[#11997] Add test code by @minwoo-jung in
* \[#11818] Improve log4j context initialization by @emeroad in
* \[#noissue] Add AgentOption to console logging by @emeroad in
* \[#noissue]Highlight Error by @jihea-park in
* \[#11512] Bump pinot jdbc client to 1.2.0 by @donghun-cho in
* \[#noissue] Update node version to 22.13.1 by @jihea-park in
* \[#12019] Add logic to prevent error when metadata is missing. by @minwoo-jung in
* \[#12021] Hide sensitive information such as cookie data by @intr3p1d in
* \[#noissue] Remove Header for thrift by @emeroad in