How to collect logs and support bundle? [Video]

Yonatan Brand
2021-01-28 09:04

How to generate the support bundle in Artifactory

Video Transcription

Hi, my name is Jonathan Bond and I’m from the JFrog support team. In this short video, I will show you how to collect logs or support bundles and send them to the support team for further analysis. Let’s start.

As you can see, I got Artifactory already open up here. So, what we need to do in order to create the support bundle is to go to the right tab here, called Administration, and scroll all the way down to the Support Zone. In the Support Zone, we will be able to create the support bundle. On the right.

And now, what we need to do is just provide a meaningful name for the bundle. For me it’s just a test, of course. Later, you can select which services you want to include part of the support bundle. For now we have only Artifactory, as this is a small environment, but if you have other products such as Xray, Mission Control and Distribution, we’ll be able to list them over here as well.

Later, we can select the content of the support bundle. We can either put the Configuration files, System Info and Logs, or if we want to reduce the size of the support bundle, we can just tick or untick the relevant parts here. And then we can select the date span of the support bundle. For now, we’ll just take the last 24 hours, and we can set the interval and thread dumps. For now, we’ll just use it as it is. Click OK to create it. Now, as you can see, we have a support bundle created, and what we can do is download it to our local machine so we can later send it to the support team. We’ll go ahead and save it.

Let’s open the ZIP and let’s see what we have inside. Inside the ZIP, we have all the microservices that are running within our Artifactory. Inside each of these folders, there’s an independency file that includes the configuration files for the service, the logs and the system information.

So, after we learned how to create a release bundle, and we learned a little bit about the content, let’s go ahead and see how we can send all this information to the support team to further analyze. For that, you need to remember you’ll need to obtain the case number that you opened for this issue, and second is the following cal command. This cal command will help you send the information to our support team. All you need to do is change two fields. First field is the file name of the support bundle. The second field is the case number that you have opened. After applying these changes, press Enter, and support team will get the information. There is no need to update the support that you have sent the logs. We will get an alert for that. In case the UI is not available for you, and there’s no way to generate a support bundle, go ahead to the Artifactory file system, navigate to the logs directory, gather all the logs into one ZIP file and send them using the simple cal command you can see here. It’s that easy.

Well, that was my video on how to collect logs and support bundle and to send to support. Thanks for watching, and I hope you enjoyed. Feel free to leave your comments, feedback, or questions in the comments sections below.