pingerplot 1.6.0__tar.gz → 1.7.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.
- {pingerplot-1.6.0 → pingerplot-1.7.0}/PKG-INFO +37 -27
- {pingerplot-1.6.0 → pingerplot-1.7.0}/README.md +35 -24
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/__init__.py +1 -1
- pingerplot-1.7.0/pingerplot/errorlog.py +137 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui.py +60 -8
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_updates.py +5 -5
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_widgets.py +32 -6
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/headless.py +5 -1
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/history.py +2 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/monitor.py +30 -5
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/tcpudp.py +46 -8
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/theme.py +18 -3
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/trouble.py +34 -2
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/updater.py +35 -1
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/winplatform.py +117 -7
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/PKG-INFO +37 -27
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/SOURCES.txt +8 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pyproject.toml +4 -4
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alert_lock_discipline.py +2 -2
- pingerplot-1.7.0/tests/test_alert_where.py +87 -0
- pingerplot-1.7.0/tests/test_button_corners.py +15 -0
- pingerplot-1.7.0/tests/test_capture_mode.py +95 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_elevate.py +2 -2
- pingerplot-1.7.0/tests/test_errorlog.py +108 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_updates.py +1 -1
- pingerplot-1.7.0/tests/test_keyboard.py +92 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_map_trouble.py +35 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_packaging.py +19 -1
- pingerplot-1.7.0/tests/test_single_instance_posix.py +75 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_theme_platform.py +0 -3
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_trouble.py +32 -0
- pingerplot-1.7.0/tests/test_update_in_use.py +40 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/LICENSE +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/__main__.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/appicon.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/compare.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/ed25519.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/geoip.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gfx.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_charts.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_history.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_hopinfo.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_recording.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_settings.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/icmp.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/icmp_posix.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/investigate.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/launch.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/locating.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/model.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/places.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/routes.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/selfcheck.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/selftest.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/settings.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/tkthreads.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/tray.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/update_key.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/worldmap.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/xdg.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/dependency_links.txt +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/entry_points.txt +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/requires.txt +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/top_level.txt +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/setup.cfg +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alert_responder_change.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alert_route_change.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alerts.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_appicon.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_autostart_command.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_background.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_bom_tolerance.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_capture_precedence.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_capture_refusal_text.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_ci_coverage_gate.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_compare.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_compare_thread_safety.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_dns_follow.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_draw_gating.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_dscp_and_source.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_ed25519.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_elevated_log_paths.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_events_view_bounded.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_export.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_export_header.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_geoip.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_geoip_cache.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_history.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_hopinfo.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_recording.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_sessions.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_events.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_icmp_preflight.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_streams.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_supervision.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_history.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_history_monitor.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_addr.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_posix.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_posix_matching.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_posix_timestamps.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_interval_note.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_investigate.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_launch.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_launcher.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_lifecycle.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_linux_desktop.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_linux_notify.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_linux_theme.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_locating.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_close_race.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_open_failure.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_precision.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_rotation_failure.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_low_severity_fixes.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_malformed_sessions.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_map_labels.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_model.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_mos.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_mos_alert.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_no_real_addresses.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_non_finite.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_option_ceilings.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_per_target_log.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_places.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_probe_rounds.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_probe_waves.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_refresh_loop.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_report_mode.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_route.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_route_history.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_routes.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_row_colours.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_save_soon.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_selfcheck.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_settings.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_settings_failures.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_settings_private.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_source_ip_enforced.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_stale_worker.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_stop_all_concurrently.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_target_settings_persist.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tcp_hop_sockets_close.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tcp_timeout_floor.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tcpudp.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tkthreads.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_update_helper.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_updater.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_webhook_secrets.py +0 -0
- {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_wheel.py +0 -0
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: pingerplot
|
|
3
|
-
Version: 1.
|
|
3
|
+
Version: 1.7.0
|
|
4
4
|
Summary: A continuous-traceroute network path monitor (MTR-style) with a Tkinter GUI: per-hop latency, loss, jitter and MOS over time.
|
|
5
5
|
Author: James Cupps
|
|
6
|
-
License: MIT
|
|
6
|
+
License-Expression: MIT
|
|
7
7
|
Project-URL: Homepage, https://github.com/jamesccupps/PingerPlot
|
|
8
8
|
Project-URL: Source, https://github.com/jamesccupps/PingerPlot
|
|
9
9
|
Project-URL: Issues, https://github.com/jamesccupps/PingerPlot/issues
|
|
@@ -13,7 +13,6 @@ Classifier: Environment :: Win32 (MS Windows)
|
|
|
13
13
|
Classifier: Environment :: X11 Applications
|
|
14
14
|
Classifier: Intended Audience :: System Administrators
|
|
15
15
|
Classifier: Intended Audience :: Information Technology
|
|
16
|
-
Classifier: License :: OSI Approved :: MIT License
|
|
17
16
|
Classifier: Operating System :: Microsoft :: Windows
|
|
18
17
|
Classifier: Operating System :: POSIX :: Linux
|
|
19
18
|
Classifier: Operating System :: MacOS :: MacOS X
|
|
@@ -30,7 +29,7 @@ Dynamic: license-file
|
|
|
30
29
|
|
|
31
30
|
[](https://github.com/jamesccupps/PingerPlot/releases/latest)
|
|
32
31
|
[](https://github.com/jamesccupps/PingerPlot/actions/workflows/ci.yml)
|
|
33
|
-
[](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
32
|
+
[](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE)
|
|
34
33
|
|
|
35
34
|
Shows you *where* along a network path a connection goes wrong. Like `mtr` or WinMTR, PingerPlot finds every
|
|
36
35
|
router between you and a target and then keeps probing all of them, so loss, latency, jitter and a voice-quality
|
|
@@ -42,10 +41,10 @@ when the destination degrades, and needs no administrator rights for ICMP.
|
|
|
42
41
|
(`PingerPlot-Setup.exe`, Windows 10 or 11, 64-bit) ·
|
|
43
42
|
[Portable zip](https://github.com/jamesccupps/PingerPlot/releases/latest/download/PingerPlot-win64.zip) ·
|
|
44
43
|
[All releases](https://github.com/jamesccupps/PingerPlot/releases) ·
|
|
45
|
-
[Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
44
|
+
[Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) ·
|
|
46
45
|
[Website](https://jamesccupps.github.io/PingerPlot/)
|
|
47
46
|
|
|
48
|
-

|
|
49
48
|
|
|
50
49
|
<sub>Demo mode: simulated paths with documentation addresses.</sub>
|
|
51
50
|
|
|
@@ -101,11 +100,11 @@ scoop install jamesccupps/pingerplot
|
|
|
101
100
|
It installs the portable zip with a Start menu shortcut, keeps its settings in `%APPDATA%\PingerPlot`, and puts
|
|
102
101
|
`pingerplot-headless` on your PATH. `scoop update pingerplot` updates it.
|
|
103
102
|
|
|
104
|
-
**Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
103
|
+
**Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) below: one `pipx` command.
|
|
105
104
|
|
|
106
105
|
**From source** (Windows, Linux, macOS): Python 3.10 or newer, nothing to `pip install`.
|
|
107
106
|
`git clone https://github.com/jamesccupps/PingerPlot`, then `python main.py`, or on Windows double-click
|
|
108
|
-
`PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
107
|
+
`PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#running-from-source) for shortcuts and an elevated
|
|
109
108
|
logon task.
|
|
110
109
|
|
|
111
110
|
> **About antivirus warnings.** Some antivirus engines flag PyInstaller programs heuristically, and this one is a
|
|
@@ -127,17 +126,18 @@ or newer and Tk, which most distributions package separately:
|
|
|
127
126
|
| openSUSE | `sudo zypper install python3-tk` |
|
|
128
127
|
|
|
129
128
|
Then, with [pipx](https://pipx.pypa.io/) (`sudo apt install pipx` on Debian and Ubuntu, `sudo dnf install pipx` on
|
|
130
|
-
Fedora, `sudo pacman -S python-pipx` on Arch), install it for your
|
|
129
|
+
Fedora, `sudo pacman -S python-pipx` on Arch), install it from [PyPI](https://pypi.org/project/pingerplot/) for your
|
|
130
|
+
user and start it:
|
|
131
131
|
|
|
132
132
|
```bash
|
|
133
|
-
pipx install
|
|
133
|
+
pipx install pingerplot
|
|
134
134
|
pingerplot
|
|
135
135
|
```
|
|
136
136
|
|
|
137
137
|
In **Settings**, turn on **Show in the applications menu** to add it, with its icon, to your desktop's menu and
|
|
138
138
|
search, and **Start when you sign in** if you want it monitoring from sign-in. To update: `pipx reinstall
|
|
139
139
|
pingerplot` (the app checks once a day and says when there's a new version). To remove it, see
|
|
140
|
-
[Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
140
|
+
[Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#uninstalling). Or skip pipx: `git clone` and `python3 main.py` works the same.
|
|
141
141
|
|
|
142
142
|
ICMP needs no root: it uses the kernel's unprivileged ICMP sockets, which most systemd-based distributions allow
|
|
143
143
|
by default. If PingerPlot says the ICMP backend is unavailable, it names the one `sysctl` to run.
|
|
@@ -168,19 +168,23 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
|
|
|
168
168
|
database (each says which), whose network it's on, and every router seen at that hop in the last day.
|
|
169
169
|
- **Timeline**: every hop stacked on one time axis.
|
|
170
170
|
- **Map**: the path on a map, zoomed to fit, each router placed by its name when that names a city and by
|
|
171
|
-
the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
171
|
+
the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#updates-and-privacy)), unless its round trip shows the database
|
|
172
172
|
is wrong: a reply can't come from farther away than light in fiber travels in the time, so 1.1.1.1
|
|
173
173
|
answering in 3 ms isn't in Brisbane. A router answering as fast as the one beside it, placed by its name,
|
|
174
174
|
but put hundreds of kilometers from it is doubted too. Such a router is left off, and Details says why. The target's other
|
|
175
175
|
routes from the last day are dashed underneath. Below it, **where the trouble is**: each place on the path, the delay it adds
|
|
176
176
|
and the loss that starts there and carries to the destination (loss that stops at a router is that router
|
|
177
|
-
ignoring pings, and isn't counted), with a one-line verdict.
|
|
177
|
+
ignoring pings, and isn't counted), with a one-line verdict. When other targets' loss starts at the same
|
|
178
|
+
router, the verdict says so: the trouble is that router or something before it, often your own side.
|
|
178
179
|
- **Events**: route changes, alerts raised and cleared, warnings.
|
|
179
180
|
3. **Pause**, **Stop** and **Edit settings** are at the top right. Editing a target's settings restarts it with
|
|
180
181
|
them.
|
|
181
182
|
|
|
182
183
|
- **⋯** on a card, or a right-click, has *Edit settings…*, *Pause*/*Resume*, *Stop*/*Start* and *Remove*.
|
|
183
184
|
Right-click a hop for its details, or to copy its address, hostname or row. Ctrl+N goes back to the box.
|
|
185
|
+
- **From the keyboard**: Tab moves through everything, with the focus outlined; Return or Space chooses a tab, and
|
|
186
|
+
Left and Right move between tabs. In the target list, Up and Down change the target and the Menu key (or
|
|
187
|
+
Shift+F10) opens its menu. Ctrl+1 to Ctrl+4 open Hops, Timeline, Map and Events, and Ctrl+, opens Settings.
|
|
184
188
|
- **Settings** holds the defaults for new targets (probing, alerts, logging and webhooks) and the app's own
|
|
185
189
|
options: theme, resuming your targets at start, Start with Windows, the notification area, notifications and
|
|
186
190
|
updates.
|
|
@@ -208,7 +212,9 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
|
|
|
208
212
|
Y ms, MOS at or below Z, over the last N probes. The window is what makes it "sustained": a single spike won't trip
|
|
209
213
|
a 20-probe window. `0` turns a check off. An alert raises when it crosses the threshold and clears by itself when it
|
|
210
214
|
recovers; both go into Events, the banner, a notification (**Settings → Show a notification for alerts**), the
|
|
211
|
-
optional sound and the webhook.
|
|
215
|
+
optional sound and the webhook. An alert's Events entry and webhook also say where on the path the trouble is, as
|
|
216
|
+
the Map does ("Loss reaching the destination starts in Chicago, US (hop 7, 12%)"), with each router placed by its
|
|
217
|
+
name; one whose name names no city stands for itself.
|
|
212
218
|
|
|
213
219
|
Alerts judge the destination only, the one hop whose numbers aren't muddied by routers deprioritizing ICMP, and
|
|
214
220
|
only once it has answered, so a target that simply blocks ICMP never false-alarms. The window counts only probes
|
|
@@ -217,7 +223,8 @@ held that TTL in the meantime, and its rate-limited "TTL exceeded" replies aren'
|
|
|
217
223
|
table still shows per-TTL statistics across responders, as `mtr` does.
|
|
218
224
|
|
|
219
225
|
**Webhook** (**Settings → Logging and webhooks**): an `https://` or `http://` address gets a JSON POST when an alert
|
|
220
|
-
raises or clears
|
|
226
|
+
raises or clears: `app`, `event` (`alert` or `clear`), `target`, `target_ip`, `text` and `time`, and for an alert
|
|
227
|
+
`where`, the places on the path worst first, each `{place, hops, delay_added_ms, loss_starts_pct}`. A delivery that fails is a warning in Events naming only the host, never the full address
|
|
221
228
|
(Slack, Teams and ntfy put the secret in the path).
|
|
222
229
|
|
|
223
230
|
## Probe modes
|
|
@@ -279,7 +286,7 @@ pinned run measured something different from a plain one.
|
|
|
279
286
|
Everything PingerPlot measures is kept, with nothing to set up: every probe and the router that answered it,
|
|
280
287
|
per-minute loss, latency and jitter for each hop and router, every event (alerts, reroutes, DNS moves, warnings),
|
|
281
288
|
and which route each target was on, when. It goes into one SQLite database on this computer (see
|
|
282
|
-
[Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
289
|
+
[Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#where-it-keeps-things)), shared by the window and the headless runner.
|
|
283
290
|
|
|
284
291
|
- **Reroutes, not noise.** A hop whose router changes and stays changed for 3 rounds is a reroute: one event that
|
|
285
292
|
names the hops that moved. A hop that takes turns between routers (load balancing over parallel links) is noted
|
|
@@ -350,7 +357,9 @@ problem…** opens a GitHub issue form with the version filled in, which you edi
|
|
|
350
357
|
## Where it keeps things
|
|
351
358
|
|
|
352
359
|
- `%APPDATA%\PingerPlot\` holds `settings.json` (your targets, each with its settings, and the app's options),
|
|
353
|
-
`update.log`,
|
|
360
|
+
`update.log`, `error.log` (errors, and when PingerPlot started and quit; the headless runner's is
|
|
361
|
+
`headless-error.log`), the history in `history\history.sqlite3`, and `lookups.json` (where routers are, kept a
|
|
362
|
+
month).
|
|
354
363
|
On Linux and macOS it's `$XDG_CONFIG_HOME/PingerPlot`, usually `~/.config/PingerPlot`.
|
|
355
364
|
- A portable copy keeps them beside `PingerPlot.exe` instead. Delete `portable.txt` to make it use `%APPDATA%`.
|
|
356
365
|
- On Linux, the menu and sign-in entries are `~/.local/share/applications/pingerplot.desktop` and
|
|
@@ -391,7 +400,7 @@ task at `pingerplot-headless.exe C:\path\to\monitor.json` (or `pythonw.exe -m pi
|
|
|
391
400
|
Besides the status lines, it prints every event as it happens: alerts raised and cleared, route changes, and
|
|
392
401
|
warnings such as a probe log it couldn't open or a webhook that wasn't delivered.
|
|
393
402
|
|
|
394
|
-
It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
403
|
+
It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#history) as the window, so the window shows what it measured. A `recording`
|
|
395
404
|
object in the config changes that: `"recording": {"enabled": false}` turns it off, and `probe_days`,
|
|
396
405
|
`summary_days`, `event_days` and `max_mb` set how much is kept, as in Settings → Recording.
|
|
397
406
|
|
|
@@ -431,7 +440,7 @@ example.net: now vs last-week
|
|
|
431
440
|
**Windows 10 and 11: tested**, and the only platform with a download. The ICMP backend (`icmp.py`) uses the Win32
|
|
432
441
|
IP Helper API, so it needs no admin rights and no capture driver.
|
|
433
442
|
|
|
434
|
-
**Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
443
|
+
**Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) for installing it). **macOS: implemented, untested on a Mac.** Both run
|
|
435
444
|
from source. `icmp_posix.py` uses
|
|
436
445
|
unprivileged `SOCK_DGRAM`/`IPPROTO_ICMP` sockets, the same technique `mtr` uses, and `icmp.ping()` dispatches to it,
|
|
437
446
|
so the engine, window and headless runner don't know which backend answered.
|
|
@@ -501,17 +510,18 @@ session if you want the probes logged.
|
|
|
501
510
|
|
|
502
511
|
| What you see | Fix |
|
|
503
512
|
|---|---|
|
|
513
|
+
| Something went wrong, or PingerPlot quit or stopped recording | `error.log` in the settings folder (above) has the error and when PingerPlot started and quit. Web addresses in it are cut to their host, so it's safe to attach to an issue. |
|
|
504
514
|
| Loss at a hop in the middle | Usually normal: that router rate-limits the replies it generates. Only loss that reaches the destination row is a problem. |
|
|
505
515
|
| "Full TCP/UDP traceroute needs Administrator" | Click **Restart as administrator** beside it (or ⋯ → Restart as administrator), or use ICMP, or TCP with **Destination only**. From source, `launch.ps1 -Elevated`. |
|
|
506
516
|
| "Full TCP/UDP traceroute is Windows-only for now" (Linux, macOS) | Use ICMP, or TCP with **Destination only**. |
|
|
507
|
-
| "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
517
|
+
| "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux)). |
|
|
508
518
|
| A target shows "Cannot resolve" | DNS for that name failed. The window doesn't retry by itself: **⋯ → Start** on its card once the network is up. (The headless runner retries.) |
|
|
509
519
|
| No notification for an alert | **Settings → Show a notification for alerts**, then Windows' *Settings → System → Notifications* for PingerPlot, and Do not disturb. |
|
|
510
|
-
| The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back. |
|
|
520
|
+
| The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back, on Linux too (one copy runs at a time). |
|
|
511
521
|
| "Windows protected your PC" | **More info** should show the publisher, James Cupps, then **Run anyway**. |
|
|
512
522
|
| "The probe log couldn't roll over" in Events | The CSV is open in another program, usually Excel. It keeps appending and tries again a minute later. |
|
|
513
|
-
| The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. |
|
|
514
|
-
| "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
523
|
+
| The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. If the headless runner runs from PingerPlot's folder (a Task Scheduler task), stop it first: Windows won't replace a program that's running, and PingerPlot says so rather than start an update that can't finish. |
|
|
524
|
+
| "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#platform)). |
|
|
515
525
|
|
|
516
526
|
## Uninstalling
|
|
517
527
|
|
|
@@ -569,14 +579,14 @@ failure), then builds the Windows release files, runs the built app's self-test,
|
|
|
569
579
|
the installer, and has a copy update itself to the build. A version tag (`v1.4.0`) builds, tests, signs and
|
|
570
580
|
publishes the release. The release workflow's build job is read-only, only a job that installs nothing holds the
|
|
571
581
|
signing key, and only one that runs nothing but `gh` can publish; every action is pinned by commit SHA and the
|
|
572
|
-
build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
573
|
-
what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
582
|
+
build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CLAUDE.md) has the architecture, the release process and
|
|
583
|
+
what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/ROADMAP.md) what's planned; [CONTRIBUTING.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CONTRIBUTING.md) how to
|
|
574
584
|
help.
|
|
575
585
|
|
|
576
586
|
## License
|
|
577
587
|
|
|
578
|
-
MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
579
|
-
[THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
588
|
+
MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE). The libraries inside the Windows build are listed, with their licenses, in
|
|
589
|
+
[THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/THIRD-PARTY-NOTICES.md).
|
|
580
590
|
|
|
581
591
|
PingerPlot is an independent hobby project, not affiliated with or endorsed by any commercial network-monitoring
|
|
582
592
|
product. It is a **read-only diagnostic**: it sends probes and reads replies, and never writes to or reconfigures
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/jamesccupps/PingerPlot/releases/latest)
|
|
4
4
|
[](https://github.com/jamesccupps/PingerPlot/actions/workflows/ci.yml)
|
|
5
|
-
[](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
5
|
+
[](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE)
|
|
6
6
|
|
|
7
7
|
Shows you *where* along a network path a connection goes wrong. Like `mtr` or WinMTR, PingerPlot finds every
|
|
8
8
|
router between you and a target and then keeps probing all of them, so loss, latency, jitter and a voice-quality
|
|
@@ -14,10 +14,10 @@ when the destination degrades, and needs no administrator rights for ICMP.
|
|
|
14
14
|
(`PingerPlot-Setup.exe`, Windows 10 or 11, 64-bit) ·
|
|
15
15
|
[Portable zip](https://github.com/jamesccupps/PingerPlot/releases/latest/download/PingerPlot-win64.zip) ·
|
|
16
16
|
[All releases](https://github.com/jamesccupps/PingerPlot/releases) ·
|
|
17
|
-
[Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
17
|
+
[Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) ·
|
|
18
18
|
[Website](https://jamesccupps.github.io/PingerPlot/)
|
|
19
19
|
|
|
20
|
-

|
|
21
21
|
|
|
22
22
|
<sub>Demo mode: simulated paths with documentation addresses.</sub>
|
|
23
23
|
|
|
@@ -73,11 +73,11 @@ scoop install jamesccupps/pingerplot
|
|
|
73
73
|
It installs the portable zip with a Start menu shortcut, keeps its settings in `%APPDATA%\PingerPlot`, and puts
|
|
74
74
|
`pingerplot-headless` on your PATH. `scoop update pingerplot` updates it.
|
|
75
75
|
|
|
76
|
-
**Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
76
|
+
**Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) below: one `pipx` command.
|
|
77
77
|
|
|
78
78
|
**From source** (Windows, Linux, macOS): Python 3.10 or newer, nothing to `pip install`.
|
|
79
79
|
`git clone https://github.com/jamesccupps/PingerPlot`, then `python main.py`, or on Windows double-click
|
|
80
|
-
`PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
80
|
+
`PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#running-from-source) for shortcuts and an elevated
|
|
81
81
|
logon task.
|
|
82
82
|
|
|
83
83
|
> **About antivirus warnings.** Some antivirus engines flag PyInstaller programs heuristically, and this one is a
|
|
@@ -99,17 +99,18 @@ or newer and Tk, which most distributions package separately:
|
|
|
99
99
|
| openSUSE | `sudo zypper install python3-tk` |
|
|
100
100
|
|
|
101
101
|
Then, with [pipx](https://pipx.pypa.io/) (`sudo apt install pipx` on Debian and Ubuntu, `sudo dnf install pipx` on
|
|
102
|
-
Fedora, `sudo pacman -S python-pipx` on Arch), install it for your
|
|
102
|
+
Fedora, `sudo pacman -S python-pipx` on Arch), install it from [PyPI](https://pypi.org/project/pingerplot/) for your
|
|
103
|
+
user and start it:
|
|
103
104
|
|
|
104
105
|
```bash
|
|
105
|
-
pipx install
|
|
106
|
+
pipx install pingerplot
|
|
106
107
|
pingerplot
|
|
107
108
|
```
|
|
108
109
|
|
|
109
110
|
In **Settings**, turn on **Show in the applications menu** to add it, with its icon, to your desktop's menu and
|
|
110
111
|
search, and **Start when you sign in** if you want it monitoring from sign-in. To update: `pipx reinstall
|
|
111
112
|
pingerplot` (the app checks once a day and says when there's a new version). To remove it, see
|
|
112
|
-
[Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
113
|
+
[Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#uninstalling). Or skip pipx: `git clone` and `python3 main.py` works the same.
|
|
113
114
|
|
|
114
115
|
ICMP needs no root: it uses the kernel's unprivileged ICMP sockets, which most systemd-based distributions allow
|
|
115
116
|
by default. If PingerPlot says the ICMP backend is unavailable, it names the one `sysctl` to run.
|
|
@@ -140,19 +141,23 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
|
|
|
140
141
|
database (each says which), whose network it's on, and every router seen at that hop in the last day.
|
|
141
142
|
- **Timeline**: every hop stacked on one time axis.
|
|
142
143
|
- **Map**: the path on a map, zoomed to fit, each router placed by its name when that names a city and by
|
|
143
|
-
the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
144
|
+
the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#updates-and-privacy)), unless its round trip shows the database
|
|
144
145
|
is wrong: a reply can't come from farther away than light in fiber travels in the time, so 1.1.1.1
|
|
145
146
|
answering in 3 ms isn't in Brisbane. A router answering as fast as the one beside it, placed by its name,
|
|
146
147
|
but put hundreds of kilometers from it is doubted too. Such a router is left off, and Details says why. The target's other
|
|
147
148
|
routes from the last day are dashed underneath. Below it, **where the trouble is**: each place on the path, the delay it adds
|
|
148
149
|
and the loss that starts there and carries to the destination (loss that stops at a router is that router
|
|
149
|
-
ignoring pings, and isn't counted), with a one-line verdict.
|
|
150
|
+
ignoring pings, and isn't counted), with a one-line verdict. When other targets' loss starts at the same
|
|
151
|
+
router, the verdict says so: the trouble is that router or something before it, often your own side.
|
|
150
152
|
- **Events**: route changes, alerts raised and cleared, warnings.
|
|
151
153
|
3. **Pause**, **Stop** and **Edit settings** are at the top right. Editing a target's settings restarts it with
|
|
152
154
|
them.
|
|
153
155
|
|
|
154
156
|
- **⋯** on a card, or a right-click, has *Edit settings…*, *Pause*/*Resume*, *Stop*/*Start* and *Remove*.
|
|
155
157
|
Right-click a hop for its details, or to copy its address, hostname or row. Ctrl+N goes back to the box.
|
|
158
|
+
- **From the keyboard**: Tab moves through everything, with the focus outlined; Return or Space chooses a tab, and
|
|
159
|
+
Left and Right move between tabs. In the target list, Up and Down change the target and the Menu key (or
|
|
160
|
+
Shift+F10) opens its menu. Ctrl+1 to Ctrl+4 open Hops, Timeline, Map and Events, and Ctrl+, opens Settings.
|
|
156
161
|
- **Settings** holds the defaults for new targets (probing, alerts, logging and webhooks) and the app's own
|
|
157
162
|
options: theme, resuming your targets at start, Start with Windows, the notification area, notifications and
|
|
158
163
|
updates.
|
|
@@ -180,7 +185,9 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
|
|
|
180
185
|
Y ms, MOS at or below Z, over the last N probes. The window is what makes it "sustained": a single spike won't trip
|
|
181
186
|
a 20-probe window. `0` turns a check off. An alert raises when it crosses the threshold and clears by itself when it
|
|
182
187
|
recovers; both go into Events, the banner, a notification (**Settings → Show a notification for alerts**), the
|
|
183
|
-
optional sound and the webhook.
|
|
188
|
+
optional sound and the webhook. An alert's Events entry and webhook also say where on the path the trouble is, as
|
|
189
|
+
the Map does ("Loss reaching the destination starts in Chicago, US (hop 7, 12%)"), with each router placed by its
|
|
190
|
+
name; one whose name names no city stands for itself.
|
|
184
191
|
|
|
185
192
|
Alerts judge the destination only, the one hop whose numbers aren't muddied by routers deprioritizing ICMP, and
|
|
186
193
|
only once it has answered, so a target that simply blocks ICMP never false-alarms. The window counts only probes
|
|
@@ -189,7 +196,8 @@ held that TTL in the meantime, and its rate-limited "TTL exceeded" replies aren'
|
|
|
189
196
|
table still shows per-TTL statistics across responders, as `mtr` does.
|
|
190
197
|
|
|
191
198
|
**Webhook** (**Settings → Logging and webhooks**): an `https://` or `http://` address gets a JSON POST when an alert
|
|
192
|
-
raises or clears
|
|
199
|
+
raises or clears: `app`, `event` (`alert` or `clear`), `target`, `target_ip`, `text` and `time`, and for an alert
|
|
200
|
+
`where`, the places on the path worst first, each `{place, hops, delay_added_ms, loss_starts_pct}`. A delivery that fails is a warning in Events naming only the host, never the full address
|
|
193
201
|
(Slack, Teams and ntfy put the secret in the path).
|
|
194
202
|
|
|
195
203
|
## Probe modes
|
|
@@ -251,7 +259,7 @@ pinned run measured something different from a plain one.
|
|
|
251
259
|
Everything PingerPlot measures is kept, with nothing to set up: every probe and the router that answered it,
|
|
252
260
|
per-minute loss, latency and jitter for each hop and router, every event (alerts, reroutes, DNS moves, warnings),
|
|
253
261
|
and which route each target was on, when. It goes into one SQLite database on this computer (see
|
|
254
|
-
[Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
262
|
+
[Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#where-it-keeps-things)), shared by the window and the headless runner.
|
|
255
263
|
|
|
256
264
|
- **Reroutes, not noise.** A hop whose router changes and stays changed for 3 rounds is a reroute: one event that
|
|
257
265
|
names the hops that moved. A hop that takes turns between routers (load balancing over parallel links) is noted
|
|
@@ -322,7 +330,9 @@ problem…** opens a GitHub issue form with the version filled in, which you edi
|
|
|
322
330
|
## Where it keeps things
|
|
323
331
|
|
|
324
332
|
- `%APPDATA%\PingerPlot\` holds `settings.json` (your targets, each with its settings, and the app's options),
|
|
325
|
-
`update.log`,
|
|
333
|
+
`update.log`, `error.log` (errors, and when PingerPlot started and quit; the headless runner's is
|
|
334
|
+
`headless-error.log`), the history in `history\history.sqlite3`, and `lookups.json` (where routers are, kept a
|
|
335
|
+
month).
|
|
326
336
|
On Linux and macOS it's `$XDG_CONFIG_HOME/PingerPlot`, usually `~/.config/PingerPlot`.
|
|
327
337
|
- A portable copy keeps them beside `PingerPlot.exe` instead. Delete `portable.txt` to make it use `%APPDATA%`.
|
|
328
338
|
- On Linux, the menu and sign-in entries are `~/.local/share/applications/pingerplot.desktop` and
|
|
@@ -363,7 +373,7 @@ task at `pingerplot-headless.exe C:\path\to\monitor.json` (or `pythonw.exe -m pi
|
|
|
363
373
|
Besides the status lines, it prints every event as it happens: alerts raised and cleared, route changes, and
|
|
364
374
|
warnings such as a probe log it couldn't open or a webhook that wasn't delivered.
|
|
365
375
|
|
|
366
|
-
It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
376
|
+
It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#history) as the window, so the window shows what it measured. A `recording`
|
|
367
377
|
object in the config changes that: `"recording": {"enabled": false}` turns it off, and `probe_days`,
|
|
368
378
|
`summary_days`, `event_days` and `max_mb` set how much is kept, as in Settings → Recording.
|
|
369
379
|
|
|
@@ -403,7 +413,7 @@ example.net: now vs last-week
|
|
|
403
413
|
**Windows 10 and 11: tested**, and the only platform with a download. The ICMP backend (`icmp.py`) uses the Win32
|
|
404
414
|
IP Helper API, so it needs no admin rights and no capture driver.
|
|
405
415
|
|
|
406
|
-
**Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
416
|
+
**Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) for installing it). **macOS: implemented, untested on a Mac.** Both run
|
|
407
417
|
from source. `icmp_posix.py` uses
|
|
408
418
|
unprivileged `SOCK_DGRAM`/`IPPROTO_ICMP` sockets, the same technique `mtr` uses, and `icmp.ping()` dispatches to it,
|
|
409
419
|
so the engine, window and headless runner don't know which backend answered.
|
|
@@ -473,17 +483,18 @@ session if you want the probes logged.
|
|
|
473
483
|
|
|
474
484
|
| What you see | Fix |
|
|
475
485
|
|---|---|
|
|
486
|
+
| Something went wrong, or PingerPlot quit or stopped recording | `error.log` in the settings folder (above) has the error and when PingerPlot started and quit. Web addresses in it are cut to their host, so it's safe to attach to an issue. |
|
|
476
487
|
| Loss at a hop in the middle | Usually normal: that router rate-limits the replies it generates. Only loss that reaches the destination row is a problem. |
|
|
477
488
|
| "Full TCP/UDP traceroute needs Administrator" | Click **Restart as administrator** beside it (or ⋯ → Restart as administrator), or use ICMP, or TCP with **Destination only**. From source, `launch.ps1 -Elevated`. |
|
|
478
489
|
| "Full TCP/UDP traceroute is Windows-only for now" (Linux, macOS) | Use ICMP, or TCP with **Destination only**. |
|
|
479
|
-
| "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
490
|
+
| "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux)). |
|
|
480
491
|
| A target shows "Cannot resolve" | DNS for that name failed. The window doesn't retry by itself: **⋯ → Start** on its card once the network is up. (The headless runner retries.) |
|
|
481
492
|
| No notification for an alert | **Settings → Show a notification for alerts**, then Windows' *Settings → System → Notifications* for PingerPlot, and Do not disturb. |
|
|
482
|
-
| The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back. |
|
|
493
|
+
| The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back, on Linux too (one copy runs at a time). |
|
|
483
494
|
| "Windows protected your PC" | **More info** should show the publisher, James Cupps, then **Run anyway**. |
|
|
484
495
|
| "The probe log couldn't roll over" in Events | The CSV is open in another program, usually Excel. It keeps appending and tries again a minute later. |
|
|
485
|
-
| The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. |
|
|
486
|
-
| "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
496
|
+
| The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. If the headless runner runs from PingerPlot's folder (a Task Scheduler task), stop it first: Windows won't replace a program that's running, and PingerPlot says so rather than start an update that can't finish. |
|
|
497
|
+
| "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#platform)). |
|
|
487
498
|
|
|
488
499
|
## Uninstalling
|
|
489
500
|
|
|
@@ -541,14 +552,14 @@ failure), then builds the Windows release files, runs the built app's self-test,
|
|
|
541
552
|
the installer, and has a copy update itself to the build. A version tag (`v1.4.0`) builds, tests, signs and
|
|
542
553
|
publishes the release. The release workflow's build job is read-only, only a job that installs nothing holds the
|
|
543
554
|
signing key, and only one that runs nothing but `gh` can publish; every action is pinned by commit SHA and the
|
|
544
|
-
build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
545
|
-
what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
555
|
+
build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CLAUDE.md) has the architecture, the release process and
|
|
556
|
+
what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/ROADMAP.md) what's planned; [CONTRIBUTING.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CONTRIBUTING.md) how to
|
|
546
557
|
help.
|
|
547
558
|
|
|
548
559
|
## License
|
|
549
560
|
|
|
550
|
-
MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
551
|
-
[THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.
|
|
561
|
+
MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE). The libraries inside the Windows build are listed, with their licenses, in
|
|
562
|
+
[THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/THIRD-PARTY-NOTICES.md).
|
|
552
563
|
|
|
553
564
|
PingerPlot is an independent hobby project, not affiliated with or endorsed by any commercial network-monitoring
|
|
554
565
|
product. It is a **read-only diagnostic**: it sends probes and reads replies, and never writes to or reconfigures
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
"""What went wrong, kept: a small log in the settings folder of errors, and of
|
|
2
|
+
when PingerPlot started, quit and restarted.
|
|
3
|
+
|
|
4
|
+
The installed app has no console. An exception in a window callback or a
|
|
5
|
+
background thread was printed to a stderr that doesn't exist, and the
|
|
6
|
+
package's loggers (updates, the tray icon, Start with Windows) wrote to the
|
|
7
|
+
same nowhere, so a copy that quit early or stopped recording left no trace
|
|
8
|
+
(2026-11-18: 25 targets ended half a minute after an update, and nothing
|
|
9
|
+
said why). Everything logged under "pingerplot" now lands here, with each
|
|
10
|
+
uncaught exception's traceback.
|
|
11
|
+
|
|
12
|
+
Run as administrator, PingerPlot writes this file like the history: never
|
|
13
|
+
through a link or junction, which any program running as you could plant
|
|
14
|
+
in the settings folder. A URL is cut to its host: a webhook's secret is its
|
|
15
|
+
path.
|
|
16
|
+
"""
|
|
17
|
+
from __future__ import annotations
|
|
18
|
+
|
|
19
|
+
import logging
|
|
20
|
+
import logging.handlers
|
|
21
|
+
import re
|
|
22
|
+
import sys
|
|
23
|
+
import threading
|
|
24
|
+
import traceback
|
|
25
|
+
from pathlib import Path
|
|
26
|
+
from typing import Optional
|
|
27
|
+
|
|
28
|
+
NAMES = {"gui": "error.log", "headless": "headless-error.log"}
|
|
29
|
+
MAX_BYTES = 256 * 1024 # then one older file, error.log.1
|
|
30
|
+
|
|
31
|
+
log = logging.getLogger("pingerplot")
|
|
32
|
+
|
|
33
|
+
_URL = re.compile(r"(\b[a-z][a-z0-9+.-]*://[^/\s'\"<>]+)[^\s'\"<>]*", re.I)
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
def scrub(text: str) -> str:
|
|
37
|
+
"""``text`` with every URL cut to its scheme and host."""
|
|
38
|
+
return _URL.sub(lambda m: m.group(1) + ("/…" if len(m.group(0)) > len(m.group(1)) else ""), text)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
class _Scrubbed(logging.Formatter):
|
|
42
|
+
def format(self, record: logging.LogRecord) -> str:
|
|
43
|
+
return scrub(super().format(record))
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
class _Handler(logging.handlers.RotatingFileHandler):
|
|
47
|
+
def _open(self):
|
|
48
|
+
from .history import _is_link
|
|
49
|
+
path = Path(self.baseFilename)
|
|
50
|
+
for p in (path.parent, path):
|
|
51
|
+
if _is_link(p):
|
|
52
|
+
raise OSError(f"{p} is a link or junction, and PingerPlot won't write through one")
|
|
53
|
+
return super()._open()
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
_installed: Optional[_Handler] = None
|
|
57
|
+
_previous_hooks = None
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def _default_folder() -> Path:
|
|
61
|
+
from . import settings
|
|
62
|
+
return settings.config_dir()
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
def install(program: str = "gui", folder: Optional[Path] = None) -> Optional[Path]:
|
|
66
|
+
"""Start logging to ``folder`` (the settings folder by default) and catch
|
|
67
|
+
uncaught exceptions on every thread. Returns the log's path, or None when
|
|
68
|
+
it can't be written (a link, a folder that can't be made)."""
|
|
69
|
+
global _installed
|
|
70
|
+
if _installed is not None:
|
|
71
|
+
return Path(_installed.baseFilename)
|
|
72
|
+
path = Path(folder if folder is not None else _default_folder()) / NAMES[program]
|
|
73
|
+
try:
|
|
74
|
+
path.parent.mkdir(parents=True, exist_ok=True)
|
|
75
|
+
handler = _Handler(path, maxBytes=MAX_BYTES, backupCount=1, encoding="utf-8", delay=True)
|
|
76
|
+
except OSError:
|
|
77
|
+
return None
|
|
78
|
+
handler.setFormatter(_Scrubbed("%(asctime)s %(levelname)s %(name)s: %(message)s", "%Y-%m-%d %H:%M:%S"))
|
|
79
|
+
log.addHandler(handler)
|
|
80
|
+
if sys.stderr is not None:
|
|
81
|
+
# Run from a terminal, warnings and tracebacks still show there too
|
|
82
|
+
# (the handler above stops logging's own last-resort printing).
|
|
83
|
+
console = logging.StreamHandler()
|
|
84
|
+
console.setLevel(logging.WARNING)
|
|
85
|
+
console.setFormatter(_Scrubbed("%(levelname)s %(name)s: %(message)s"))
|
|
86
|
+
log.addHandler(console)
|
|
87
|
+
log.setLevel(logging.INFO)
|
|
88
|
+
_installed = handler
|
|
89
|
+
global _previous_hooks
|
|
90
|
+
previous_hook, previous_thread_hook = _previous_hooks = sys.excepthook, threading.excepthook
|
|
91
|
+
|
|
92
|
+
def hook(exc_type, exc, tb):
|
|
93
|
+
if issubclass(exc_type, KeyboardInterrupt):
|
|
94
|
+
previous_hook(exc_type, exc, tb)
|
|
95
|
+
return
|
|
96
|
+
exception("Uncaught", (exc_type, exc, tb))
|
|
97
|
+
if previous_hook is not sys.__excepthook__: # the default would print it twice
|
|
98
|
+
previous_hook(exc_type, exc, tb)
|
|
99
|
+
|
|
100
|
+
def thread_hook(args):
|
|
101
|
+
if args.exc_type is SystemExit:
|
|
102
|
+
return
|
|
103
|
+
name = args.thread.name if args.thread is not None else "?"
|
|
104
|
+
exception(f"Uncaught in thread {name}", (args.exc_type, args.exc_value, args.exc_traceback))
|
|
105
|
+
if previous_thread_hook is not threading.__excepthook__:
|
|
106
|
+
previous_thread_hook(args)
|
|
107
|
+
|
|
108
|
+
sys.excepthook, threading.excepthook = hook, thread_hook
|
|
109
|
+
return path
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
def uninstall() -> None:
|
|
113
|
+
"""Stop logging to the file and put back the exception hooks found (tests)."""
|
|
114
|
+
global _installed, _previous_hooks
|
|
115
|
+
for h in list(log.handlers):
|
|
116
|
+
log.removeHandler(h)
|
|
117
|
+
h.close()
|
|
118
|
+
_installed = None
|
|
119
|
+
if _previous_hooks is not None:
|
|
120
|
+
sys.excepthook, threading.excepthook = _previous_hooks
|
|
121
|
+
_previous_hooks = None
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
def exception(where: str, exc_info) -> None:
|
|
125
|
+
text = "".join(traceback.format_exception(*exc_info)).rstrip()
|
|
126
|
+
log.error("%s:\n%s", where, text)
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def tk_callback(exc_type, exc, tb) -> None:
|
|
130
|
+
"""For ``Tk.report_callback_exception``: Tk's own prints to stderr, which
|
|
131
|
+
the installed app doesn't have."""
|
|
132
|
+
exception("In the window", (exc_type, exc, tb))
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
def note(message: str) -> None:
|
|
136
|
+
"""A line about the app itself: started, quit, restarted."""
|
|
137
|
+
logging.getLogger("pingerplot.app").info(message)
|