Cal Corum 10c9e0d854 CLAUDE: Migrate to technology-first documentation architecture

Complete restructure from patterns/examples/reference to technology-focused directories:

• Created technology-specific directories with comprehensive documentation:
  - /tdarr/ - Transcoding automation with gaming-aware scheduling
  - /docker/ - Container management with GPU acceleration patterns
  - /vm-management/ - Virtual machine automation and cloud-init
  - /networking/ - SSH infrastructure, reverse proxy, and security
  - /monitoring/ - System health checks and Discord notifications
  - /databases/ - Database patterns and troubleshooting
  - /development/ - Programming language patterns (bash, nodejs, python, vuejs)

• Enhanced CLAUDE.md with intelligent context loading:
  - Technology-first loading rules for automatic context provision
  - Troubleshooting keyword triggers for emergency scenarios
  - Documentation maintenance protocols with automated reminders
  - Context window management for optimal documentation updates

• Preserved valuable content from .claude/tmp/:
  - SSH security improvements and server inventory
  - Tdarr CIFS troubleshooting and Docker iptables solutions
  - Operational scripts with proper technology classification

• Benefits achieved:
  - Self-contained technology directories with complete context
  - Automatic loading of relevant documentation based on keywords
  - Emergency-ready troubleshooting with comprehensive guides
  - Scalable structure for future technology additions
  - Eliminated context bloat through targeted loading

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-08-12 23:20:15 -05:00

3.6 KiB

Raw Blame History

Monitoring Scripts

This directory contains various monitoring scripts and tools for the home lab infrastructure.

Available Scripts

Tdarr Monitoring

tdarr_monitor.py

A comprehensive Python-based monitoring tool for Tdarr media transcoding servers. Features dataclass-based return types for improved type safety and IDE support.

Features:

Server status and health monitoring
Queue status and statistics tracking
Node connectivity and performance monitoring
Library scan progress monitoring
Worker activity tracking
Comprehensive health checks
JSON and pretty-print output formats
Configurable timeouts and logging

Usage:

# Basic health check
./tdarr_monitor.py --server http://10.10.0.43:8265 --check health

# Monitor queue status
./tdarr_monitor.py --server http://10.10.0.43:8265 --check queue

# Get all status information
./tdarr_monitor.py --server http://10.10.0.43:8265 --check all --output json

# Monitor nodes with verbose logging
./tdarr_monitor.py --server http://10.10.0.43:8265 --check nodes --verbose

Available Checks:

health - Comprehensive health check (default)
status - Server status and configuration
queue - Transcoding queue statistics
nodes - Connected nodes status
libraries - Library scan progress
stats - Overall transcoding statistics
all - All checks combined

Output Formats:

pretty - Human-readable format (default)
json - Structured JSON output

Exit Codes:

0 - Success, all systems healthy
1 - Error or unhealthy status detected

Requirements:

Python 3.7+
requests library
Access to Tdarr server API endpoints

tdarr-timeout-monitor.sh

Shell script for monitoring Tdarr timeouts and system status.

Usage:

./tdarr-timeout-monitor.sh

System Monitoring

Windows Desktop Monitoring

Complete Windows desktop monitoring system with Discord notifications for reboots and system events.

Location: windows-desktop/

Full setup instructions in windows-desktop/README.md
PowerShell monitoring scripts
Windows Task Scheduler integration
Discord webhook notifications

Features:

Automatic reboot detection
System startup/shutdown monitoring
Discord notifications with timestamps
Configurable monitoring intervals
Windows Task Scheduler integration

Setup and Configuration

Discord Integration

See setup-discord-monitoring.md for Discord webhook setup instructions.

Integration with Home Lab

Tdarr Keywords Trigger

When working with Tdarr-related tasks, the following documentation is automatically loaded:

reference/docker/tdarr-troubleshooting.md
patterns/docker/distributed-transcoding.md
scripts/tdarr/README.md

Gaming-Aware Scheduling

The monitoring scripts integrate with the gaming-aware Tdarr scheduling system that provides:

Configurable time windows for transcoding
Gaming session detection
Automated resource management
Smart scheduling to avoid performance conflicts

Best Practices

Regular Monitoring: Set up cron jobs or scheduled tasks for regular status checks
Health Checks: Use the health check endpoints for automated monitoring
Logging: Enable verbose logging for troubleshooting
Timeout Configuration: Adjust timeouts based on network conditions
Error Handling: Monitor exit codes for automated alerting

/patterns/docker/distributed-transcoding.md - Tdarr architecture patterns
/reference/docker/tdarr-troubleshooting.md - Troubleshooting guide
/scripts/tdarr/README.md - Tdarr management scripts

3.6 KiB Raw Blame History