[ 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)