add note on sampling

[lucashuet93]

Purpose

• add note on sampling and how to update the value

Does this introduce a breaking change?

[ ] Yes
[x] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[x] Documentation content changes
[ ] Other... Please describe:

[stuartleeks]

LGTM

Is it worth adding an issue for updating capabilities to emit metrics and use those for verification in the end-to-end tests?

[lucashuet93]

@stuartleeks created!