Forklift must-gather is a diagnostic collection tool that extends OpenShift must-gather to capture Forklift-specific resources and logs.
The tool addresses the challenge of gathering relevant diagnostic data from Forklift deployments by collecting logs and custom resources in a structured format. It works by hooking into the OpenShift must-gather framework and filtering for Forklift-related artifacts, allowing operators to obtain a complete snapshot of the Forklift system state for troubleshooting and analysis.
Adoption makes sense for teams running Forklift migrations who need to diagnose issues or collect data for support. The tool is particularly valuable when dealing with long-running operations where only recent logs matter, as it supports time-based filtering to reduce data volume. Targeted gathering by namespace, migration plan, or virtual machine name allows operators to focus collection on specific resources rather than capturing everything, which saves time and storage when investigating particular migration failures. The tool can output results as an unpacked directory tree for direct inspection or as a compressed tarball for faster transmission to support systems.
The project maintains active development with regular commits addressing bug fixes and feature enhancements. Pull requests receive timely review and integration, indicating responsive maintenance. The codebase shows consistent attention to user-reported issues and incorporates feedback into updates.
