apm-trace-analysis

Analyze APM trace data to diagnose application issues and bottlenecks.

862|215|Updated Jun 17, 2021
One-click install
npx skills add https://github.com/TencentBlueKing/bk-job --skill apm-trace-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apm-trace-analysis
Source: https://github.com/TencentBlueKing/bk-job/tree/main/ai_agent/op/skills/apm-trace-analysis
Command: npx skills add https://github.com/TencentBlueKing/bk-job --skill apm-trace-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps pinpoint the root cause of application errors and performance bottlenecks by analyzing Application Performance Monitoring (APM) trace data.

Core Features & Use Cases

  • Trace Analysis: Query and analyze APM Span data using trace IDs or request IDs to reconstruct full call chains.
  • Error & Performance Bottleneck Identification: Locate error spans, identify unusually slow spans, and analyze service dependencies and error propagation paths.
  • Use Case: When a user reports a slow response time for a specific transaction, use this Skill to trace the request, identify which service or operation is causing the delay, and understand the underlying issue.

Quick Start

Analyze the APM trace for the given trace ID 'b0a9Ce0e-xxxx' within the specified time range.

Frequently Asked Questions about apm-trace-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of slow response times using distributed tracing?

Distributed tracing pinpoints slow response times by querying APM span data to reconstruct call chains and identify unusually slow spans. It analyzes inter-service communication patterns to isolate exactly which service or operation is causing the performance bottleneck.

How can I trace an application error using a trace ID?

You can trace an application error using a trace ID by querying the APM span data within a specified time range. This reconstructs the full call chain to locate error spans and analyze the error propagation path across dependent services.

What parameters are required to analyze APM trace data?

Analyzing APM trace data requires the specific parameters `app_name`, `bk_biz_id`, `start_time`, and `end_time`. You can also apply optional filters alongside these required parameters for more detailed investigation of service communication patterns.

Can I use APM trace analysis to diagnose inter-service communication issues?

APM trace analysis diagnoses inter-service communication issues by dissecting span data to map service dependencies. It identifies error spans and analyzes inter-service communication patterns to understand how errors propagate across your application architecture.

What is the best way to debug application performance bottlenecks in microservices?

The best way to debug microservice performance bottlenecks is analyzing APM span data to identify slow operations. By reconstructing full call chains from trace IDs, you can pinpoint the exact service causing the delay and understand the underlying issue.