Chapter 1. Troubleshoot task and connection issues through UI


If you encounter connection issues or execution errors, use the built-in troubleshooting tools to view logs, verify connections, and manage data stores.

1.1. Connection failures or task execution errors

Issue
General connection failures or task execution errors occur within the application.
Solution
  1. Access logs: Click the Troubleshooting icon in the status bar, and select the Logs tab to view real-time internal events.
  2. Export diagnostics: If the issue persists, go to the Gather Logs tab and click Collect and save logs as .zip to generate a log package for support analysis.
Issue
The container engine is unresponsive or the UI is disconnected from the engine socket.
Solution
  1. Verify connectivity: Navigate to the Repair & Connections tab on the Troubleshooting page, and click Ping to check engine responsiveness.
  2. Reset connections: Click Reconnect Providers on the same page to refresh the connection to the container engine socket.
  3. Check container status: Use the Check containers button to verify the response time and availability of all existing containers.
Issue
UI synchronization issues, such as missing containers or images that should be visible.
Solution
  1. Inspect Stores: Open the Stores tab in the Troubleshooting section, and click the link for the relevant component, such as containers or images.
  2. Force refresh: Compare the store count with the UI; if they differ, click Refresh to manually synchronize the data from the back-end.
  3. Clear history: If the event log is cluttered, click Clear to remove historical data and allow the store to capture fresh events.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top