Skills
.Work. You
Rest

troubleshoot-zymtrace-backend

Official

Diagnose why zymtrace shows no data

Software Engineering#troubleshooting#kubernetes#profiling#observability#helm#clickhouse#zymtrace
Authorzystem-io
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps you debug a deployed zymtrace backend when users see missing or incomplete data in the UI, ingest failures, ClickHouse storage exhaustion, or license/auth issues, by walking symptoms through end-to-end diagnosis across backend ingest and profiler reporting.

Core Features & Use Cases

  • Symptom-driven troubleshooting: Routes you to the correct diagnostic path for “no data in the UI”, license/auth failures, ingest CrashLoopBackOff, slow queries, and storage growth.
  • End-to-end path validation: Checks the full chain from workload → profiler agent → backend gateway (gRPC) → ingest → ClickHouse → UI so a single broken link is found.
  • Safe, verification-first fixes: Recommends actions like Helm upgrades with proper reset semantics, retention adjustments, and capacity expansion while emphasizing guardrails and rerunning verification steps.

Quick Start

Tell the Skill what you’re seeing (for example, “the UI loads but no profiles appear”), and it will guide you through diagnosing profiler reporting, ingest health, and ClickHouse storage to identify the broken link.

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: troubleshoot-zymtrace-backend
Download link: https://github.com/zystem-io/zymtrace-skills/archive/main.zip#troubleshoot-zymtrace-backend

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.