This article answers the following question: What information should I collect to assist in troubleshooting prior to opening a Service Request (case)?

For troubleshooting a Contrail case, the Data Collection Checklist - Logs/data to collect for troubleshooting is as follows:

1. Contrail Version

   Run the following command on any of the Contrail nodes:

   #docker ps​

   Note: contrail-version is required instead of docker ps for older, non-container Contrail versions.

2. Openstack/Docker/Kubernetes/VMware SKU

   Specify the Cloud orchestrator. 

3. Contrail Logs

   All the Contrail logs are located under the  /var/log/contrail/ or the /var/log/containers/contrail/ directories depending on implementation.

   Tar the directory:

   # tar -zcf contrail-logs.tgz /var/log/contrail/*
or
# tar -zcf contrail-logs.tgz /var/log/containers/contrail/*

    Please upload the tar file to the JTAC case.

   Note: For Contrail Controller related issues, collect logs from all Contrail Controller nodes.

4. Contrail Process Status

   Run the following command on any Contrail node to find all the Contrail process statuses running on that node:

   #contrail-status -d

5. Type of Deployment

   Provide a brief idea about the type of deployment, for example:

   • Contrail Cloud or Contrail Networking

   • Number of Contrail Controller nodes, Compute nodes, Openstack Controller nodes and so on

Additional Resources

• KB31144 - Contrail Getting Started - Administration, Configuration & Troubleshooting (JumpStation) [juniper.net]

• KB30909 - [Contrail] Description of Contrail processes and their roles [juniper.net]

2023-03-31: Fixed formatting.
2020-12-11: Step 1 modified to include instructions for older, non-container versions
2018-11-01: Minor non-technical edits