better metrics usage, added docs