observability-debugger

Community

Debug Cradle's observability data and runtime state.

Authorwibus-wee
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill enables the debugging of Cradle's observability data, including querying SQLite events, incidents, timelines, runtime snapshots, metrics, and server logs, to identify and address unexpected chat turn behaviors.

Core Features & Use Cases

  • Event Querying: Query and analyze structured error/warn/info events from Cradle's observability_events table.
  • Incident Analysis: Analyze deduplicated grouped events for patterns and causes.
  • Snapshot Examination: Inspect runtime snapshots and events for a deep understanding of chat run phases.
  • Live Runtime Resources: Review live server/runtime resource views for health, active runs, buffers, and more.
  • Metrics Trend Analysis: Use OpenTelemetry metrics for trend and correlation evidence during debugging.
  • Server Logs Inspection: Read pino-structured JSON logs for detailed information on server processes.
  • Use Case: If a chat turn fails unexpectedly, use this Skill to query events, incidents, and runtime snapshots to gather evidence for debugging.

Quick Start

Use the observability-debugger skill to list recent observability events.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 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: observability-debugger
Download link: https://github.com/wibus-wee/cradle-app/archive/main.zip#observability-debugger

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 620,000+ vetted skills library on demand.