采样类型从单一COUNTING扩展为两种模式

采样类型从单一COUNTING扩展为两种模式

【免费下载链接】pinpoint 项目地址: https://gitcode.com/gh_mirrors/pin/pinpoint

profiler.sampling.type=COUNTING # 计数采样（1/n） profiler.sampling.type=PERCENT # 百分比采样（n%）

对应采样率参数

profiler.sampling.counting.sampling-rate=20 profiler.sampling.percent.sampling-rate=5

### 性能优化参数
- **profiler.io.buffering.enable** - IO缓冲开关
- **profiler.interceptor.holder.enable** - 拦截器持有者性能优化

## 3.0版本最新参数体系

当前最新的3.0.1-SNAPSHOT版本中，Agent启动参数体系已经相当完善：

### 核心配置区域
**全局配置**：包括应用命名空间、JVM统计间隔等基础设置
**数据传输**：支持UDP和TCP两种传输类型
**采样控制**：提供更精细化的URL路径采样规则

### 配置文件架构演进
Pinpoint Agent现在支持多环境配置文件：
- **profiles/local/pinpoint.config** - 本地开发环境配置
- **profiles/release/pinpoint.config** - 生产环境配置
- **pinpoint-root.config** - 根配置文件，用于激活特定环境

[![Pinpoint Agent配置架构](https://raw.gitcode.com/gh_mirrors/pin/pinpoint/raw/1e3235d9e6b244f6e92ca0be562edbbb29370162/doc/images/ss_inspector.png?utm_source=gitcode_repo_files)](https://link.gitcode.com/i/9cc667d94d68eea8471cf8c2912f7f8c)

## 关键参数变更点详解

### 1. 采样率参数重构
**旧版本**：

profiler.sampling.rate=20

**新版本**：

支持两种采样类型

profiler.sampling.type=COUNTING profiler.sampling.counting.sampling-rate=20

或使用百分比采样

profiler.sampling.type=PERCENT
profiler.sampling.percent.sampling-rate=5

### 2. 传输协议参数优化
新增GRPC协议支持，同时保持对THRIFT的兼容：

profiler.transport.module=GRPC profiler.transport.grpc.collector.ip=127.0.0.1

### 3. 性能监控参数增强
- **profiler.jvm.stat.collect.interval** - JVM统计收集间隔
- **profiler.monitor.deadlock.enable** - 死锁监控开关

### 4. 应用服务器支持扩展
支持Tomcat、Jetty、JBoss、WebLogic等多种应用服务器的专用参数配置。

## 配置最佳实践与迁移建议

### 从旧版本迁移
对于从1.x或2.x版本升级到3.x的用户，需要注意以下关键变更：

1. **采样率参数**：从单一的`profiler.sampling.rate`拆分为类型明确的两种采样率参数
2. **配置文件管理**：从单一配置文件发展为多环境配置文件体系
3. **传输协议**：推荐使用GRPC协议以获得更好的性能

### 生产环境配置示例
```properties
# 激活生产环境配置
-Dpinpoint.profiler.profiles.active=release

# 自定义配置文件路径（可选）
-Dpinpoint.config=/etc/pinpoint/pinpoint.config

【免费下载链接】pinpoint 项目地址: https://gitcode.com/gh_mirrors/pin/pinpoint