debugger-help 3.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. debugger_help-3.0.0/PKG-INFO +89 -0
  2. debugger_help-3.0.0/README.md +63 -0
  3. debugger_help-3.0.0/debugger_help/__init__.py +2 -0
  4. debugger_help-3.0.0/debugger_help/agent.py +1125 -0
  5. debugger_help-3.0.0/debugger_help.egg-info/PKG-INFO +89 -0
  6. debugger_help-3.0.0/debugger_help.egg-info/SOURCES.txt +10 -0
  7. debugger_help-3.0.0/debugger_help.egg-info/dependency_links.txt +1 -0
  8. debugger_help-3.0.0/debugger_help.egg-info/entry_points.txt +2 -0
  9. debugger_help-3.0.0/debugger_help.egg-info/requires.txt +12 -0
  10. debugger_help-3.0.0/debugger_help.egg-info/top_level.txt +1 -0
  11. debugger_help-3.0.0/pyproject.toml +36 -0
  12. debugger_help-3.0.0/setup.cfg +4 -0
debugger_help-3.0.0/PKG-INFO ADDED
@@ -0,0 +1,89 @@
1
+ Metadata-Version: 2.4
2
+ Name: debugger-help
3
+ Version: 3.0.0
4
+ Summary: debugger.help VPS Agent — Deep system monitoring for logs, GPU, PM2, Docker, and more
5
+ Author: debugger.help
6
+ License: MIT
7
+ Project-URL: Homepage, https://debugger.help
8
+ Project-URL: Repository, https://github.com/YOUR_ORG/debugger-help
9
+ Keywords: debugger,monitoring,logging,gpu,vps,observability
10
+ Classifier: Development Status :: 4 - Beta
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: License :: OSI Approved :: MIT License
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Topic :: System :: Monitoring
15
+ Requires-Python: >=3.8
16
+ Description-Content-Type: text/markdown
17
+ Requires-Dist: psutil>=5.9.0
18
+ Requires-Dist: requests>=2.28.0
19
+ Provides-Extra: gpu
20
+ Requires-Dist: pynvml>=11.0.0; extra == "gpu"
21
+ Provides-Extra: docker
22
+ Requires-Dist: docker>=6.0.0; extra == "docker"
23
+ Provides-Extra: all
24
+ Requires-Dist: pynvml>=11.0.0; extra == "all"
25
+ Requires-Dist: docker>=6.0.0; extra == "all"
26
+
27
+ # debugger-help
28
+
29
+ Deep VPS monitoring agent for [debugger.help](https://debugger.help). Captures PM2, GPU metrics, Docker containers, system health, and streams everything to your dashboard in real time.
30
+
31
+ ## Install
32
+
33
+ ```bash
34
+ pip install debugger-help
35
+ ```
36
+
37
+ With GPU monitoring:
38
+ ```bash
39
+ pip install debugger-help[gpu]
40
+ ```
41
+
42
+ With everything:
43
+ ```bash
44
+ pip install debugger-help[all]
45
+ ```
46
+
47
+ ## Quick Start
48
+
49
+ ```bash
50
+ export DEBUGGER_API_KEY="your-api-key"
51
+ export DEBUGGER_INGEST_URL="your-ingest-url"
52
+ debugger-agent
53
+ ```
54
+
55
+ Or keep it running with PM2:
56
+ ```bash
57
+ pm2 start "debugger-agent" --name debugger-agent
58
+ pm2 save
59
+ ```
60
+
61
+ ## What it captures
62
+
63
+ - PM2 process states, restart counts, logs, error logs
64
+ - GPU: VRAM per-process, temperature, power, utilization, clock speeds, throttle reasons, ECC errors
65
+ - CPU: per-core usage, load average, frequency, context switches
66
+ - Memory: RAM, swap, shared, buffers, cached
67
+ - Disk: usage per mount, I/O rates, inode usage
68
+ - Network: per-interface stats, TCP connection states, open ports, DNS resolution
69
+ - Processes: top CPU/memory consumers, zombies, open file descriptors
70
+ - Docker containers: status, CPU, memory, restart counts
71
+ - Systemd: failed units
72
+ - SSL certificates: expiry checks
73
+ - System logs: dmesg, OOM kills, journalctl errors
74
+ - File watchers: syslog, PM2 logs, custom log files
75
+
76
+ ## Environment Variables
77
+
78
+ | Variable | Required | Description |
79
+ |----------|----------|-------------|
80
+ | `DEBUGGER_API_KEY` | Yes | Your debugger.help API key |
81
+ | `DEBUGGER_INGEST_URL` | Yes | Your ingest endpoint URL |
82
+ | `DEBUGGER_SOURCE` | No | Source name (default: `vps-{hostname}`) |
83
+ | `DEBUGGER_INTERVAL` | No | Collection interval in seconds (default: `10`) |
84
+ | `DEBUGGER_WATCH_LOGS` | No | Comma-separated extra log file paths |
85
+ | `DEBUGGER_SSL_DOMAINS` | No | Comma-separated domains for SSL checks |
86
+
87
+ ## License
88
+
89
+ MIT
debugger_help-3.0.0/README.md ADDED
@@ -0,0 +1,63 @@
1
+ # debugger-help
2
+
3
+ Deep VPS monitoring agent for [debugger.help](https://debugger.help). Captures PM2, GPU metrics, Docker containers, system health, and streams everything to your dashboard in real time.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ pip install debugger-help
9
+ ```
10
+
11
+ With GPU monitoring:
12
+ ```bash
13
+ pip install debugger-help[gpu]
14
+ ```
15
+
16
+ With everything:
17
+ ```bash
18
+ pip install debugger-help[all]
19
+ ```
20
+
21
+ ## Quick Start
22
+
23
+ ```bash
24
+ export DEBUGGER_API_KEY="your-api-key"
25
+ export DEBUGGER_INGEST_URL="your-ingest-url"
26
+ debugger-agent
27
+ ```
28
+
29
+ Or keep it running with PM2:
30
+ ```bash
31
+ pm2 start "debugger-agent" --name debugger-agent
32
+ pm2 save
33
+ ```
34
+
35
+ ## What it captures
36
+
37
+ - PM2 process states, restart counts, logs, error logs
38
+ - GPU: VRAM per-process, temperature, power, utilization, clock speeds, throttle reasons, ECC errors
39
+ - CPU: per-core usage, load average, frequency, context switches
40
+ - Memory: RAM, swap, shared, buffers, cached
41
+ - Disk: usage per mount, I/O rates, inode usage
42
+ - Network: per-interface stats, TCP connection states, open ports, DNS resolution
43
+ - Processes: top CPU/memory consumers, zombies, open file descriptors
44
+ - Docker containers: status, CPU, memory, restart counts
45
+ - Systemd: failed units
46
+ - SSL certificates: expiry checks
47
+ - System logs: dmesg, OOM kills, journalctl errors
48
+ - File watchers: syslog, PM2 logs, custom log files
49
+
50
+ ## Environment Variables
51
+
52
+ | Variable | Required | Description |
53
+ |----------|----------|-------------|
54
+ | `DEBUGGER_API_KEY` | Yes | Your debugger.help API key |
55
+ | `DEBUGGER_INGEST_URL` | Yes | Your ingest endpoint URL |
56
+ | `DEBUGGER_SOURCE` | No | Source name (default: `vps-{hostname}`) |
57
+ | `DEBUGGER_INTERVAL` | No | Collection interval in seconds (default: `10`) |
58
+ | `DEBUGGER_WATCH_LOGS` | No | Comma-separated extra log file paths |
59
+ | `DEBUGGER_SSL_DOMAINS` | No | Comma-separated domains for SSL checks |
60
+
61
+ ## License
62
+
63
+ MIT
debugger_help-3.0.0/debugger_help/__init__.py ADDED
@@ -0,0 +1,2 @@
1
+ """debugger.help VPS Agent — Deep system monitoring."""
2
+ __version__ = "3.0.0"