What syncs
- Devices: Every host except those Fleet reports as missing.
- Schedule: every 6 hours, once Asset is selected under the integration’s Sync scopes. Connecting alone doesn’t start it.
- Asset types: Each platform gets a type named after Fleet’s raw platform value, for example Fleet darwin and Fleet windows. Hosts with no platform land under Fleet Other. Linux hosts usually report their distribution, such as
ubuntuorrhel, so they land under types like Fleet ubuntu rather than a single Linux type. A type is only created for platforms present in your inventory.
How devices match people
Each host is matched from the user emails in Fleet’s device mapping for that host. When Fleet reports an identity provider account for the host (themdm_idp_accounts source), only those emails are used. Otherwise every mapped email counts, and a host mapped to more than one person syncs with each of them as an assignee. Devices without a matching user sync unassigned.If your organization has more than one email domain, an email on an alias domain also matches the user with the same address on your primary domain.Set up asset sync
1
Connect Fleet
Follow the Fleet setup guide. Connecting doesn’t start asset sync.
2
Turn on asset sync
In Settings > Integrations, open Fleet, select Configure on the connection, add Asset under Sync scopes, and save. Select Resync to run the first sync now, or wait for the next scheduled run.
Sync scopes is in early access (
integration-sync-capability-toggle) and is on by default. If you don’t see Sync scopes under Configure, it isn’t on for your organization yet, and asset sync can’t be turned on. Contact your Ravenna representative.3
Link the synced asset types
Synced asset types start with no linked workspaces, so their assets only appear in Settings > Organization - Assets. Open each type and select the workspaces that should see it. See Asset types.
4
Map fields (optional)
To choose which Fleet fields land in which asset fields, select Configure Asset Mapping on the connection. Each field Ravenna finds on a sample device is listed under External Field; pick a Ravenna Asset Field of the same type for it, or leave it Not mapped, then save. The list comes from a sample device, so it’s empty until Fleet has at least one device.
Field mapping is in early access (
ASSET_FIELD_MAPPING) and is off by default. If you don’t see Configure Asset Mapping on the connection, it isn’t on for your organization yet. Until it is, each sync adds the source’s fields to the asset type automatically, named after the source fields. Once you save a mapping, only the fields you mapped keep syncing.5
Show assets on tickets
Enable the built-in Assets card to show the requester’s assets in the ticket sidebar.
Learn more about what each sync changes