Diagnose and resolve import errors

When importing robotics recordings into Foxglove, the process may occasionally fail. This is usually due to malformed files. When an import error occurs, a notification appears on the Recordings page under the “Import Errors” section.

If the recording is not identified as malformed, Foxglove will automatically attempt to re-import the file. However, if the file is determined to be malformed or if there have been too many unsuccessful retry attempts, the recording is placed in “quarantine.” At this point, the file is stored, but no further action will be taken.

We have recently introduced two new tools to help you diagnose and resolve import errors. If you encounter a “quarantined” import failure, clicking the triple-dot menu next to the failed entry will reveal two new options: Download and Retry.

• Download: This option allows you to download the input file that failed to import. You can inspect the file for errors using the MCAP CLI by running the mcap doctor command. In some cases, MCAP files can be automatically repaired using the mcap recover subcommand.
• Retry: If the file is not malformed but still failed to import, you can manually trigger another import attempt by selecting Retry.

For additional assistance with importing your recordings into Foxglove, feel free to reach out to us at

support@foxglove.dev. 

For more details and future reference, see the docs.

Availability

These features are accessible to all organizations using Foxglove's cloud storage, we encourage you to explore and take advantage of them.

For enterprise organizations that self-host primary site storage, you’ll need to upgrade your primary site deployment to at least version 0.0.46 to unlock these features. Additionally, ensure your stream service deployment has read access to your inbox bucket. Once these requirements are met, contact us, and we will activate these new tools for your organization.