Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Use Log Files to Debug Issues

These topics provide instructions for debugging issues by reviewing log files.

Debug Deployment Script Failure

Problem

The deployment script fails.

Solution

If the deployment script fails, you must check the installation log files in the config-dir directory. By default, the config-dir directory stores six zipped log files. The current log file is saved as log, and the previous log files are saved as log.1 through log.5. Every time you run the deployment script (deploy), the current log is saved, and the oldest one is discarded.

You typically find error messages at the end of a log file. View the error message, and fix the configuration.

Debug Installation-Related Issues

Problem

You cannot identify installation-related issues.

Solution

You can use the Kibana application, a visualization tool, to search logs by using keywords and filters. You can then view error messages, identify issues, and fix the configuration.

To view logs in the Kibana application:

  1. Use one of the following methods to access Kibana:
    • Use the virtual IP (VIP) address of the ingress controller: Open a browser and enter https://vip-of-ingress-controller-or-hostname-of-main-web-application/kibana in the URL field.
    • Use the Logs page: In the Paragon Automation UI, click Monitoring > Logs in the left-nav bar.
  2. Enter the opendistro_es_admin_user username and the opendistro_es_admin_password password that you configured in the config.yml file during installation. The default username is admin.

    If you do not configure the opendistro_es_admin_password password, the installer generates a random password. You can retrieve the password using the following command:

    # kubectl -n kube-system get secret opendistro-es-account -o jsonpath={..password} | base64 -d

  3. If you are logging in for the first time, create an index pattern by clicking the Create index pattern option.
  4. Enter logstash-* in the Index pattern name field, and then click Next Step >.
  5. Select @timestamp from the Time field list, and then click Create index pattern to create an index pattern.
  6. Click the hamburger icon. Select Discover from the left-nav bar to browse the log files and to add or remove filters as required.