FailingConnectionOnly - is of course the connection which has the error, IdleConnections are all idle connections and the failing connection, EntirePool are all connections including active one.
So FailingconnectionOnly or IdleConnections I would say - be very careful with EntirePool.
And yes, I should add some documentation for it - or hopefully there will be a pull request ;)