cal/claude-home
1
0
Fork 0
Code Issues 6 Pull Requests 4 Actions Packages Projects Releases Wiki Activity
9a39abd64c
claude-home/monitoring/scripts
History
Cal Corum 9a39abd64c fix: add homelab-audit.sh with variable interpolation and collector fixes (#23) 
Closes #23

- Fix STUCK_PROC_CPU_WARN not reaching remote collector: COLLECTOR_SCRIPT
  heredoc stays single-quoted; threshold is passed as $1 to the remote
  bash session so it is evaluated correctly on the collecting host
- Fix LXC IP discovery for static-IP containers: lxc-info result now falls
  back to parsing pct config when lxc-info returns empty
- Fix SSH failures silently dropped: stderr redirected to
  $REPORT_DIR/ssh-failures.log; SSH_FAILURE entries counted and printed
  in the summary
- Add explicit comment explaining why -e is omitted from set options

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-02 20:48:56 -05:00
..
windows-desktop docs: add YAML frontmatter to all 151 markdown files 2026-03-12 09:00:44 -05:00
CONTEXT.md docs: add YAML frontmatter to all 151 markdown files 2026-03-12 09:00:44 -05:00
homelab-audit.sh fix: add homelab-audit.sh with variable interpolation and collector fixes (#23) 2026-04-02 20:48:56 -05:00
jellyfin_gpu_monitor.py CLAUDE: Add Jellyfin GPU health monitor with auto-restart 2026-01-28 22:57:04 -06:00
nvidia_update_checker.py Add NVIDIA update checker and monitoring scripts documentation 2026-02-07 22:21:00 -06:00
README.md docs: add YAML frontmatter to all 151 markdown files 2026-03-12 09:00:44 -05:00
setup-discord-monitoring.md docs: add YAML frontmatter to all 151 markdown files 2026-03-12 09:00:44 -05:00

README.md

title description type domain tags
Monitoring Scripts Reference Reference for available monitoring scripts including tdarr_monitor.py usage and check types, tdarr-timeout-monitor.sh, Windows desktop monitoring, and Discord integration setup. reference monitoring
tdarr
discord
windows
scripts
python
powershell

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:

  • docker/examples/tdarr-troubleshooting.md
  • docker/examples/distributed-transcoding.md
  • tdarr/scripts/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

  • /docker/examples/distributed-transcoding.md - Tdarr architecture patterns
  • /docker/examples/tdarr-troubleshooting.md - Troubleshooting guide
  • /tdarr/scripts/README.md - Tdarr management scripts
  • /tdarr/CONTEXT.md - Tdarr technology overview
  • /monitoring/CONTEXT.md - Monitoring overview and patterns