more examples, doc, optional unique pid addon to metrics