update documentation, alarm logic and stats collection logic