apm-error-investigation
Installation
SKILL.md
APM Error Investigation
Take a backend/APM error signature and produce an evidence-backed root cause. Read queries.md for the NRQL
templates and the attribute-coverage reference before hand-writing any query.
Not for browser JavaScript errors (JavaScriptError / AjaxRequest), nor infra, mobile, synthetic or
Kubernetes errors unless the user narrows to an APM app.
Tools
| Step | Tool | Reference |
|---|---|---|
| 0/1 — resolve the entity | get_entity |
|
| 2 — time window | convert_time_period_to_epoch_ms |
|
| 3a — rank errors by impact | execute_nrql_query |
queries.md §1 |
| 3b — candidate traces for the chosen error | execute_nrql_query |
queries.md §2 |
| 3c — which candidates are inspectable | execute_nrql_query |
queries.md §2c |
| 4 — reconstruct the trace | get_distributed_trace_details |
|
| 5 — correlate logs | analyze_entity_logs |
queries.md §4 |