o11y-auth

Unify TiDB Cloud O11Y authentication with cached bearer, Auth0, and AWS STS credentials.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This Skill eliminates the tedious, error-prone process of manually gathering separate credentials for TiDB Cloud O11Y services and mapping TiDB cluster deploy types to the correct O11Y bizType values for API calls.

Core Features & Use Cases

  • Unified Credential Retrieval: Fetches all required O11Y bearer tokens, Auth0 control plane tokens, and AWS STS S3 credentials in a single authenticated call, with automatic caching to avoid repeated logins.
  • Deterministic bizType Mapping: Includes a built-in helper to automatically convert TiDB cluster deploy types (premium, dedicated, starter) and environments (dev, staging, prod) to the correct O11Y bizType for API endpoints.
  • Use Case: For example, if you need to pull monitoring pipeline data from a TiDB Cloud premium production cluster, use this Skill to instantly get valid access tokens and the correct bizType without manual lookup or repeated authentication steps.

Quick Start

Use the o11y-auth skill to authenticate to the TiDB Cloud O11Y platform, retrieve all required API and S3 access credentials, and resolve the correct bizType for your target cluster.

Frequently Asked Questions about o11y-auth

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

FAQPage Schema
How do I authenticate to TiDB Cloud O11Y APIs without manually managing multiple tokens?

You can authenticate to TiDB Cloud O11Y APIs by using a unified credential retrieval process that fetches all required bearer tokens, Auth0 control plane tokens, and AWS STS S3 credentials in a single call. This eliminates manual token collection and includes automatic caching to prevent repeated logins.

How do I map TiDB cluster deploy types to O11Y bizType values for API calls?

To map TiDB cluster deploy types to O11Y bizType values, you can use a deterministic built-in helper that automatically converts cluster deploy types like premium, dedicated, or starter alongside their environments into the correct bizType for your API endpoints.

Does the O11Y authentication process cache AWS STS credentials and Auth0 tokens?

Yes, the O11Y authentication process caches AWS STS credentials and Auth0 tokens automatically. It uses cached auto-refreshing credentials with built-in retry logic to handle transient authentication failures and avoid repeated logins.

What do I need to retrieve S3 bucket access credentials for TiDB Cloud exported data?

To retrieve S3 bucket access credentials for TiDB Cloud exported data, you need curl and jq installed in your environment. The unified authentication call fetches the required AWS STS S3 credentials alongside your O11Y bearer tokens.

Why does my TiDB Cloud O11Y authentication fail with transient token errors?

TiDB Cloud O11Y authentication may fail with transient token errors due to network disruptions or token expiration. The unified authentication process includes automatic retry logic specifically designed to handle these transient authentication failures.