docs/metrics: use underline-style heading markup

For consistency with the other docs. This also corrects the heading
levels, since level two was skipped.

Change-Id: Iab010cfca68af7d376944b0e8b2b8c076e33fbde