aboutsummaryrefslogtreecommitdiff
path: root/src/lib/metrics/lib_metrics.md
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/metrics/lib_metrics.md')
-rw-r--r--src/lib/metrics/lib_metrics.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/src/lib/metrics/lib_metrics.md b/src/lib/metrics/lib_metrics.md
new file mode 100644
index 0000000000..e58680e237
--- /dev/null
+++ b/src/lib/metrics/lib_metrics.md
@@ -0,0 +1,12 @@
+@dir /lib/metrics
+@brief lib/metrics: Metrics collection API
+
+This module is used for adding "metrics" support to Tor.
+
+Metrics are a collection of counters that are defined per-subsystem and
+accessed through the MetricsPort. Each subsystem is responsible for populating
+metrics store(s) and providing access to them through the `.get_metrics()`
+call located in the `subsys_fns_t` object.
+
+These metrics are meant to be extremely lightweight and thus can be accessed
+without too much CPU cost.