Monitoring and Debugging

Modified on Tue, 4 Jun at 1:17 PM

A system can only be expected to be stable while monitoring and troubleshooting will be performed regularly. This article explains the simple administration.


TABLE OF CONTENTS



Log Management

If you install the cluster via the provided installer, logs can be found on the host machine at:

  • /var/log/pods or /var/log/containers → for the individual pods/containers
  • /var/log/apiserver → for the Kubernetes API server

The application logs are ephemeral and connected with each application's lifecycle. If the application is restarted, then its log will disappear. 



Troubleshooting

The Labforward support team can assist with support bundles. A support bundle being a compressed folder with relevant files intended to help investigate cluster issues, such as, but not limited to:

  • Application logs
  • Replicated configurations
  • Cluster metadata
  • Kubernetes manifests

The admin can create the Support Bundle bundle at any moment and attach it to a support request.



Create Support Bundle

  1. Open the admin console.
  2. Create support bundle by clicking:
    1. Troubleshooting
    2. Support Bundles
    3. Generate a support bundle.
  3. Click on Download bundle to get the compressed file.
  4. Attach the tar.gz to the Labforward support request.


Note: The support bundle will be created based on Replicated's configuration.



Host Support Bundle


In some situations, investigating some host details might be required, such as if the admin console is offline. In this scenario, use the Host Support Bundle, which is independent of Kubernetes.


To install it, run:


curl -L https://github.com/replicatedhq/troubleshoot/releases/latest/download/support-bundle_linux_amd64.tar.gz  | tar xzvf -

Then, run the following command to generate a tar file including information about the host:


./support-bundle --load-cluster-specs https://raw.githubusercontent.com/replicatedhq/troubleshoot-specs/main/in-cluster/default.yaml https://raw.githubusercontent.com/replicatedhq/troubleshoot-specs/main/host/default.yaml

The command above will collect data from the cluster and host. If it fails, the cluster is likely offline. In this case, collect the support bundle only for the host with the command:


./support-bundle https://raw.githubusercontent.com/replicatedhq/troubleshoot-specs/main/host/default.yaml



Press (q) or (s) to exit in the result screen. Then, send Labforward the generated file with the name support-bundle-{current-date}.tar.gz.



Redactors - Data Security

Multiple redactors review all data inside the support bundles. They will hide sensitive information, such as IPs, secrets, and passwords, preventing them from leaving the customer's domain. For more details, check this replicated documentation.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article