JVM 跑进 Kubernetes 前：对齐容器内存与 SkyWalking 采样边界
Exit Code 137 先查容器总内存
Pod 显示Reason: OOMKilled时，只看 Java 堆还不够。Metaspace、Direct Memory、线程栈、JIT、共享库和 SkyWalking 队列都计入容器内存，应与 Cgroup Limit 一起核对。
# 查看 Kubernetes 节点与 Pod 资源消耗 kubectl top pods -n prod-ai-cluster # 查看该 Pod 具体的终止原因描述 kubectl describe pod ai-analysis-service-7f89d9-x92zk -n prod-ai-cluster | grep -A 5 "Last State" # 查看节点内核 dmesg 杀进程记录 kubectl exec -it ai-analysis-service-7f89d9-x92zk -n prod-ai-cluster -- dmesg -T | grep -i oomkubectl describe可以确认上一次终止原因，记录时保留当前 Pod 的真实时间与名称：
Last State: Terminated Reason: OOMKilled Exit Code: 137 Started: <started_at> Finished: <finished_at>诊断时读取容器 Limit、JVM 启动参数、Native Memory Tracking 与探针队列。堆、Metaspace、Direct Memory、线程栈和 Agent 占用相加后如果接近 Limit，就需要重新分配预算；下面的配置值只是启动模板，不是通用容量结论。
拆解容器 Cgroup 内存与 Agent 探针开销
在 Kubernetes 中，JVM 堆、堆外、线程栈、共享库与 Agent 都受 Container Memory Limit 约束，应放进同一份内存预算。
排查时先核对三点：
- JVM 版本与容器感知：不同 JDK 更新和 Cgroup 版本的支持不同，应从启动日志与
-XshowSettings:system核对实际识别值，不只按一个版本分界推断； - 忽视 Agent 探针开销：采样策略和队列会消耗内存与 CPU，实际值受 Agent 版本、插件、吞吐和 Segment 大小影响，应独立测量；
- 堆外预算缺失：核对 Direct Memory、Metaspace、线程栈、映射文件和 Agent；是否设置
MaxDirectMemorySize取决于所用框架及其内存管理方式。
K8s Dockerfile 示例 与 SkyWalking 动态采样配置
部署前应一起审查 Dockerfile 启动参数、容器资源和 SkyWalking 策略，并通过内存压力与取消场景验证；配置只能缩小风险，不能承诺绝不 OOM。
1. JVM 容器感知 Dockerfile 示例
使用MaxRAMPercentage替代固定的-Xmx硬编码，根据 Cgroup 容器配额按比例自适应分配堆内存：
FROM eclipse-temurin:17-jre-alpine LABEL maintainer="architecture-team" # 创建应用工作目录 WORKDIR /app # 挂载 SkyWalking Agent ADD skywalking-agent/ /app/agent/ COPY target/ai-analysis-service.jar /app/app.jar # JAVA_OPTS 由部署清单注入。堆、Metaspace、Direct Memory 和 GC 参数来自容量测试， # 不在镜像里固化一套比例和大小。 ENV JAVA_OPTS="" # 暴露端口与入口 EXPOSE 8080 8443 ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -javaagent:/app/agent/skywalking-agent.jar -jar /app/app.jar"]2. SkyWalking Agent 生产高吞吐与采样率调优配置 (agent.config)
编辑agent/config/agent.config文件，防止 SkyWalking 探针把微服务拉垮：
# 1. 服务名称与 Kubernetes Namespace 联动 agent.service_name=${SW_AGENT_NAME} agent.namespace=${SW_AGENT_NAMESPACE} # 2. Collector 后端 gRPC 地址 collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES} # 3. 采样上限由排障覆盖率、入口吞吐和探针开销测试确定 agent.sample_n_per_3_secs=${SW_AGENT_SAMPLE_N_PER_3_SECS} # 4. 链路队列与内存限制：设置单个 Segment 队列大小，溢出时丢弃 Trace 而绝不拖垮宿主应用 buffer.channel_size=${SW_AGENT_BUFFER_CHANNEL_SIZE} buffer.buffer_size=${SW_AGENT_BUFFER_SIZE} # 5. 忽略非核心的健康检查与静态资源 Path 采样 agent.ignore_suffix=${SW_AGENT_IGNORE_SUFFIX} trace.ignore_path=${SW_TRACE_IGNORE_PATH}3. Kubernetes Deployment Helm/YAML 资源安全对齐
apiVersion: apps/v1 kind: Deployment metadata: name: ai-analysis-service namespace: prod spec: replicas: {{ .Values.replicaCount }} template: spec: containers: - name: ai-analysis-service image: {{ .Values.image.repository }}:{{ .Values.image.tag }} resources: requests: cpu: {{ .Values.resources.requests.cpu | quote }} memory: {{ .Values.resources.requests.memory | quote }} limits: cpu: {{ .Values.resources.limits.cpu | quote }} memory: {{ .Values.resources.limits.memory | quote }} env: - name: SW_AGENT_NAME value: "ai-analysis-service" # 挂载日志与 Dump 目录到 Ephemeral Storage，防止撑爆容器 Root 镜像层 volumeMounts: - name: log-volume mountPath: /app/logs volumes: - name: log-volume emptyDir: sizeLimit: {{ .Values.dumpVolume.sizeLimit }}在隔离环境验证内存边界
使用固定请求集逐级加压，采集 RSS、堆、堆外、探针队列、GC CPU 与重启原因。持续时间按业务周期设置：
| 指标 | 采集来源 | 要回答的问题 |
|---|---|---|
| OOMKilled 与终止原因 | Pod 状态、memory.events | 是否越过容器内存边界 |
| RSS、堆与 Native Memory | Cgroup、JMX、NMT | 哪部分占用随负载或采样增长 |
| SkyWalking Agent CPU、内存与丢弃 | 探针指标、进程对照 | 采样和队列配置的开销及数据损失 |
| 健康检查失败 | Kubelet 事件、应用日志 | 是探针超时、GC 还是业务依赖失败 |
JVM 容器部署的三项检查
- 不要只看
-Xmx：使用固定堆或MaxRAMPercentage都要给 Metaspace、Direct Memory、线程栈和 Agent 留出由实测确定的余量。 - 配置 Ignore Path 与采样策略：健康检查等低价值路径可排除；
agent.sample_n_per_3_secs的值按排障需求、吞吐和探针开销测试确定。 - 规划 HeapDump 存储：HeapDump 可能较大，应选择有容量和保留策略的可写卷。
emptyDir与 PVC 的取舍取决于节点空间、持久化要求和隐私治理，不能只靠默认路径。
