Problem statement

As an administrator, I want to know where to look at when I have a specific issue.

Examples

• My server is unresponsive, slow, etc.
• I see intermittent connectivity issues, agents get disconnected
• Sometimes authentication does not work, is slow...
• …

Better Information Accessibility

• Write blog entry to make some noise about the plugin(s) and docs in this area?
  • Make troubleshooting-related plugins more well-know (or not?)
    • https://github.com/jenkinsci/support-core-plugin
    • https://github.com/jenkinsci/diagnostics-plugin
    • https://github.com/jenkinsci/monitoring-plugin
    • ...
• Initiate a troubleshooting part under jenkins.io
  • Refactor/move https://wiki.jenkins.io/display/JENKINS/Troubleshooting there
  • There are already some troubleshooting-related parts in the user handbook, but no dedicated “Troubleshooting” AFAWCT.
• Add a new category “troubleshooting” for those plugins? To be presented/selectable through the plugins’ site left menu checkboxes?

(Context: this issue was discussed during the pre-FOSDEM Jenkins meetup that happened on Friday 2nd February 2018, mainly with Dario, fbelzunc & batmat. Originally in that document).