freedom.js Anonymized Metrics
freedom.js module for anonymized metric collection.
This module encapuslates the logic presented in RAPPOR, a technique for randomize aggregatable privacy-preserving Ordinal responses.
anonmetrics.jsonas a dependency of your module, using the
Establish the metrics you want to monitor, and instantiate anonmetrics with this definition. The definition format is described in the Metrics Definition section.var metrics = freedom;
Create metrics instances as needed, using the defined name.var metrics = freedom;
Report a metric values at appropriate points.metrics;metrics;
Extract a report of current metric information for use in a report.metrics;
A declarative description of how the anonmetrics module should process reported data for your application is passed to the constructor once throughout the modules making up your application. Other instances can report metrics before this definition is provided, so you don't need to worry about race conditions, but the definition does need to be provided in the lifetime of the module or reports will not be saved - since storage will only record statistics and not raw reported values.
The defintion of metrics follow the following format:
"country":"type": "string""connections":"type": "logarithmic""base": 10
Appropriate for positive integer values where the order of magnitude is interesting.
Appropriate for arbitrary strings, where relative frequencies of known exact values can be compared.
Pull requests are happily taken. Automated tests are designed to enforce correctness and code-quality of the repository.