document var_metric usage to prevent bugreports that are actually configuration issues