o11y-metrics-api

Query TiDB Cloud observability metrics via a Prometheus-compatible API.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/alex-quan-001/nutshell-skills --skill o11y-metrics-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: o11y-metrics-api
Source: https://github.com/alex-quan-001/nutshell-skills/tree/main/skills/platform/o11y-metrics-api
Command: npx skills add https://github.com/alex-quan-001/nutshell-skills --skill o11y-metrics-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This Skill eliminates the manual effort of building custom integrations to access TiDB Cloud cluster observability data, enabling direct querying of performance and infrastructure metrics via a standard Prometheus-compatible interface.

Core Features & Use Cases

  • Application Metrics Querying: Fetch TiDB and TiKV performance metrics including P99 coprocessor latency, request rates, and queue depth for cluster performance analysis.
  • K8s Infrastructure Metrics Discovery: Auto-discover the correct O11Y UUID for Kubernetes infrastructure metrics like HPA replica counts, CPU utilization, and EBS disk performance without manual configuration.
  • Token Caching: Automatically manage Auth0 authentication tokens with 24-hour validity to avoid repeated login calls and reduce API rate limit issues.
  • Use Case Example: When investigating a TiDB cluster latency spike, use this Skill to pull coprocessor P99 latency trends and current HPA replica counts to identify whether the issue stems from application performance or insufficient scaling.

Quick Start

Use the o11y-metrics-api skill to retrieve the last 24 hours of P99 coprocessor latency and current HPA replica counts for your TiDB cluster with ID 2013516099403907072.

Frequently Asked Questions about o11y-metrics-api

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

FAQPage Schema
How do I query TiDB Cloud observability metrics using a Prometheus-compatible API?

This Skill fetches TiDB Cloud observability metrics through a Prometheus-compatible API, supporting latency analysis, K8s HPA scaling evaluation, and resource utilization tracking. It auto-discovers O11Y UUIDs and manages Auth0 tokens to construct the correct Data Server endpoints for querying.

How do I retrieve P99 coprocessor latency and HPA replica counts for my TiDB cluster?

You can retrieve P99 coprocessor latency and HPA replica counts by querying your specific TiDB cluster ID. This Skill handles the Prometheus-compatible API requests to fetch application performance and Kubernetes infrastructure metrics for the last 24 hours.

Does this observability metrics API tool work with Kubernetes HPA and EBS disk diagnostics?

Yes, this observability metrics API tool works with Kubernetes HPA and EBS disk diagnostics. It supports auto-discovery of infrastructure O11Y UUIDs to fetch HPA replica counts, CPU utilization, and EBS disk performance metrics for your clusters.

Do I need curl and jq to query TiDB Cloud performance metrics?

Yes, you need curl and jq installed in your environment to query TiDB Cloud performance metrics. These dependencies are required to execute the API requests and parse the JSON metric data returned by the Prometheus-compatible interface.

How does the Skill handle Auth0 authentication tokens when querying TiDB metrics?

The Skill manages Auth0 authentication tokens automatically with a 24-hour validity period. This token caching mechanism avoids repeated login calls and reduces API rate limit issues when querying TiDB metrics continuously.

Can I track node resource utilization and TiKV latency for TiDB Cloud clusters of all business types?

Yes, you can track node resource utilization and TiKV latency for TiDB Cloud clusters of all supported business types. The Skill queries the Prometheus-compatible API to deliver infrastructure and application performance metrics regardless of the specific business type.