REST Resource: customers.telemetry.devices

منبع: TelemetryDevice

داده‌های تله‌متری جمع‌آوری‌شده از یک دستگاه مدیریت‌شده.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_DEVICE
نمایش JSON 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
فیلدها
name

string

فقط خروجی. نام منبع دستگاه.

customer

string

فقط خروجی. مشتری Google Workspace که شرکتش دستگاه را ثبت کرده است.

orgUnitId

string

فقط خروجی. شناسه واحد سازمانی دستگاه.

deviceId

string

فقط خروجی. شناسه API دایرکتوری منحصر به فرد دستگاه. این مقدار همان شناسه API دایرکتوری کنسول مدیریت در تب دستگاه‌های ChromeOS است.

serialNumber

string

فقط خروجی. شماره سریال دستگاه. این مقدار همان شماره سریال کنسول مدیریت در تب دستگاه‌های ChromeOS است.

cpuInfo[]

object ( CpuInfo )

فقط خروجی. اطلاعات مربوط به مشخصات CPU دستگاه.

cpuStatusReport[]

object ( CpuStatusReport )

فقط خروجی. گزارش‌های وضعیت CPU که به صورت دوره‌ای جمع‌آوری می‌شوند، به ترتیب نزولی reportTime مرتب شده‌اند.

memoryInfo

object ( MemoryInfo )

فقط خروجی. اطلاعات مربوط به مشخصات حافظه دستگاه.

memoryStatusReport[]

object ( MemoryStatusReport )

فقط خروجی. گزارش‌های وضعیت حافظه که به صورت دوره‌ای جمع‌آوری می‌شوند، بر اساس reportTime مرتب‌سازی می‌شوند.

networkInfo

object ( NetworkInfo )

فقط خروجی. اطلاعات دستگاه‌های شبکه.

networkStatusReport[]

object ( NetworkStatusReport )

فقط خروجی. مشخصات شبکه به صورت دوره‌ای جمع‌آوری می‌شود.

networkDiagnosticsReport[]

object ( NetworkDiagnosticsReport )

فقط خروجی. عیب‌یابی شبکه به صورت دوره‌ای جمع‌آوری می‌شود.

osUpdateStatus[]

object ( OsUpdateStatus )

فقط خروجی. حاوی اطلاعات مرتبط با وضعیت به‌روزرسانی ChromeOS است.

graphicsInfo

object ( GraphicsInfo )

فقط خروجی. حاوی اطلاعاتی در مورد لوازم جانبی گرافیکی برای دستگاه است.

graphicsStatusReport[]

object ( GraphicsStatusReport )

فقط خروجی. گزارش‌های گرافیکی به صورت دوره‌ای جمع‌آوری می‌شوند.

batteryInfo[]

object ( BatteryInfo )

فقط خروجی. اطلاعات مربوط به مشخصات باتری دستگاه.

batteryStatusReport[]

object ( BatteryStatusReport )

فقط خروجی. گزارش‌های باتری به صورت دوره‌ای جمع‌آوری می‌شوند.

storageInfo

object ( StorageInfo )

فقط خروجی. اطلاعات مشخصات ذخیره‌سازی دستگاه.

storageStatusReport[]

object ( StorageStatusReport )

فقط خروجی. گزارش‌های ذخیره‌سازی به صورت دوره‌ای جمع‌آوری می‌شوند.

thunderboltInfo[]

object ( ThunderboltInfo )

فقط خروجی. اطلاعات مربوط به گذرگاه تاندربولت.

audioStatusReport[]

object ( AudioStatusReport )

فقط خروجی. گزارش‌های صوتی که به صورت دوره‌ای جمع‌آوری می‌شوند، به ترتیب نزولی reportTime مرتب شده‌اند.

bootPerformanceReport[]

object ( BootPerformanceReport )

فقط خروجی. گزارش‌های عملکرد بوت دستگاه.

heartbeatStatusReport[]

object ( HeartbeatStatusReport )

فقط خروجی. گزارش وضعیت ضربان قلب حاوی مهرهای زمانی که به صورت دوره‌ای به ترتیب نزولی از reportTime مرتب شده‌اند

kioskAppStatusReport[]

object ( KioskAppStatusReport )

فقط خروجی. گزارش وضعیت برنامه کیوسک برای دستگاه کیوسک

networkBandwidthReport[]

object ( NetworkBandwidthReport )

فقط خروجی. گزارش‌های پهنای باند شبکه که به صورت دوره‌ای جمع‌آوری می‌شوند، به ترتیب نزولی reportTime مرتب شده‌اند.

peripheralsReport[]

object ( PeripheralsReport )

فقط خروجی. گزارش‌های لوازم جانبی که به صورت دوره‌ای جمع‌آوری می‌شوند، به ترتیب نزولی reportTime مرتب شده‌اند.

appReport[]

object ( AppReport )

فقط خروجی. گزارش‌های برنامه که به صورت دوره‌ای جمع‌آوری می‌شوند، به ترتیب نزولی reportTime مرتب شده‌اند.

runtimeCountersReport[]

object ( RuntimeCountersReport )

فقط خروجی. شمارنده‌های زمان اجرا، زمان اجرای جمع‌آوری‌شده‌ی طول عمر دستگاه و همچنین تعداد انتقال‌های S0->S3، S0->S4 و S0->S5، به معنی ورود به حالت‌های خواب، هایبرنیت و خاموشی را گزارش می‌دهند.

اطلاعات پردازنده

مشخصات پردازنده دستگاه

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceCpuInfo کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_CPU_INFO
نمایش JSON 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
فیلدها
model

string

فقط خروجی. نام مدل CPU. مثال: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz

architecture

enum ( Architecture )

فقط خروجی. نوع معماری برای CPU.

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceCpuInfo کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
maxClockSpeed

integer

فقط خروجی. حداکثر سرعت کلاک پردازنده بر حسب کیلوهرتز.

keylockerSupported

boolean

فقط خروجی. اینکه آیا از قفل کلید پشتیبانی می‌شود یا خیر.

keylockerConfigured

boolean

فقط خروجی. اینکه آیا keylocker پیکربندی شده است یا خیر. TRUE = فعال؛ FALSE = غیرفعال. فقط در صورتی گزارش می‌شود که keylockerSupported = TRUE .

معماری

نوع معماری برای پردازنده مرکزی (CPU).

انوم‌ها
ARCHITECTURE_UNSPECIFIED معماری ناشناخته.
X64 معماری x64

گزارش وضعیت پردازنده

اطلاعاتی در مورد وضعیت CPU ارائه می‌دهد.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceCpuInfo کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: هر 10 دقیقه
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_CPU_REPORT
نمایش JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. مهر زمانی بر حسب میلی‌ثانیه که نشان دهنده زمانی است که این گزارش نمونه‌برداری شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

sampleFrequency

string ( Duration format)

فقط خروجی. تعداد دفعاتی که گزارش نمونه‌برداری می‌شود.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

cpuUtilizationPct

integer

فقط خروجی. نمونه‌ای از میزان استفاده از پردازنده (۰ تا ۱۰۰ درصد).

cpuTemperatureInfo[]

object ( CpuTemperatureInfo )

فقط خروجی. اطلاعات نمونه دمای CPU به ازای هر هسته CPU بر حسب سانتیگراد

اطلاعات دمای پردازنده

دمای CPU یک دستگاه. نمونه‌برداری شده برای هر هسته CPU بر حسب سانتیگراد.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceCpuInfo کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: هر 10 دقیقه
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
نمایش JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
فیلدها
temperatureCelsius

integer

فقط خروجی. دمای CPU بر حسب سانتیگراد.

label

string

فقط خروجی. برچسب CPU. مثال: هسته 0

اطلاعات حافظه

اطلاعات حافظه یک دستگاه.

  • این فیلد شامل اطلاعات تله‌متری و دستگاه است:
    • totalRamBytes - اطلاعات دستگاه
    • availableRamBytes - اطلاعات تله‌متری
    • totalMemoryEncryption - اطلاعات دستگاه
  • داده‌های این فیلد از طریق سیاست ReportDeviceMemoryInfo کنترل می‌شوند.
  • فراوانی جمع‌آوری داده‌ها:
    • totalRamBytes - فقط در زمان آپلود
    • availableRamBytes - هر 10 دقیقه
    • totalMemoryEncryption - در هنگام راه‌اندازی دستگاه
  • فرکانس گزارش پیش‌فرض داده‌ها:
    • totalRamBytes - ۳ ساعت
    • availableRamBytes - ۳ ساعت
    • totalMemoryEncryption - در هنگام راه‌اندازی دستگاه
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: فقط برای totalMemoryEncryption
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_MEMORY_INFO
نمایش JSON 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
فیلدها
totalRamBytes

string ( int64 format)

فقط خروجی. کل رم به بایت.

availableRamBytes

string ( int64 format)

فقط خروجی. مقدار رم موجود بر حسب بایت.

totalMemoryEncryption

object ( TotalMemoryEncryptionInfo )

فقط خروجی. اطلاعات کامل رمزگذاری حافظه برای دستگاه.

اطلاعات رمزگذاری کامل حافظه

اطلاعات رمزگذاری حافظه یک دستگاه.

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceMemoryInfo کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: هنگام راه‌اندازی دستگاه
  • فرکانس پیش‌فرض گزارش داده‌ها: هنگام راه‌اندازی دستگاه
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش خواهند شد: بله
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
نمایش JSON 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
فیلدها
encryptionState

enum ( MemoryEncryptionState )

وضعیت رمزگذاری حافظه در دستگاه.

maxKeys

string ( int64 format)

حداکثر تعداد کلیدهایی که می‌توان برای رمزگذاری استفاده کرد.

keyLength

string ( int64 format)

طول کلیدهای رمزگذاری.

encryptionAlgorithm

enum ( MemoryEncryptionAlgorithm )

الگوریتم رمزگذاری حافظه

وضعیت رمزگذاری حافظه

وضعیت رمزگذاری حافظه در دستگاه.

انوم‌ها
MEMORY_ENCRYPTION_STATE_UNSPECIFIED وضعیت رمزگذاری حافظه تنظیم نشده است.
MEMORY_ENCRYPTION_STATE_UNKNOWN وضعیت رمزگذاری حافظه ناشناخته است.
MEMORY_ENCRYPTION_STATE_DISABLED رمزگذاری حافظه در دستگاه غیرفعال است.
MEMORY_ENCRYPTION_STATE_TME رمزگذاری حافظه در دستگاه از رمزگذاری کامل حافظه استفاده می‌کند.
MEMORY_ENCRYPTION_STATE_MKTME رمزگذاری حافظه در دستگاه از رمزگذاری کامل حافظه چندکلیدی استفاده می‌کند.

الگوریتم رمزگذاری حافظه

الگوریتم رمزگذاری مورد استفاده در دستگاه.

انوم‌ها
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED الگوریتم رمزگذاری حافظه تنظیم نشده است.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN الگوریتم رمزگذاری حافظه مورد استفاده ناشناخته است.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 الگوریتم رمزگذاری حافظه از الگوریتم رمزگذاری AES_XTS با رمز بلوکی ۱۲۸ بیتی استفاده می‌کند.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 الگوریتم رمزگذاری حافظه از الگوریتم رمزگذاری AES_XTS با رمز بلوکی ۲۵۶ بیتی استفاده می‌کند.

گزارش وضعیت حافظه

شامل نمونه‌هایی از گزارش‌های وضعیت حافظه است.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceMemoryInfo کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود، SystemRamFreeByes هر 10 دقیقه جمع‌آوری می‌شود.
  • فرکانس پیش‌فرض گزارش داده‌ها: هر ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_MEMORY_REPORT
نمایش JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. مهر زمانی بر حسب میلی‌ثانیه که نشان دهنده زمانی است که این گزارش نمونه‌برداری شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

sampleFrequency

string ( Duration format)

فقط خروجی. تعداد دفعاتی که گزارش نمونه‌برداری می‌شود.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

systemRamFreeBytes

string ( int64 format)

فقط خروجی. مقدار رم خالی بر حسب بایت (به دلیل جمع‌آوری زباله غیرقابل اعتماد است).

pageFaults

integer

فقط خروجی. تعداد خطاهای صفحه در طول این مجموعه

اطلاعات شبکه

اطلاعات دستگاه شبکه.

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportNetworkDeviceConfiguration کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: هنگام راه‌اندازی دستگاه
  • فرکانس پیش‌فرض گزارش داده‌ها: هنگام راه‌اندازی دستگاه
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش خواهند شد: بله
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_INFO
نمایش JSON 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
فیلدها
networkDevices[]

object ( NetworkDevice )

فقط خروجی. فهرست دستگاه‌های شبکه.

دستگاه شبکه

جزئیات مربوط به دستگاه شبکه.

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportNetworkDeviceConfiguration کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: هنگام راه‌اندازی دستگاه
  • فرکانس پیش‌فرض گزارش داده‌ها: هنگام راه‌اندازی دستگاه
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش خواهند شد: بله
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
نمایش JSON 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
فیلدها
type

enum ( NetworkDeviceType )

فقط خروجی. نوع دستگاه شبکه.

macAddress

string

فقط خروجی. آدرس MAC (در صورت وجود) دستگاه شبکه مربوطه.

meid

string

فقط خروجی. MEID (در صورت وجود) دستگاه شبکه مربوطه.

imei

string

فقط خروجی. IMEI (در صورت وجود) دستگاه شبکه مربوطه.

iccid

string

فقط خروجی. شناسه کارت مدار مجتمع مرتبط با سیم کارت دستگاه.

mdn

string

فقط خروجی. شماره دایرکتوری موبایل مرتبط با سیم کارت دستگاه.

نوع دستگاه شبکه

انواع دستگاه‌های شبکه

انوم‌ها
NETWORK_DEVICE_TYPE_UNSPECIFIED نوع دستگاه شبکه مشخص نشده است.
CELLULAR_DEVICE دستگاه تلفن همراه.
ETHERNET_DEVICE دستگاه اترنت.
WIFI_DEVICE دستگاه وای فای.

گزارش وضعیت شبکه

وضعیت شبکه‌های قابل مشاهده/پیکربندی شده.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportNetworkStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: ۶۰ دقیقه
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش خواهند شد: بله
  • فقط برای کاربران وابسته گزارش شده است: بله
  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType),
  "ipv6Address": [
    string
  ],
  "gatewayIpv6Address": string,
  "metered": boolean,
  "linkDownSpeedKbps": string
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. زمانی که وضعیت شبکه گزارش شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

sampleFrequency

string ( Duration format)

فقط خروجی. تعداد دفعاتی که گزارش نمونه‌برداری می‌شود.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

signalStrengthDbm

integer

فقط خروجی. قدرت سیگنال برای شبکه‌های بی‌سیم بر حسب دسی‌بل اندازه‌گیری می‌شود.

lanIpAddress

string

فقط خروجی. آدرس IP شبکه محلی.

gatewayIpAddress

string

فقط خروجی. آدرس IP دروازه.

transmissionBitRateMbps

string ( int64 format)

فقط خروجی. نرخ بیت انتقال بر حسب مگابیت در ثانیه اندازه‌گیری می‌شود.

receivingBitRateMbps

string ( int64 format)

فقط خروجی. نرخ بیت دریافتی بر حسب مگابیت در ثانیه اندازه‌گیری می‌شود.

transmissionPowerDbm

integer

فقط خروجی. توان انتقال بر حسب دسی‌بل اندازه‌گیری می‌شود.

encryptionOn

boolean

فقط خروجی. اینکه آیا کلید رمزگذاری وای‌فای خاموش است یا خیر.

wifiPowerManagementEnabled

boolean

فقط خروجی. مدیریت توان وای‌فای فعال است

guid

string

فقط خروجی. راهنمای اتصال به شبکه.

connectionState

enum ( NetworkConnectionState )

فقط خروجی. وضعیت اتصال فعلی شبکه.

connectionType

enum ( NetworkType )

فقط خروجی. نوع اتصال شبکه.

ipv6Address[]

string

فقط خروجی. آدرس‌های IPv6 که به این شبکه اختصاص داده شده‌اند، در صورت وجود. هر آدرس یک رشته در نمایش متنی استاندارد IPv6 است (مثلاً "2001:db8::1").

gatewayIpv6Address

string

فقط خروجی. در صورت شناسایی، IPv6 دروازه برای این رابط

metered

boolean

فقط خروجی. اینکه آیا شبکه به عنوان شبکه‌ی اندازه‌گیری شده شناسایی شده است یا خیر.

نوع شبکه

انواع اتصال شبکه

انوم‌ها
NETWORK_TYPE_UNSPECIFIED نوع اتصال شبکه مشخص نشده است
CELLULAR اتصال به شبکه تلفن همراه.
ETHERNET اتصال شبکه اترنت.
TETHER اتصال شبکه تتر.
VPN اتصال شبکه VPN.
WIFI اتصال به شبکه وای فای.

گزارش عیب‌یابی شبکه

نتایج آزمایش شبکه برای تعیین سلامت اتصال شبکه دستگاه، به عنوان مثال اینکه آیا تأخیر HTTPS زیاد است یا نرمال.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. مهر زمانی که تشخیص‌ها جمع‌آوری شده‌اند.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

httpsLatencyData

object ( HttpsLatencyRoutineData )

فقط خروجی. داده‌های تست تأخیر HTTPS.

وضعیت به‌روزرسانی

حاوی اطلاعاتی در مورد وضعیت به‌روزرسانی فعلی سیستم عامل است.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceOsUpdateStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_OS_REPORT
نمایش JSON 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
فیلدها
updateState

enum ( UpdateState )

فقط خروجی. وضعیت فعلی به‌روزرسانی سیستم عامل.

newPlatformVersion

string

فقط خروجی. نسخه جدید پلتفرم از تصویر سیستم عامل که دانلود و اعمال می‌شود. این فقط زمانی تنظیم می‌شود که وضعیت به‌روزرسانی OS_IMAGE_DOWNLOAD_IN_PROGRESS یا OS_UPDATE_NEED_REBOOT باشد. توجه داشته باشید که این می‌تواند یک "0.0.0.0" ساختگی برای وضعیت OS_UPDATE_NEED_REBOOT برای برخی موارد خاص باشد، مثلاً موتور به‌روزرسانی بدون راه‌اندازی مجدد، مجدداً راه‌اندازی شود.

newRequestedPlatformVersion

string

فقط خروجی. نسخه پلتفرم جدید درخواستی از برنامه کیوسک که در انتظار به‌روزرسانی است.

lastUpdateTime

string ( Timestamp format)

فقط خروجی. مهر زمانی آخرین به‌روزرسانی موفق.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

lastUpdateCheckTime

string ( Timestamp format)

فقط خروجی. مهر زمانی آخرین بررسی به‌روزرسانی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

lastRebootTime

string ( Timestamp format)

فقط خروجی. مهر زمانی آخرین راه‌اندازی مجدد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

وضعیت به‌روزرسانی

وضعیت به‌روزرسانی سیستم عامل

انوم‌ها
UPDATE_STATE_UNSPECIFIED ایالت مشخص نشده است.
OS_IMAGE_DOWNLOAD_NOT_STARTED سیستم عامل شروع به دانلود نکرده است.
OS_IMAGE_DOWNLOAD_IN_PROGRESS سیستم عامل شروع به دانلود روی دستگاه کرده است.
OS_UPDATE_NEED_REBOOT برای تکمیل آپلود، دستگاه نیاز به راه‌اندازی مجدد دارد.

اطلاعات گرافیکی

اطلاعات زیرسیستم گرافیکی

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceGraphicsStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_GRAPHICS_INFO
نمایش JSON 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
فیلدها
adapterInfo

object ( GraphicsAdapterInfo )

فقط خروجی. اطلاعات مربوط به آداپتور گرافیکی (GPU).

eprivacySupported

boolean

فقط خروجی. آیا صفحه ePrivacy پشتیبانی می‌شود یا خیر.

displayDevices[]

object ( DisplayDevice )

فقط خروجی. اطلاعات مربوط به نمایشگر(های) دستگاه.

touchScreenInfo

object ( TouchScreenInfo )

فقط خروجی. اطلاعات مربوط به صفحه(های) لمسی داخلی دستگاه.

اطلاعات آداپتور گرافیکی

اطلاعات مربوط به آداپتور گرافیکی (GPU).

نمایش JSON 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
فیلدها
adapter

string

فقط خروجی. نام آداپتور. مثال: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).

driverVersion

string

فقط خروجی. نسخه درایور پردازنده گرافیکی.

deviceId

string ( int64 format)

فقط خروجی. نشان دهنده شناسه دستگاه کارت گرافیک است.

دستگاه نمایش

اطلاعات یک دستگاه نمایشگر.

نمایش JSON 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer,
  "serialNumber": integer,
  "edidVersion": string
}
فیلدها
displayName

string

فقط خروجی. نمایش نام دستگاه.

displayWidthMm

integer

فقط خروجی. عرض نمایش بر حسب میلی‌متر.

displayHeightMm

integer

فقط خروجی. ارتفاع را بر حسب میلی‌متر نمایش دهید.

internal

boolean

فقط خروجی. آیا نمایشگر داخلی است یا خیر.

manufacturerId

string

فقط خروجی. شناسه سازنده سه حرفی.

modelId

integer

فقط خروجی. کد محصول سازنده.

manufactureYear

integer

فقط خروجی. سال ساخت.

serialNumber

integer

فقط خروجی. شماره سریال.

edidVersion

string

فقط خروجی. نسخه EDID.

اطلاعات صفحه لمسی

اطلاعات روی صفحه لمسی دستگاه.

نمایش JSON 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
فیلدها
touchpadLibrary

string

فقط خروجی. نام کتابخانه‌ی تاچ‌پد که توسط پشته‌ی ورودی استفاده می‌شود.

devices[]

object ( TouchScreenDevice )

فقط خروجی. فهرست دستگاه‌های صفحه لمسی داخلی.

دستگاه صفحه لمسی

اطلاعات مربوط به یک دستگاه صفحه لمسی داخلی.

نمایش JSON 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
فیلدها
displayName

string

فقط خروجی. نام نمایش دستگاه صفحه لمسی.

touchPointCount

integer

فقط خروجی. تعداد نقاط لمسی پشتیبانی شده در دستگاه.

stylusCapable

boolean

فقط خروجی. دستگاه صفحه لمسی قابلیت استفاده از قلم را دارد یا خیر.

گزارش وضعیت گرافیک

اطلاعات زیرسیستم گرافیکی

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceGraphicsInfo کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: ۳ ساعت.
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_GRAPHICS_REPORT
نمایش JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. زمانی که داده‌های گرافیکی گزارش شده‌اند.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

displays[]

object ( DisplayInfo )

فقط خروجی. اطلاعات مربوط به نمایشگرهای دستگاه.

اطلاعات نمایش

اطلاعات برای یک نمایشگر.

نمایش JSON 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": string
}
فیلدها
deviceId

string ( int64 format)

فقط خروجی. نشان دهنده شناسه دستگاه کارت گرافیک است.

resolutionWidth

integer

فقط خروجی. عرض وضوح تصویر بر حسب پیکسل.

resolutionHeight

integer

فقط خروجی. ارتفاع وضوح تصویر بر حسب پیکسل.

refreshRate

integer

فقط خروجی. نرخ نوسازی تصویر (هرتز).

isInternal

boolean

فقط خروجی. نشان می‌دهد که آیا نمایشگر داخلی است یا خیر.

displayName

string

فقط خروجی. نمایش نام دستگاه.

serialNumber

integer

فقط خروجی. شماره سریال.

edidVersion

string

فقط خروجی. نسخه EDID.

اطلاعات باتری

اطلاعات مربوط به باتری.

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDevicePowerStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_BATTERY_INFO
نمایش JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
فیلدها
serialNumber

string

فقط خروجی. شماره سریال باتری.

manufacturer

string

فقط خروجی. سازنده باتری.

designCapacity

string ( int64 format)

فقط خروجی. ظرفیت طراحی (میلی‌آمپر-ساعت).

designMinVoltage

integer

فقط خروجی. حداقل ولتاژ خروجی طراحی شده (میلی ولت)

manufactureDate

object ( Date )

فقط خروجی. تاریخ تولید باتری.

technology

string

فقط خروجی. فناوری باتری. مثال: لیتیوم-یون

گزارش وضعیت باتری

داده‌های وضعیت برای باتری.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDevicePowerStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_BATTERY_REPORT
نمایش JSON 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. مهر زمانی جمع‌آوری نمونه روی دستگاه

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

serialNumber

string

فقط خروجی. شماره سریال باتری.

sample[]

object ( BatterySampleReport )

فقط خروجی. داده‌های نمونه‌برداری برای باتری که به ترتیب نزولی reportTime مرتب شده‌اند.

batteryHealth

enum ( BatteryHealth )

فقط خروجی. سلامت باتری.

fullChargeCapacity

string ( int64 format)

فقط خروجی. ظرفیت شارژ کامل (میلی‌آمپر-ساعت).

cycleCount

integer

فقط خروجی. تعداد چرخه.

گزارش نمونه باتری

نمونه‌برداری از داده‌ها برای باتری.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDevicePowerStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
نمایش JSON 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. مهر زمانی جمع‌آوری نمونه روی دستگاه

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

voltage

string ( int64 format)

فقط خروجی. ولتاژ باتری (میلی‌ولت).

remainingCapacity

string ( int64 format)

فقط خروجی. ظرفیت باقیمانده باتری (میلی‌آمپر-ساعت).

temperature

integer

فقط خروجی. دما بر حسب درجه سانتیگراد.

dischargeRate

integer

فقط خروجی. نرخ دشارژ باتری که بر حسب میلی‌وات اندازه‌گیری می‌شود. اگر باتری در حال دشارژ باشد، مثبت و اگر در حال شارژ باشد، منفی است.

chargeRate

integer

فقط خروجی. درصد شارژ باتری.

current

string ( int64 format)

فقط خروجی. جریان باتری (میلی آمپر).

status

string

فقط خروجی. وضعیت باتری از sysfs خوانده می‌شود. مثال: در حال تخلیه

سلامت باتری

نشان دهنده سلامت فعلی باتری است.

  • این وضعیت یک نشانگر یا نشان دهنده‌ی باتری معیوب نیست. این وضعیت با تقسیم ظرفیت شارژ کامل فعلی بر ظرفیت طراحی محاسبه می‌شود.
  • تعریف یکپارچگی باتری و سیاست گارانتی بر عهده سازنده است.
انوم‌ها
BATTERY_HEALTH_UNSPECIFIED سلامت نامعلوم.
BATTERY_HEALTH_NORMAL باتری سالم است، ظرفیت شارژ کامل / ظرفیت طراحی > 80%
BATTERY_REPLACE_SOON باتری نسبتاً ناسالم است و پیشنهاد می‌شود به زودی تعویض شود، ظرفیت شارژ کامل / ظرفیت طراحی ۷۵٪ - ۸۰٪
BATTERY_REPLACE_NOW باتری ناسالم است و پیشنهاد می‌شود تعویض شود، ظرفیت شارژ کامل / ظرفیت طراحی <75٪

اطلاعات ذخیره‌سازی

داده‌های وضعیت برای ذخیره‌سازی.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceStorageStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_STORAGE_INFO
نمایش JSON 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
فیلدها
volume[]

object ( DiskVolume )

اطلاعات مربوط به حجم دیسک

availableDiskBytes

string ( int64 format)

فضای موجود برای ذخیره سازی داده های کاربر در دستگاه بر حسب بایت.

totalDiskBytes

string ( int64 format)

کل فضای ذخیره‌سازی داده‌های کاربر در دستگاه بر حسب بایت.

حجم دیسک

اطلاعات مربوط به حجم دیسک

نمایش JSON 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
فیلدها
volumeId

string

شناسه حجم دیسک.

storageFreeBytes

string ( int64 format)

فضای ذخیره‌سازی رایگان بر حسب بایت.

storageTotalBytes

string ( int64 format)

کل فضای ذخیره‌سازی بر حسب بایت.

گزارش وضعیت ذخیره‌سازی

داده‌های وضعیت برای ذخیره‌سازی.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceStorageStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_STORAGE_REPORT
نمایش JSON 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
فیلدها
reportTime

string ( Timestamp format)

فقط خروجی. مهر زمانی جمع‌آوری نمونه روی دستگاه

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

disk[]

object ( DiskInfo )

فقط خروجی. گزارش‌ها روی دیسک.

اطلاعات دیسک

وضعیت دستگاه ذخیره‌سازی تکی.

نمایش JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "sizeBytes": string,
  "type": string,
  "health": string,
  "volumeIds": [
    string
  ],
  "bytesReadThisSession": string,
  "bytesWrittenThisSession": string,
  "readTimeThisSession": string,
  "writeTimeThisSession": string,
  "ioTimeThisSession": string,
  "discardTimeThisSession": string
}
فیلدها
serialNumber

string

فقط خروجی. شماره سریال دیسک.

manufacturer

string

فقط خروجی. سازنده دیسک.

model

string

فقط خروجی. مدل دیسک.

sizeBytes

string ( int64 format)

فقط خروجی. اندازه دیسک.

type

string

فقط خروجی. نوع دیسک: eMMC / NVMe / ATA / SCSI.

health

string

فقط خروجی. سلامت دیسک.

volumeIds[]

string

فقط خروجی. حجم دیسک.

bytesReadThisSession

string ( int64 format)

فقط خروجی. تعداد بایت‌های خوانده شده از آخرین بوت.

bytesWrittenThisSession

string ( int64 format)

فقط خروجی. تعداد بایت‌های نوشته شده از آخرین بوت.

readTimeThisSession

string ( Duration format)

فقط خروجی. زمان صرف شده برای خواندن از دیسک از آخرین بوت.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

writeTimeThisSession

string ( Duration format)

فقط خروجی. زمان صرف شده برای نوشتن روی دیسک از آخرین بوت.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

ioTimeThisSession

string ( Duration format)

فقط خروجی. زمان مشغول بودن دیسک و صف را شمارش می‌کند، بنابراین برخلاف فیلدهای بالا، درخواست‌های موازی چندین بار شمارش نمی‌شوند.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

discardTimeThisSession

string ( Duration format)

فقط خروجی. زمان صرف شده برای دور انداختن از آخرین بوت. دور انداختن به معنای نوشتن برای پاک کردن بلوک‌هایی است که دیگر استفاده نمی‌شوند. در هسته‌های ۴.۱۸+ پشتیبانی می‌شود.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

اطلاعات رعد و برق

اطلاعات اتوبوس تاندربولت

  • این فیلد اطلاعات دستگاه را ارائه می‌دهد که ثابت است و با گذشت زمان تغییر نخواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceSecurityStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: هنگام راه‌اندازی دستگاه
  • فرکانس پیش‌فرض گزارش داده‌ها: هنگام راه‌اندازی دستگاه
    • کنترل سیاست: خیر
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش خواهند شد: بله
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_BUS_DEVICE_INFO
نمایش JSON 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
فیلدها
securityLevel

enum ( ThunderboltSecurityLevel )

سطح امنیتی گذرگاه تاندربولت.

سطح امنیت تاندربولت

سطح امنیتی گذرگاه تاندربولت.

انوم‌ها
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED سطح امنیتی Thunderbolt تنظیم نشده است.
THUNDERBOLT_SECURITY_NONE_LEVEL همه دستگاه‌ها به طور خودکار توسط میان‌افزار متصل می‌شوند. نیازی به تأیید کاربر نیست.
THUNDERBOLT_SECURITY_USER_LEVEL از کاربر پرسیده می‌شود که آیا دستگاه اجازه اتصال دارد یا خیر.
THUNDERBOLT_SECURITY_SECURE_LEVEL از کاربر پرسیده می‌شود که آیا دستگاه اجازه اتصال دارد یا خیر. علاوه بر این، به دستگاه یک چالش ارسال می‌شود که باید با چالش مورد انتظار بر اساس یک کلید تصادفی نوشته شده در ویژگی sysfs کلید مطابقت داشته باشد.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL این میان‌افزار به‌طور خودکار تونل‌هایی برای تاندربولت ایجاد می‌کند.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL این میان‌افزار به‌طور خودکار تونل‌هایی را برای کنترلر USB و پورت نمایش در داک ایجاد می‌کند. تمام لینک‌های PCIe در پایین‌دست داک حذف می‌شوند.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL تونلینگ PCIE غیرفعال است.

گزارش عملکرد بوت

گزارش عملکرد بوت یک دستگاه.

  • این فیلد اطلاعات تله‌متری است و با گذشت زمان و با استفاده از دستگاه، تغییر خواهد کرد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceBootMode کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: در هر رویداد راه‌اندازی سیستم
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش خواهند شد: بله
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_OS_REPORT
نمایش JSON 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
فیلدها
bootUpDuration

string ( Duration format)

کل زمان لازم برای بوت شدن.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

bootUpTime

string ( Timestamp format)

مهر زمانی که برق وصل شد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

shutdownDuration

string ( Duration format)

کل زمان از زمان شروع خاموش شدن تا خاموش شدن کامل دستگاه.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

shutdownTime

string ( Timestamp format)

مهر زمانی هنگام خاموش شدن.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

shutdownReason

enum ( ShutdownReason )

دلیل خاموش شدن.

reportTime

string ( Timestamp format)

مهر زمانی که گزارش جمع‌آوری شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

دلیل خاموش شدن

دلیل خاموش شدن.

انوم‌ها
SHUTDOWN_REASON_UNSPECIFIED دلیل خاموش شدن مشخص نشده است.
USER_REQUEST کاربر شروع به کار کرد.
SYSTEM_UPDATE به‌روزرسانی سیستم آغاز شد.
LOW_BATTERY خاموش شدن به دلیل کمبود باتری.
OTHER خاموش شدن به دلایل دیگر.

گزارش وضعیت ضربان قلب

گزارش وضعیت ضربان قلب دستگاه.

  • موجود برای کیوسک‌ها
  • این فیلد وضعیت آنلاین/آفلاین/ناشناس یک دستگاه را ارائه می‌دهد و فقط در صورتی که وضعیت تغییر کرده باشد (مثلاً آنلاین -> آفلاین) نمایش داده می‌شود.
  • داده‌های این فیلد از طریق سیاست HeartbeatEnabled کنترل می‌شوند. اطلاعات بیشتر
  • فرکانس ضربان قلب: ۲ دقیقه
    • توجه: اگر دستگاهی آفلاین شود، به‌روزرسانی وضعیت آنلاین دستگاه می‌تواند تا ۱۲ دقیقه طول بکشد.
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش خواهند شد: ناموجود
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
نمایش JSON 
{
  "reportTime": string,
  "state": enum (State)
}
فیلدها
reportTime

string ( Timestamp format)

مهر زمانی تغییر وضعیت شناسایی شد

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

state

enum ( State )

دستگاه را تغییر دهید

ایالت

وضعیت دستگاه

انوم‌ها
STATE_UNSPECIFIED ایالت مشخص نشده است
UNKNOWN دستگاه برای نظارت بر ضربان قلب واجد شرایط نیست
ONLINE دستگاه آنلاین است
OFFLINE دستگاه آفلاین است
DEVICE_OUTDATED دستگاه قدیمی شده است

گزارش وضعیت برنامه کیوسک

گزارش وضعیت برنامه کیوسک از یک دستگاه.

  • موجود برای کیوسک‌ها
  • این فیلد شناسه برنامه و شماره نسخه در حال اجرا بر روی دستگاه کیوسک و مهر زمانی آخرین به‌روزرسانی گزارش را ارائه می‌دهد.
  • داده‌های این فیلد از طریق سیاست ReportDeviceSessionStatus کنترل می‌شوند.
  • فرکانس جمع‌آوری داده‌ها: فقط در زمان آپلود
  • فرکانس پیش‌فرض گزارش داده‌ها: ۳ ساعت
    • کنترل سیاست: بله
  • حافظه پنهان: اگر دستگاه آفلاین باشد، داده‌های جمع‌آوری‌شده به‌صورت محلی ذخیره می‌شوند و وقتی دستگاه دوباره آنلاین شود، گزارش می‌شوند: خیر
  • فقط برای کاربران وابسته گزارش شده است: ناموجود
  • مجوز جزئی مورد نیاز: TELEMETRY_API_APPS_REPORT
نمایش JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
فیلدها
reportTime

string ( Timestamp format)

مهر زمانیِ جمع‌آوری گزارش

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

appId

string

شناسه برنامه کیوسک، برای مثال "mdmkkicfmmkgmpkmkdikhlbggogpicma"

appVersion

string

شماره نسخه برنامه کیوسک، برای مثال "1.10.118"

شمارنده‌های زمان اجراگزارش

شمارنده‌های زمان اجرا از CPU بازیابی می‌شوند. در حال حاضر، تله‌متری شمارنده‌های زمان اجرا فقط توسط Intel vPro PSR در نسل ۱۴+ پشتیبانی می‌شود.

نمایش JSON 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
فیلدها
reportTime

string ( Timestamp format)

مهر زمانی که گزارش جمع‌آوری شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

uptimeRuntimeDuration

string ( Duration format)

کل زمان اجرا در طول عمر. در حال حاضر همیشه زمان اجرا S0 از Intel vPro PSR است.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

enterSleepCount

string ( int64 format)

تعداد دفعاتی که دستگاه وارد حالت خواب شده است. در حال حاضر از طریق PSR بدست می‌آید، از S0 تا S3 بشمارید.

enterHibernationCount

string ( int64 format)

تعداد دفعاتی که دستگاه وارد حالت خواب زمستانی شده است. در حال حاضر از طریق PSR به دست می‌آید، از S0 تا S4 می‌شمارد.

enterPoweroffCount

string ( int64 format)

تعداد دفعاتی که دستگاه وارد حالت خاموش شده است. در حال حاضر از طریق PSR بدست می‌آید، از S0 تا S5 بشمارید.

روش‌ها

get

 دستگاه تله متری تهیه کنید.

list

 تمام دستگاه‌های تله‌متری را فهرست کنید.