iris-controller-debug

Analyze offline checkpoint snapshots and profile Iris controller processes via RPC.

1.2k|146|Updated Mar 22, 2024
One-click install
npx skills add https://github.com/marin-community/marin --skill iris-controller-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iris-controller-debug
Source: https://github.com/marin-community/marin/tree/main/.agents/skills/iris-controller-debug
Command: npx skills add https://github.com/marin-community/marin --skill iris-controller-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues within the Iris controller, such as stuck jobs, resource leaks, scheduling failures, or worker problems, by providing tools for offline analysis and profiling.

Core Features & Use Cases

  • Offline Debugging: Analyze controller state using downloaded checkpoint snapshots, ensuring the live system is not impacted.
  • Profiling: Utilize the /system/process RPC for detailed thread and memory profiling, or SSH as a fallback.
  • Log Analysis: Fetch and filter controller logs to identify specific errors or warnings.
  • Use Case: When jobs are consistently failing to schedule, use this Skill to trigger a checkpoint, download it, and query the jobs and tasks tables offline to understand the scheduling constraints and reasons for failure.

Quick Start

Debug Iris controller issues by triggering a fresh checkpoint, downloading it, and querying offline.

Frequently Asked Questions about iris-controller-debug

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

FAQPage Schema
How do I debug Iris controller scheduling failures and stuck jobs?

Profile Iris controller worker problems by utilizing the /system/process RPC for detailed thread and memory diagnostics, or fall back to SSH if the RPC endpoint is unavailable.

Can I analyze Iris controller state offline without affecting the live system?

Fetch and filter Iris controller logs to identify specific errors or warnings, and combine this with offline checkpoint analysis to diagnose worker problems and resource leaks comprehensively.

What is the best way to profile Iris controller threads and memory?

Profile Iris controller threads and memory by utilizing the /system/process RPC for detailed diagnostics, or use SSH as a fallback method when direct RPC profiling is not accessible.

Do I need to download SQLite checkpoints to diagnose Iris controller resource leaks?

Downloading SQLite checkpoints is required for offline debugging of Iris controller resource leaks, enabling you to query local snapshots and identify issues without stressing the live system.