Device fields

Serverless Stack

Fields that describe a device instance and its characteristics. Data collected for applications and processes running on a (mobile) device can be enriched with these fields to describe the identity, type and other characteristics of the device.

This field group definition is based on the Device namespace of the OpenTelemetry Semantic Conventions (https://opentelemetry.io/docs/reference/specification/resource/semantic_conventions/device/).

Field	Description	Level
device.id	The unique identifier of a device. The identifier must not change across application sessions but stay fixed for an instance of a (mobile) device. On iOS, this value must be equal to the vendor identifier (https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). On Android, this value must be equal to the Firebase Installation ID or a globally unique UUID which is persisted across sessions in your application. For GDPR and data protection law reasons this identifier should not carry information that would allow to identify a user. type: keyword example: 00000000-54b3-e7c7-0000-000046bffd97 device.id	extended
device.manufacturer	The vendor name of the device manufacturer. type: keyword example: Samsung device.manufacturer	extended
device.model.identifier	The machine readable identifier of the device model. type: keyword example: SM-G920F device.model.identifier	extended
device.model.name	The human readable marketing name of the device model. type: keyword example: Samsung Galaxy S6 device.model.name	extended
device.product.id	This field is beta and subject to change. A unique identifier assigned by the vendor to distinguish different product models. This is typically a hexadecimal value that, combined with the vendor ID, creates a globally unique device identifier. The product ID is assigned by the device manufacturer and should remain consistent across all instances of the same product model. For hardware devices, this often corresponds to the Product ID (PID) in device descriptors. See https://learn.microsoft.com/en-us/windows-hardware/drivers/install/standard-usb-identifiers for more details on product identification standards. type: keyword example: 43981	extended
device.product.name	This field is beta and subject to change. The human-readable marketing or commercial name of the device as designated by the manufacturer. This name is typically found in product documentation, marketing materials, or device packaging. Unlike the product.id which is a technical identifier, this field contains the consumer-facing product name that would be recognizable to end users. The name should be exactly as provided by the manufacturer and may include model numbers, series designations, or other identifying information. type: keyword example: Extreme V2 SSD	extended
device.serial_number	This field is beta and subject to change. The unique serial number serves as a distinct identifier for each device, aiding in inventory management and device authentication. type: keyword example: DJGAQS4CW5	core
device.type	This field is beta and subject to change. A classification of the device based on its primary function or device class. This field categorizes devices into functional groups to enable policy enforcement and monitoring based on device capabilities. The classification should follow standard device class definitions where possible, such as "Storage Device", "Human Interface Device", "Audio", "Video", "Network", "Communication", etc. This allows for consistent categorization across different device types and manufacturers. See https://www.usb.org/defined-class-codes for standard device class definitions. type: keyword example: Storage Device	extended
device.vendor.id	This field is beta and subject to change. A unique identifier assigned to device manufacturers by standards organizations. This is typically a hexadecimal value that uniquely identifies the vendor/manufacturer of the device. The vendor ID is assigned by standards bodies and remains consistent across all products from the same manufacturer. For hardware devices, this often corresponds to the Vendor ID (VID) in device descriptors. This identifier enables tracking and policy enforcement at the manufacturer level. See https://learn.microsoft.com/en-us/windows-hardware/drivers/install/standard-usb-identifiers for more information on vendor identification standards. type: keyword example: 4660	extended
device.vendor.name	This field is beta and subject to change. The name of the organization or company that manufactured or produced the device. This should be the official registered business name or commonly recognized brand name of the manufacturer. The vendor name provides human-readable identification of the device manufacturer and should be consistent with the vendor.id field. This field is useful for reporting, device inventory management, and applying vendor-specific policies or security rules. type: keyword example: SanDisk	extended