Skip to content

Logs and diagnostics

Updated

Logs & Diagnostics under System is the first place to look when the host itself is the problem, rather than a machine on it.

The page shows Virtainer Lite’s own log, filterable by level and viewable in local time or UTC. Most questions about what the host did and when are answered here.

If you are already on the host over SSH, the same log is available from the journal:

Terminal window
journalctl -u virtainer-lite -f

Storage devices report their health, including early warning when a disk starts to degrade. Check this after any unexpected reboot, and before you plan a storage change. The Storage page shows the same information alongside the pool.

The Dashboard reports what the host has and what is committed to machines. It is the quickest check when creation fails for reasons that turn out to be simply running out of room.

A diagnostic report bundles the host’s current state for support. Generate it here when you are asked for one.

Errors from the host carry a stable code as well as a message, and a few of them point somewhere other than where they seem to:

What you seeWhere the problem actually is
An upstream service is unavailableThe host’s own outbound network or DNS, not its storage or VM networking
A storage probe failedReading the disks failed. This is different from finding no disks
The operation does not match the current stateThe machine is not in a state that allows the action, such as snapshotting a machine that is not running
A plan is staleThe disks changed after you reviewed the plan. Review again

The console shows the code alongside the message, so quote both when you report a problem.

For machines that came back in an unexpected state after a restart, see After a host reboot.