Tor Metrics Portal: Tools
The metrics website and related websites depend on a collection of services that measure, archive, process, and finally present Tor network data. This page gives an overview of these services.
Tor network data is measured at various places:
- Torperf is a set of utilities for testing Tor performance from a client perspective.
- tor relays and bridges gather aggregate usage statistics and publish descriptors containing data about Tor network structure and usage.
- TorDNSEL is a Tor DNS-based exit list that runs periodic checks whether relays use different IP addresses for exiting to the Internet than they use to register in the Tor network.
- BridgeDB assigns bridges to distributors and gives them out via HTTPS or email.
All Tor network data is downloaded, possibly sanitized, and then archived by a single tool:
- metrics-db contains five components for archiving relay descriptors, bridge descriptors, Torperf results, TorDNSEL exit lists, and BridgeDB pool assignments.
In some cases, processing and presenting Tor network data is separated for maximum flexibility. In particular, there are currently two main tools that process Tor network data and write an intermediate data format, but don't directly present results:
- metrics-web is the software behind this website, including aggregation code that produces statistics files.
- task-6498 is a submodule of metric-web that aggregates data to visualize fast exits in the Tor network.
- task-8462 is another submodule of metric-web that estimates daily users from reported directory request statistics.
- Onionoo provides Tor network status information in JSON format via a RESTful web service.
There are a few websites and additional tools presenting Tor network data:
- metrics-web also contains the code that presents aggregate statistics on this website.
- ExoneraTor is a website that tells you whether a given IP address was a Tor relay.
- Atlas is a web application to discover relays that uses Onionoo as its data back-end.
- Globe is a Tor relay and bridge explorer that also uses Onionoo as its data back-end.
- Compass is a web application that uses Onionoo's data to display information about fast exits in the Tor network.