Add fixes for plugin review.

These fixes include:
 - alphabetical module import order.
 - rename register_plugin to should_register_plugin.
 - removing unused log() method.
 - updating docstrings with parameter and return value units.
 - update collectd.info to collectd.warning when this is more appropriate.
 - add logging for error cases.
 - clarify comments and docstrings.