Recordings

Recordings represent every data file recorded by your organization's devices.

Import, delete, and filter recordings from the Recordings page:

Hover over each recording to visualize it using Foxglove panels. Select two or more recordings and choose Compare to open them together in Comparison mode. Use Shift to select a range of adjacent recordings. Open the recording's "Actions" menu to delete it or to download it as an .mcap or .bag file:

Select specific time ranges of data to download from the Timeline page.

Actions

	Definition	CLI command
Import	Import a data recording for a device in your organization	foxglove data import ~/data/bags/gps.bag --device-id dev_drpLqjBZYUzus3gv
Delete	Delete a data recording imported into your organization	N/A
Attach contextual data	Import MCAP files with metadata records	N/A
Attach auxiliary data	Import MCAP files with attachments	N/A
Download	Download a data recording as an MCAP or ROS 1 .bag file	foxglove data export --device-id dev_flm75pLkfzUBX2DH --start 2001-01-01T00:00:00Z --end 2022-01-01T00:00:00Z --output-format mcap0 --topics /gps/fix,/gps/fix_velocity > output.mcap

Deleting a recording

Deleting a recording also removes its data. If the recording is in a session, it no longer appears there after deletion.

If the recording was imported from an Edge Site, only that imported data is removed from Foxglove; the edge copy on the Edge Site is unchanged, and the recording will stay in the table listed as "Not imported". In that case the recording stays in its session, and re-importing restores it there.

For bring your own storage, delete the file in your bucket; Foxglove removes it from the index when the file is gone. If the recording is in a session, it no longer appears there once removed from the index. The Recordings page delete action does not delete those files.

Filtering

Narrow the recordings table on the Recordings page using the Filter button. Click it to open a menu of filter types, choose one to set its value, and it appears as a removable chip. Use the + next to the chips to add more filters. Click a chip to edit its value, or click the chip's × to clear that filter.

The filters available depend on your organization's plan and deployment, and can include:

• Data date range — limit to a rolling window (for example, Last 7 days) or a custom start and end
• Device — restrict to a single device
• Filename — match recordings by file name
• Import status — filter by import state: Not imported, Pending, Importing, Complete, or Failed (deployments with search also include indexing states)
• MCAP Metadata — query the metadata keys and values recorded in each file (see the syntax below)
• Recording ID — match one recording by its exact ID
• Recording key — match recordings whose key contains the text, ignoring case (keys that Foxglove generates on upload never match)
• Session ID — restrict to the recordings in one session, by its exact ID (shown on plans with sessions)
• Site — restrict to a specific primary or edge site (shown when your organization has more than one)

MCAP Metadata syntax

Use the syntax below to filter by metadata keys and values that were in the MCAP metadata records.

	Specific key	Any key
Specific value	weather:rain	*:rain
Any value	weather:*
Multiple values (all required)	weather:rain weather:fog
Multiple values (1+ required)	weather:rain,fog,"mostly sunny"

A single word (e.g. error) will look for matching metadata keys OR values.

Non-alphanumeric characters can be used inside quotes (e.g. "/weather/rain":* or "@my.custom.key":"10%").

Note: Recordings with total MCAP metadata size of > 1 MB do not show up in this search.