Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

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 use the Grafana UI, an open-source data visualization tool, to create and to view charts, graphs, and other visuals to help organize and understand data. You can create dashboards to monitor the status of devices, and you can also query data and view the results from the UI. You can then view error messages, identify issues, and fix the configuration. Grafana UI renders data from Paragon Automation time series database (TSDB). For more information, see Grafana Documentation.

To view logs in the Grafana application:

  1. Use one of the following methods to access Grafana:
    • 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/cluster-logs in the URL field.
    • Use the Logs page: In the Paragon Automation UI, click Monitoring > Logs in the left-nav bar.
  2. Enter the grafana_admin_user username and the grafana_admin_password password that you configured in the config.yml file during installation. The default username is admin.

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

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

  3. Click Home at the top left corner of the page.
  4. Click Paragon Logs to view the logs. If it's not already visible, search for and click Paragon Logs.
  5. (Optional) For instructions on how to create queries, see Query and Transform Data.

See Also