OpenParable
Skip to content
← Back to skills

Arthas

Testing & Quality
arthas

Arthas is an Agent Skill for testing & quality published in the alibaba/arthas repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

arthas 诊断 java应用,jvm问题 skill

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/alibaba/arthas/blob/HEAD/skills/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/arthas, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Arthas 诊断 Skill

Overview

Arthas 是 Java 应用在线诊断工具,本 Skill 包含多个子场景的诊断指南。使用时请根据用户描述的问题匹配对应场景,按指南中的步骤逐步排查。

通用原则:

  • 先用低风险、只读的命令收集信息,再按需使用有侵入性的命令。
  • 所有 watch / trace / tt / stack 等命令必须设置 -n(执行次数限制),避免对线上应用造成压力。
  • 输出结论时附上关键证据(命令输出摘要),并给出明确的下一步建议。

子场景索引

1. CPU 飙高排查

文件: cpu-high/SKILL.md

适用场景:机器 CPU 飙高、应用响应变慢、负载异常升高。

核心步骤:

  1. dashboard 查看 CPU / 线程 / GC 概况
  2. thread(topN)定位最忙线程及堆栈
  3. 根据堆栈判断方向(CPU 密集计算 / 锁竞争 / GC 等)
  4. 按需用 stack / trace / watch 进一步确认热点方法调用路径
  5. 输出诊断结论(现象、证据、初步结论、下一步建议)

2. 获取 EagleEye traceId

文件: eagleeye-traceid/SKILL.md

适用场景:需要在不改代码的情况下,获取线上请求的 EagleEye traceId,用于关联日志 / 链路分析。

核心步骤:

  1. sc -d com.taobao.eagleeye.EagleEye 确认类存在
  2. 选择合适的观察点(Controller / RPC Provider / Filter 等入口方法)
  3. 方案 A:watch + OGNL 表达式 @com.taobao.eagleeye.EagleEye@getTraceId() 直接打印 traceId
  4. 方案 B:trace 输出中自动带出 traceId,同时可看调用链耗时
  5. 拿到 traceId 后去日志 / 链路系统查询对应请求

3. Spring Context / Bean 排查

文件: spring-context/SKILL.md

适用场景:排查 Spring ApplicationContext / Bean / 配置注入等问题。

核心步骤:

  1. vmtool --action getInstances 获取 AbstractApplicationContext 实例(注意通过 ClassLoader 区分正确的 Context)
  2. 获取配置项的值与来源(getEnvironment().getProperty(...) / findConfigurationProperty(...))
  3. containsBean / containsLocalBean / containsBeanDefinition 验证 Bean 是否存在(不触发初始化)
  4. 按关键词过滤搜索 Bean(getBeanDefinitionNames + OGNL 过滤)
  5. 按类型查找 Bean(getBeanNamesForType / getBeansOfType)
  6. 查看 BeanDefinition 确认 Bean 注册来源(@Bean 工厂方法 / XML / 自动扫描)

注意: 先只读查询,避免直接 getBean() 触发 Bean 初始化产生副作用;若遇到 ClassNotFound,通常是类加载器不对,需先用 classloader 命令找到正确的 classLoaderHash。