--- old/src/hotspot/share/prims/jvmti.xml	2017-09-22 13:33:05.165854275 -0700
+++ new/src/hotspot/share/prims/jvmti.xml	2017-09-22 13:33:04.817855423 -0700
@@ -11640,6 +11640,9 @@
           <description>
             The monitoring rate used for sampling. The sampler will use a statistical approach to
             provide in average sampling every <paramlink id="monitoring_rate"/> allocated bytes.
+
+            Note: a low monitoring rate will incur a higher overhead, therefore, the sampler should
+            only be used when knowing it may impact performance.
           </description>
         </param>
         <param id="max_storage">