快速开始

当 java-profiler 已经部署好，并且你想分析一个 Java 服务时，走这条路径。

1. 启用 profiling

在目标 workload 的 pod template 上添加 metadata：

metadata:
  annotations:
    java-profiler.io/profile-mode: temporary
    java-profiler.io/profile-duration: 15m

线上事件优先用 temporary。只有经过批准需要长期采集的核心服务，才使用 continuous。

2. 打开服务

在 Web UI 中设置：

• Namespace：Kubernetes namespace。
• Service：服务或 workload 名称。
• Range：包含 profiling 运行时间的窗口。

如果 UI 没有数据，先看 Target status。它会说明 JVM 是 accepted、disabled、unsupported、expired，还是 attach failed。

3. 分析 profile

排查高 CPU 时，先打开 性能分析用户手册 对应的 CPU workflow。

使用：

• Top Table 找最贵的 Java 方法。
• Flame Graph 看完整 sampled stack context。
• Selected frame details 对比 Self CPU 和 Total CPU。
• Search 和 Focus 隔离真正重要的调用路径。

CPU 解释不了的延迟看 Wall Clock。Socket 或文件阻塞看 I/O wait。暂停时间或 allocation pressure 看 GC pauses 和 allocation correlation。锁竞争看 lock diagnosis。

4. 检查 ingestion health

在相信“没有 profile”之前，先检查 Ingestion health。有用的诊断需要看到当前服务和时间范围内的 accepted profile batches。

5. 关闭 profiling

临时 profiling 会自动过期。持续 profiling 不再需要时，移除或禁用 metadata。