Add debugging section to api docs

Erik liked the documentation I wrote for pyelasticsearch logging in the
elasticutils docs, so I'm copying it over here.
Merge pull request #56 from willkg/logging-docs

Add debugging section to api docs