K8s ConfigMap配置的Pulsar Toolset Pod JVM参数未生效排查

1. 参数检查方式错误 #

你通过kubectl exec直接运行java -XX:+PrintFlagsFinal，是在Pod内启动了全新的Java进程，这个进程不会继承原toolset进程的JVM参数，因此看到的25.0是默认值，完全不反映正在运行的toolset实例配置。

2. JVM参数逻辑冲突 #

你设置的MinRAMPercentage=80.0大于MaxRAMPercentage=60.0，违反JVM参数规则：最小堆内存百分比不能超过最大堆内存百分比。JVM会直接忽略这种无效配置， fallback到默认值。

3. Toolset组件未读取PULSAR_MEM变量 #

Pulsar核心组件（如broker、bookie）会默认读取PULSAR_MEM环境变量配置JVM参数，但toolset这类辅助组件的启动脚本可能未引用该变量，导致你配置的参数根本没传给JVM进程。

步骤1：修正JVM参数逻辑 #

调整参数确保MinRAMPercentage ≤ MaxRAMPercentage，示例合理配置：

• XX:InitialRAMPercentage=50.0
• XX:MinRAMPercentage=50.0
• XX:MaxRAMPercentage=80.0

更新values.yaml后重新部署，确认ConfigMap同步新配置。

步骤2：正确检查运行中进程的JVM参数 #

不要启动新Java进程，直接查看Pod内已运行的toolset进程参数：

1. 获取Pod内Java进程ID：

kubectl exec -it event-platform-pulsar-0-sn-toolset-0 -n pulsar -- ps aux | grep java

2. 通过进程ID读取启动参数：

kubectl exec -it event-platform-pulsar-0-sn-toolset-0 -n pulsar -- cat /proc/<PID>/cmdline | tr '\0' ' '

输出内容会显示真正传给JVM的所有启动参数。

步骤3：确保Toolset启动脚本加载PULSAR_MEM #

如果上述命令显示未加载PULSAR_MEM中的参数，需检查启动脚本：

1. 查看toolset启动脚本内容：

kubectl exec -it event-platform-pulsar-0-sn-toolset-0 -n pulsar -- cat /pulsar/bin/pulsarctl

2. 确认脚本是否引用PULSAR_MEM，若未引用，在Java启动命令前添加：

JAVA_OPTS="${PULSAR_MEM} ${JAVA_OPTS}"

3. 或者直接在values.yaml中指定toolset的JVM参数（绕过PULSAR_MEM，具体配置键需参考你使用的Pulsar Helm Chart文档）：

toolset:
  jvm:
    memory: "-XX:InitialRAMPercentage=50.0 -XX:MinRAMPercentage=50.0 -XX:MaxRAMPercentage=80.0 -XX:MaxDirectMemorySize=128M"

步骤4：验证配置生效 #

重启Pod后，用步骤2的方法确认参数已加载，也可通过以下命令查看堆内存使用情况，对比Pod内存限制验证占比是否符合预期：

kubectl exec -it event-platform-pulsar-0-sn-toolset-0 -n pulsar -- jstat -gc <PID>

内容的提问来源于stack exchange，提问作者Hofbr