[
https://issues.apache.org/jira/browse/HBASE-12396?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14192142#comment-14192142
]
Sean Busbey commented on HBASE-12396:
-------------------------------------
We should also document what user-provided data might be included in log
messages (like keys in region ids) so downstream people can reason about the
protection level needed for them.
> Document suggested use of log levels in dev guide
> -------------------------------------------------
>
> Key: HBASE-12396
> URL: https://issues.apache.org/jira/browse/HBASE-12396
> Project: HBase
> Issue Type: Improvement
> Components: documentation
> Reporter: Sean Busbey
> Priority: Minor
>
> Right now we don't provide any guidance on appropriate use of log levels,
> which leads to inconsistent use and in some cases exacerbating problems for
> tests and troubleshooting (see HBASE-12395). We should add a section on
> suggested use of log levels to the guide.
> Some related reading
> * [a good ops-focused blog post on
> levels|http://watchitlater.com/blog/2009/12/logging-guidelines/]
> * [another, focused on
> devs|http://www.codeproject.com/Articles/42354/The-Art-of-Logging]
> * [guidelines from a user on stackoverflow (that I
> like)|http://stackoverflow.com/a/2031209] also has some good discussion.
> * [extended logging discussion with some level use
> guidelines|http://www.javacodegeeks.com/2011/01/10-tips-proper-application-logging.html]
> * [guidelines for Atlassian
> devs|https://developer.atlassian.com/display/CONFDEV/Logging+Guidelines]
> * [guidelines for OpenStack
> devs|https://wiki.openstack.org/wiki/LoggingStandards]
> * [the Kafka dev guide|http://kafka.apache.org/coding-guide.html] has a good
> section on their use titled "Logging"
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)