diff --git a/docs/runtime_options.md b/docs/runtime_options.md
index 9621a694747..9926ee46fee 100644
--- a/docs/runtime_options.md
+++ b/docs/runtime_options.md
@@ -140,6 +140,12 @@ cAdvisor stores the latest historical data in memory. How long of a history it s
 --perf_events_config="" Path to a JSON file containing configuration of perf events to measure. Empty value disables perf events measuring.
 ```
 
+Core perf events can be exposed on Prometheus endpoint per CPU or aggregated by event. It is controlled through `--disable_metrics` parameter with option `percpu`, e.g.:
+- `--disable_metrics="percpu"` - core perf events are aggregated
+- `--disable_metrics=""` - core perf events are exposed per CPU.
+
+Aggregated form of core perf events significantly decrease volume of data.
+
 ### Perf subsystem introduction
 
 One of the goals of kernel perf subsystem is to instrument CPU performance counters that allow to profile applications.