docs(managing_deis): flesh out platform monitoring docs

closes #981 

I figured linking to the repo was good enough. @johanneswuerbach You ok with that?