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

Reply via email to