A tool to monitor results collected by RIPE Atlas probes and verify they match against predefined expected values.
Project description
RIPE Atlas Monitor
A Python tool to monitor results collected by RIPE Atlas probes and verify they match against predefined expected values.
How does it work?
On the basis of a RIPE Atlas measurement previously created, you define a monitor by declaring which results you expect that probes should produce: rules are used to map probes and their expected results. Depending on whether the collected results match the expectations, custom actions are performed: to log the result, to send an email, a syslog message or to run an external program.
descr: Check network reachability
matching_rules:
- descr: Probes from France via AS64496
src_country: FR
expected_results: ViaAS64496
actions: EMailToNOC
- descr: RTT from AS64499 and AS64500 below 50ms
src_as:
- 64499
- 64500
expected_results: LowRTT
actions: EMailToNOC
expected_results:
ViaAS64496:
upstream_as: 64496
LowRTT:
rtt: 50
actions:
EMailToNOC:
kind: email
to_addr: noc@agreatcompany.org
subject: "ripe-atlas-monitor: unexpected results"
measurement-id: 123456789
Full documentation
A quick start guide, commands references, monitors’ configuration, syntax and everything else can be found on ReadTheDocs: https://ripe-atlas-monitor.readthedocs.org/
Status
This tool is currently in beta: some field tests have been done but it needs to be tested deeply and on more scenarios.
Moreover, contributions (fixes to code and to grammatical errors, typos, new features) are very much appreciated. More details on the contributing guide.
Bug? Issues?
But also suggestions? New ideas?
Please create an issue on GitHub at https://github.com/pierky/ripe-atlas-monitor/issues
Changelog
0.1.6
improvements
new checks and analysis for EDNS NSID option
DNS answers analysis
probes filter for run and analyze commands now accepts probe IDs and country codes
0.1.5
improvements
more options for the analyze command: - show probes (up to 3) beside results - destination AS and upstream AS results - show common sequences/patterns among results
add --probes argument to run and analyze commands to filter results
email logging of error messages
fixes
fix empty resultset handling in analyze cmd
0.1.4
new features
Python 3.4 support
improvements
-m argument for analyze command, to gather msm id and auth key from the monitor itself
--dont-wait argument for run command
fixes
herror handling for null RTT results in analyze command
0.1.3
improvements
better RTT results formatting in analyze command
no stdout logging when used in daemonize mode
fixes
error handling for IXPs networks info unavailability
0.1.2
new features
analyze command to show elaborated results from a measurement
bash autocomplete
fixes
continous monitors didn’t run continously
0.1.1
improvements
better results and actions logging
0.1.0
First release (beta)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.