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 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
- Issue
- General connection failures or task execution errors occur within the application.
- Solution
- Access logs: Click the Troubleshooting icon in the status bar, and select the Logs tab to view real-time internal events.
- 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.
1.2. Unresponsive container engine or disconnected UI socket Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
- Issue
- The container engine is unresponsive or the UI is disconnected from the engine socket.
- Solution
- Verify connectivity: Navigate to the Repair & Connections tab on the Troubleshooting page, and click Ping to check engine responsiveness.
- Reset connections: Click Reconnect Providers on the same page to refresh the connection to the container engine socket.
- Check container status: Use the Check containers button to verify the response time and availability of all existing containers.
1.3. Fix UI synchronization issues and missing resources Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
- Issue
- UI synchronization issues, such as missing containers or images that should be visible.
- Solution
- Inspect Stores: Open the Stores tab in the Troubleshooting section, and click the link for the relevant component, such as containers or images.
- Force refresh: Compare the store count with the UI; if they differ, click Refresh to manually synchronize the data from the back-end.
- Clear history: If the event log is cluttered, click Clear to remove historical data and allow the store to capture fresh events.