用途：通过 Grafana 查询 LGTM 技术栈的遥测数据，包括 Tempo 追踪、Loki 日志关联与 Prometheus 指标，适合排查分布式系统的链路与日志问题。
使用方式：以 dev 依赖 @blogic-cz/agent-tools 安装后，运行 bun observability-tool。Grafana URL 来自 agent-tools.json5，令牌可选，存在时从配置的 tokenEnvVar 读取。
主要命令：trace get 与 trace logs 支持 32 位 trace ID 或 16 位 span ID；传入 span ID 时自动经 Tempo TraceQL 搜索解析到父追踪，搜索窗口自动从 1h 扩大到 24h，也可用 --start/--end 覆盖。trace find 是 trace get 的别名。metrics query 用于快速健康与指标查询，Tempo 数据源 UID 会从 Grafana 数据源自动发现。
trace get 与 trace logs 的输出始终包含 data.input 与 data.resolution，说明输入类型、解析方式、实际使用的 trace ID、匹配的 span、尝试与命中的时间窗口。若 span ID 匹配到多个追踪，返回 AMBIGUOUS_SPAN_ID 错误并给出 candidateTraceIds。
限制：输出默认使用 TOON 格式以节省 token，需要机器解析时加 --format json。配置需在 agent-tools.json5 中按环境提供 url、prometheusUid、lokiUid 等，令牌读取方式依配置而定。其余功能与默认参数资料未详述。