10c9e0d854
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>
117 lines
3.6 KiB
Markdown
117 lines
3.6 KiB
Markdown
# 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:**
|
|
```bash
|
|
# 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:**
|
|
```bash
|
|
./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
|
|
|
|
1. **Regular Monitoring**: Set up cron jobs or scheduled tasks for regular status checks
|
|
2. **Health Checks**: Use the health check endpoints for automated monitoring
|
|
3. **Logging**: Enable verbose logging for troubleshooting
|
|
4. **Timeout Configuration**: Adjust timeouts based on network conditions
|
|
5. **Error Handling**: Monitor exit codes for automated alerting
|
|
|
|
## Related Documentation
|
|
|
|
- `/patterns/docker/distributed-transcoding.md` - Tdarr architecture patterns
|
|
- `/reference/docker/tdarr-troubleshooting.md` - Troubleshooting guide
|
|
- `/scripts/tdarr/README.md` - Tdarr management scripts |