cal/claude-home
1
0
Fork 0
Code Issues 6 Pull Requests 4 Actions Packages Projects Releases Wiki Activity
e58c5b8cc1
claude-home/monitoring/scripts
History
Cal Corum e58c5b8cc1
All checks were successful
Auto-merge docs-only PRs / auto-merge-docs (pull_request) Successful in 2s
Details
fix: address PR review — move memory limits to deploy block, handle swap-less hosts 
Move mem_limit/memswap_limit to deploy.resources.limits.memory so the
constraint is actually enforced under Compose v3. Add END clause to
swap_mb() so hosts without a Swap line report 0 instead of empty output.
Fix test script header comment accuracy.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 21:05:12 -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: address PR review — move memory limits to deploy block, handle swap-less hosts 2026-04-02 21:05:12 -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
test-audit-collectors.sh fix: address PR review — move memory limits to deploy block, handle swap-less hosts 2026-04-02 21:05:12 -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