metrics

Query Metrics monitoring data for service throughput, latency, error rate, and dependencies.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill metrics-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metrics
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/metrics
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill metrics-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Diagnosing service performance issues requires navigating complex monitoring systems and knowing exact metric names, regions, and tag schemas. This Skill provides a structured interface to query Metrics (BytePlot / BytedTrace) monitoring data by PSM or metric name, so you can inspect QPS, latency, error rates, and dependency traffic without manually building queries. ## Core Features & Use Cases - Preset Service Queries: Run overview, downstream, or upstream query types against a PSM to get labeled sections summarizing QPS, latency, and error rate for a service and its dependencies. - Custom Metric Queries: Query any exact metric name directly with optional filters, grouping, aggregation, downsampling, and top-k selection. - Tag Discovery: Use the suggest_tagk action to discover available filterable and groupable tag keys before building filtered queries. - Use Case: When a service's error rate spikes, ask for a downstream dependency check on the PSM in a specific region to identify which downstream call is failing, then drill into the failing metric grouped by error type. ## Quick Start Ask the agent to show the QPS, latency, and error rate overview for your service PSM in a specific region such as Singapore-Central.

Frequently Asked Questions about metrics

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

FAQPage Schema
How do I check a service's QPS, latency, and error rate?

Use the smart query mode with query_type set to overview, plus the service PSM and vregion. The result returns labeled sections summarizing QPS, latency, and error-related series for that service over the last 60 minutes by default.

How do I query a specific metric by name?

Pass the exact metric name in the metric parameter, optionally with psm, vregion, filters, aggregator, downsample, or top_k. Do not reinterpret the metric name as a PSM; custom and business metrics are queried directly even if they do not follow BytedTrace naming conventions.

How do I find available tag keys for a metric before filtering?

Use the suggest_tagk action with the metric_name parameter to list the metric's filterable and groupable tag keys. This helps you build valid filters instead of guessing tag names like error_type or _method.

What happens if I don't specify a region for a metrics query?

If the result depends on the deployment region and vregion is missing, the skill asks you to provide one rather than guessing. It does not probe multiple regions as a fallback, so specify regions like Singapore-Central or US-East explicitly.

Why does my metrics query return zero series?

A series_count of 0 can mean there is no traffic, no errors, or the wrong region or filter was used. Verify the vregion and filter values instead of silently retrying other regions.

Can this skill modify monitoring configuration or write data?

No, this skill is read-only. It only queries existing Metrics, BytePlot, and BytedTrace data and cannot create alerts, dashboards, or modify any monitoring configuration.