tencentcloud-cls

Search and analyze Tencent Cloud CLS log topics with CQL or Lucene queries.

13|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AceDataCloud/Skills --skill tencentcloud-cls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tencentcloud-cls
Source: https://github.com/AceDataCloud/Skills/tree/main/skills/tencentcloud-cls
Command: npx skills add https://github.com/AceDataCloud/Skills --skill tencentcloud-cls

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tencentcloud-sdk-python, and includes scripts (resource) components.

What problem does it solve?

When you need to find the root cause of errors, trace a failing request, or understand what happened in a Tencent Cloud service, searching and analyzing raw log streams is slow and hard to repeat.

Core Features & Use Cases

  • Targeted log discovery with CQL/Lucene: Search Tencent Cloud CLS log topics using time ranges plus structured filters, including trace_id lookups.
  • Run analytics on log data: Perform aggregation using CLS SQL-on-logs by appending a SELECT/GROUP BY clause to your CQL query.
  • Fields extraction for structured debugging: Decode indexed LogJson per record to surface key attributes like status_code, api_name, or custom fields.
  • Typical scenarios: Locate recent 5xx errors, trace a request lifecycle by trace ID across topics, and summarize which APIs produce the most failures.

Quick Start

Ask the AI to search your CLS topic for recent errors by running an indexed CQL query over the last hour and returning matching records with extracted fields.

Frequently Asked Questions about tencentcloud-cls

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

FAQPage Schema
How do I trace a request by trace ID in Tencent Cloud CLS?

Trace a request by trace ID in Tencent Cloud CLS by running a targeted CQL or Lucene query with ms-epoch From/To time bounds across indexed log topics. This isolates the specific request lifecycle and surfaces matching records with extracted fields like status_code or api_name.

How do I run SQL aggregations on Tencent Cloud logs?

Run SQL aggregations on Tencent Cloud logs by appending a SELECT/GROUP BY clause to your CQL query using the pipe selector. This enables SQL-on-logs analytics to summarize indexed fields and quantify patterns across specified time windows.

Can I search Tencent Cloud CLS logs using Lucene syntax?

Yes, you can search Tencent Cloud CLS logs using Lucene syntax alongside CQL. The Skill supports both query formats for targeted log discovery, allowing you to apply structured filters and ms-epoch time bounds to locate specific records within indexed log topics.

Do I need the Tencent Cloud Python SDK to analyze CLS log topics?

Yes, you need the tencentcloud-sdk-python package installed to analyze CLS log topics. This dependency is required for the Skill to authenticate, query log topics, decode indexed LogJson records, and extract structured fields for debugging.

What is the best way to find recent 5xx errors in Tencent Cloud logs?

The best way to find recent 5xx errors in Tencent Cloud logs is to execute an indexed CQL query over the last hour using ms-epoch time bounds. This filters log topics for specific status codes and returns matching records with decoded attributes for fast incident debugging.

What are the limitations of CQL for debugging Tencent Cloud log failures?

CQL for debugging Tencent Cloud log failures requires indexed fields for structured filtering and precise ms-epoch From/To time bounds. Without properly indexed LogJson fields like status_code or api_name, targeted log discovery and SQL-on-logs aggregation cannot be performed effectively.