Debugging with Live Logs
By the end of this tutorial you'll know how to access your machine's Live Logs on Chassy, helping you debug efficiently.
Troubleshooting is key for deployed applications. This tutorial shows how to use Chassy's Live Logs to diagnose and resolve issues by accessing, navigating, and interpreting the interface to find root causes.
Prerequisites
Before we start this tutorial, you will need:
An existing Fleet
A connected machine with an application deployed
Accessing the machine
Now that everything is set up, we can find the specific machine that is running the application.
Go to the Fleet section of Chassy Console.
Find the Fleet that the machine belongs to.
Select the machine by clicking on its green box.
You can also click on the Machines tab and search, sort, and filter through all enrolled machines.
Once you find the machine, click on it to open up the side panel with details. If it is currently online, you'll find the option to open Live Logs.
Can't find the Live Logs option? Check that the machine is currently online, and that there is an active deployment
Searching through Live Logs
The Live Logs page shows everything that is being printed from the deployed application, split between the channels stdout and stderr.
You can use the search bar to quickly parse through the lines, as well as toggle word-wrap for better readability.
If you have multiple applications running on the machine, use the dropdown to select the application whose logs you want to view.
Troubleshooting
Why can't I find the Live Logs button?
Live Logs will only appear if the machine is online, has an operating system running the Chassy agent, and currently has an active application deployed.
The Chassy agent is only available on Linux, Windows, and NixOS.
How do I know which machine I deployed to?
To find the machine, go to the Machine tab on your Fleet panel. You'll be able to see all active deployments on each machine, and can also filter the list by the application deployed.
Why does it say I'm disconnected?
There is a 10 minute limit imposed to avoid streaming data indefinitely. Simply click on the Connect button on the top right, and you'll be able to read all logs.
Conclusion
In this tutorial, we've walked through the process of accessing and utilizing Chassy's Live Logs feature. You now know how to view stdout and stderr, filter information, and troubleshoot issues to diagnose and resolve problems in your deployed applications. This tool offers valuable real-time insight, helping you maintain healthy and reliable deployments.
Last updated