[ 
https://issues.apache.org/jira/browse/CASSANDRA-14553?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16621437#comment-16621437
 ] 

Joseph Lynch commented on CASSANDRA-14553:
------------------------------------------

[~rustyrazorblade] sure that would be awesome. I rebased the patch and pushed 
to my github on the {{jolynch_write_troubleshooting}} branch (also attached on 
this ticket for convenience) 
[^0001-Add-basic-troubleshooting-documentation.patch] , re-ran {{docker-compose 
run build-docs}} to check for compilation errors (I didn't see any related to 
the troubleshooting docs), and did another read-through to check links. I think 
it should be g2g.

Please let me know if there are any follow up sections or anything that's 
unclear, I think this is better than a TODO section but we can of course keep 
improving it.

> Document troubleshooting page
> -----------------------------
>
>                 Key: CASSANDRA-14553
>                 URL: https://issues.apache.org/jira/browse/CASSANDRA-14553
>             Project: Cassandra
>          Issue Type: Improvement
>          Components: Documentation and Website
>            Reporter: Joseph Lynch
>            Assignee: Joseph Lynch
>            Priority: Minor
>              Labels: Documentation
>         Attachments: 0001-Add-basic-troubleshooting-documentation.patch
>
>
> Currently the [troubleshooting 
> docs|http://cassandra.apache.org/doc/latest/troubleshooting/] are blank. As 
> much as I like to believe Cassandra never has any problems I was thinking of 
> writing up a troubleshooting page focussing on:
>  # Finding the hosts(s) that are behaving badly (common error messages)
>  # Which logs exist, where they are, and what to look for in which log 
> (common error messages, gc logs, etc)
>  # Which nodetool commands can give you more information
>  # Java/Operating systems tools that can help dive deep into performance 
> issues (jstat, top, iostat, cachestat, etc) 
> Since this is going to be a fairly lengthy page I wanted to get a jira going 
> in case someone else had ideas or had already started. Also if there are any 
> large areas I missed above please comment here and I can include them.
> [~cscotta] fyi



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org

Reply via email to