Required Data: Pipeline Job Hangs

Issue

  • Pipeline job hangs
  • Pipeline job cannot be terminated from the UI

Required Data Pipeline Job Hangs

This article describes how to collect the minimum required information for troubleshooting pipeline jobs hangs issues.

If the required data is bigger than 20 MB you will not be able to use ZenDesk to upload all the information. On this case we would like to encourage you to use our upload service in order to attach all the required information.

Environment

Required Data check list

  • Time around the issue is exposed
  • A support bundle created when the issue is exposed
  • The name of the pipeline job which is in this situation
  • The full build directory in the $JENKINS_HOME of the failed build
  • In the agent side, capture the durable task directory create in the agent (something like /Users/my-user/my-agent/workspace/pipeline-job@tmp)

Time around the issue is exposed

Grab the time around the issue is exposed so it is possible to correlate the build console logs with the Jenkins master logs when the issue is exposed. Ideally, you will be using the Timestamper plugin so the build console logs appear with a timestamp per line.

Support Bundle

A support bundle from the problematic instance ideally when the issue is happening, or in the worst case, right after the issue is exposed. Please, follow the KB below in case you don’t know how to generate a support bundle.

The name of the pipeline job which is in this situation

Take a note with the pipeline build which is hanging. In case there are several pipeline jobs hanging, we suggest that you grab a couple of names.

The full build directory in the $JENKINS_HOME of the failed build

Check the build number which is failing and access to the $JENKINS_HOME to collect the full build directory of the failed build. It is not needed all the build directories.

Durable task at agent side

Access to the agent file system and grab the durable task folder for the hang build. i.e /Users/my-user/my-agent/workspace/pipeline-job@tmp.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.