Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
alibaba avatar

Arthas Eagleeye Traceid

  • 2 installs
  • 37.5k repo stars
  • Updated July 24, 2026
  • alibaba/arthas

arthas-eagleeye-traceid is a Claude skill that uses Arthas watch/trace to read a live request's EagleEye traceId without code changes.

About

arthas-eagleeye-traceid is a Claude skill for retrieving the EagleEye traceId of a live request using Arthas watch and trace, without changing code. A developer uses it to correlate a request with logs or a distributed-trace system. It uses OGNL to call EagleEye.getTraceId() at a chosen observation point and can also read the traceId from trace output alongside call-chain timings.

  • Retrieves the EagleEye traceId of a live request with Arthas watch/trace, no code changes
  • Uses OGNL to call @com.taobao.eagleeye.EagleEye@getTraceId() at a chosen observation point
  • trace output also surfaces trace_id plus call-chain timings for locating slow spots

Arthas Eagleeye Traceid by the numbers

  • 2 all-time installs (skills.sh)
  • Ranked #467 of 596 Debugging skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

arthas-eagleeye-traceid capabilities & compatibility

Free; open-source Arthas tooling, no API keys.

Capabilities
trace correlation · distributed tracing · jvm diagnostics
Use cases
debugging
Pricing
Free
From the docs

What arthas-eagleeye-traceid says it does

使用 Arthas 的 watch/trace 获取 EagleEye traceId / 获取请求的 traceId
SKILL.md
watch <类全名> <方法名> '@com.taobao.eagleeye.EagleEye@getTraceId()' -n 5
SKILL.md
npx skills add https://github.com/alibaba/arthas --skill arthas-eagleeye-traceid

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs2
repo stars37.5k
Last updatedJuly 24, 2026
Repositoryalibaba/arthas

What it does

Get the EagleEye traceId of a live request with Arthas watch/trace so it can be correlated with logs and distributed traces.

Who is it for?

Grabbing a request's EagleEye traceId in production for log and trace correlation

Skip if: Systems that do not use Alibaba EagleEye tracing

When should I use this skill?

You need the EagleEye traceId of an online request without modifying code

What you get

The request's EagleEye traceId is captured live and ready to query in logs or trace systems.

  • The captured request traceId plus observation point

Files

SKILL.mdMarkdownGitHub ↗

获取 EagleEye traceId(Arthas)

适用场景:你需要在不改代码的情况下,在线上请求链路里拿到当前线程的 EagleEye traceId,用于关联日志/链路分析/问题复现。

核心思路:

  • EagleEye 的 traceId 可在业务线程里通过 EagleEye.getTraceId() 获取。
  • Arthas 的 watch 支持 OGNL,可直接调用静态方法:@com.taobao.eagleeye.EagleEye@getTraceId()
  • Arthas 的 trace 输出中通常会自动包含 trace_id=...(如果环境集成了 EagleEye)。

前置检查(推荐)

1) 确认 EagleEye 类是否存在:

sc -d com.taobao.eagleeye.EagleEye

若找不到:

  • 可能未集成 EagleEye、或类被 relocate/shade(请让用户提供实际类名/依赖信息)。

2) 选择一个“确定会被请求线程调用”的方法作为观察点:

  • 常见:Controller 入口方法、RPC Provider 方法、Filter/Interceptor 的 doFilter/preHandle 等。
  • 避免:高频热点方法(容易刷屏、增加开销)。

方案 A:用 watch 直接打印 traceId(最直观)

A1) 只打印 traceId(最小输出)

watch <类全名> <方法名> '@com.taobao.eagleeye.EagleEye@getTraceId()' -n 5

说明:

  • @类名@静态方法() 是 OGNL 静态方法调用语法。
  • -n 5 限制执行次数,避免线上刷屏(务必保留/调整)。

A2) 同时打印参数 + traceId(更好做关联)

watch <类全名> <方法名> '{params, @com.taobao.eagleeye.EagleEye@getTraceId()}' -n 5 -x 2

说明:

  • {...} 会以数组/列表方式输出多个字段。
  • params 是 Arthas watch 内置变量之一;-x 2 控制对象展开深度(可按需调大/调小)。

常见变体(按需):

  • 在方法返回后再取(默认就是 after,可不写):
  • 如果你怀疑 traceId 在方法执行过程中才被设置,可尝试 -b(before)对比;具体以线上效果为准。

方案 B:用 trace 自动带出 traceId(更适合看调用链)

trace <类全名> <方法名> -n 5

期待现象:

  • trace 输出的头部信息里出现类似 trace_id=<xxxx> 的字段。
  • 同时你还能看到方法调用链与每段耗时,便于“拿 traceId + 看慢点在哪”一并完成。

结果解读与产出(建议模板)

最终给用户的结论/证据建议包含:

  • 观察点(类/方法):<类全名>#<方法名>
  • 获取方式:watch / trace
  • 关键证据:
  • traceId=<...>(以及必要时的 params 摘要)
  • 下一步建议:
  • 用该 traceId 去日志/链路系统查询对应请求
  • 或将观察点收敛到更下游的方法(如某个 DAO/RPC 调用)继续 trace/watch

扩展

  • 其他分布式追踪系统的 traceId、或 ThreadLocal 里的值,也可以用类似方式在 watch 的 OGNL 表达式中读取。

Related skills

FAQ

How does it print the traceId?

It uses Arthas watch with the OGNL static call @com.taobao.eagleeye.EagleEye@getTraceId() at an entry method, limited with -n.

What if EagleEye is not integrated?

sc -d com.taobao.eagleeye.EagleEye confirms the class exists; if not, the class may be missing or shaded and the user must provide the real class name.

Debuggingmonitoringinfra

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.