Skip to content

🛠️ Troubleshooting Guide

This troubleshooting guide provides solutions to common issues encountered while using the k8s-tools suite, including both k8s-analyzer and k8s-reporter.

General Issues

Installation Problems

  • Problem: Installation fails with permission errors.
  • Solution: Ensure you have the necessary permissions to install software. Try running the installation command with sudo.

Network Connectivity

  • Problem: Unable to connect to the cluster API.
  • Solution: Verify your kubeconfig file and ensure the correct context is set. Check network policies and firewall settings.

k8s-analyzer Specific Issues

Analysis Errors

  • Problem: Analysis fails with "Resource not found" errors.
  • Solution: Verify the existence of resources and check your access permissions. Refresh the resource cache.

Report Generation

  • Problem: Report generation fails or output is empty.
  • Solution: Ensure that the analysis phase completed successfully. Verify that the output directory is writable.

k8s-reporter Specific Issues

Dashboard Not Loading

  • Problem: The dashboard doesn't load in the browser.
  • Solution: Confirm that the service is running. Check the server logs for errors. Verify network and firewall settings.

Authentication Failures

  • Problem: Cannot log in to the dashboard with provided credentials.
  • Solution: Check the authentication settings in your configuration file. Reset credentials if necessary.

Logs and Monitoring

Accessing Logs

  • Problem: Difficulty accessing logs for debugging.
  • Solution: Ensure logging is enabled and logs are being written to the correct location. Use kubectl logs for pod logs.

Performance Monitoring

  • Problem: Performance degradation over time.
  • Solution: Monitor resource usage and optimize configurations. Consider scaling resources or using more powerful nodes.

Common Commands

  • Restart dashboard service: systemctl restart k8s-reporter
  • Check service status: systemctl status k8s-reporter
  • View logs: tail -f /var/log/k8s-tools.log

References

Support

  • For further assistance, refer to the official documentation or reach out to the community forums and support channels.