A comprehensive full-link troubleshooting skill that integrates Alibaba Cloud SLS logs, ARMS call chains, source code analysis, and database diagnostics.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sls-trace-analysis
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sls-trace-analysis using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SLS Trace Analysis: Alibaba Cloud Logging & ARMS Debugger?
The sls-trace-analysis skill is a powerful diagnostic tool designed for developers using Openclaw Skills to resolve complex production issues. It bridges the gap between high-level cloud monitoring and low-level source code by correlating trace IDs across Alibaba Cloud Log Service (SLS) and Application Real-Time Monitoring Service (ARMS).
By automating the retrieval of call chains and method-level stacks, the skill allows AI agents to pinpoint the exact line of code causing an error. It goes beyond simple log aggregation by performing root cause analysis, scanning local code repositories for the relevant snippets, and identifying database-level anomalies such as deadlocks or slow queries.
SLS Trace Analysis: Alibaba Cloud Logging & ARMS Debugger Use Cases
- Analyzing production errors using a specific trace_id or request ID.
- Troubleshooting slow API responses by examining ARMS call chain durations.
- Investigating user-specific issues using wusid (User Space ID) or account identifiers.
- Identifying the root cause of database failures like duplicate keys or connection timeouts.
- Correlating cloud logs with local source code to provide immediate fix suggestions.
How SLS Trace Analysis: Alibaba Cloud Logging & ARMS Debugger Works
- The user provides a trace_id, user ID (wusid), or request path as a starting point.
- The skill executes a Python script to query Alibaba Cloud SLS and ARMS within a specified time range.
- It retrieves the call chain tree, error spans, and method-level stack details.
- If errors are found, it automatically uses Grep and Read tools to locate and analyze the corresponding local source code.
- It cross-references error messages with database patterns to identify SQL-related bottlenecks.
- A final comprehensive report is generated, including root cause conclusions and prioritized repair directions.
SLS Trace Analysis: Alibaba Cloud Logging & ARMS Debugger Setup
To use this skill within Openclaw Skills, ensure you have the Alibaba Cloud SDKs installed and credentials configured.
pip install aliyun-log-python-sdk alibabacloud-arms20190808
Set the following environment variables:
export ALIBABA_CLOUD_ACCESS_KEY_ID="your_access_key"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your_secret_key"
SLS Trace Analysis: Alibaba Cloud Logging & ARMS Debugger Data Schema & Taxonomy
The skill processes telemetry data and organizes it into a structured format for the agent to interpret:
| Field | Description |
|---|---|
| query | Contains the trace_id, wusid, and path used for the search. |
| call_chain | A hierarchical tree of service interactions and their durations. |
| stack_details | Method-level execution stacks including class names and line numbers. |
| sls | Grouped logs from various LogStores with status codes and messages. |
| analysis | AI-generated root cause findings and repair suggestions. |
SLS Trace Analysis: Alibaba Cloud Logging & ARMS Debugger Advanced Features
- Natural language time range parsing (e.g., "last 2 hours", "yesterday afternoon").
- Multi-mode searching: Supports both direct TraceID analysis and discovery mode via User ID or API Path.
- Automatic local repository scanning to correlate cloud errors with actual local source code.
- Grouped LogStore visualization to maintain context across microservices.
- Interactive troubleshooting loops that intelligently prompt for missing parameters or expanded time ranges.
SKILL.md
Loading
Related Openclaw Skills
cuihua-dependency-updater
An AI-powered dependency assistant that intelligently manages npm and yarn package updates with automated safety checks and breaking change detection.
OpenClaw Memory Kit
A comprehensive developer toolkit for scaffolding, sanitizing, and distributing reusable multi-agent memory architectures.
PC Operation Security (PC-OCS)
An impact-based security classification tool designed to assess risks, assign safety levels, and provide audit guidelines for personal computer operations.
Kimi Code API Integration
A specialized integration guide and configuration skill to run Kimi K2.5 as a drop-in replacement for Anthropic models in OpenClaw and Claude Code.
Dep Graph
A lightweight multi-language utility to parse, visualize, and audit project dependency trees directly from manifest files.
Textlocal
A professional messaging integration for AI agents to programmatically send SMS, RCS, and WhatsApp messages via Textlocal.
Featured*
