Skip to main content

Device

Represents a single device.

Fields

NameDescription
id - IDDimension!The unique identifier for the device.
name - StringDimensionThe name of the device.
user_info - [DeviceUserInfo!]User information associated with the device.
profile - DeviceProfileDevice profile information.
system_metrics - [DeviceSystemHealthDatapoint!]System health metrics for the device.
score_metrics - [DeviceHealthScoreMetrics!]Score-based metrics for the device.
disk_metrics - [DeviceDiskHealthDatapoint!]Disk health metrics for the device.
network_metrics - [DeviceNetworkHealthDatapoint!]Network health metrics for the device.
wifi_metrics - [DeviceWifiHealthDatapoint!]Wi-Fi health metrics for the device.
event_metrics - [DeviceEventMetricsDatapoint!]Event metrics for the device.
app_metrics - [AppMetrics!]Field to carry overall comprehensive app metrics.
web_app_metrics(app_id: EqFilter!) - [WebAppMetrics!]Field to carry web performance metrics.
network_app_metrics(app_id: EqFilter!) - [NetworkAppMetrics!]Field to carry network performance metrics.
network_app_leg_metrics(app_id: EqFilter!) - [NetworkAppLegMetrics!]Field to carry network performance metrics by leg.
call_quality_app_metrics(app_id: EqFilter!) - [CallQualityAppMetrics!]Field to carry call quality performance metrics.
rum_app_metrics(app_id: EqFilter!) - [RumAppMetrics!]Field to carry real-user performance metrics.
EXAMPLE
{
"id": {
  "value": null
},
"name": {
  "value": "example"
},
"user_info": [{
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "user_email": {
    "value": "example"
  },
  "loc_id": {
    "value": "example"
  },
  "loc_name": {
    "value": "example"
  },
  "dept_id": {
    "value": "example"
  },
  "dept_name": {
    "value": "example"
  },
  "geo_lat": "example",
  "geo_long": "example",
  "geo_provider_name": {
    "value": "example"
  },
  "city": {
    "value": "example"
  },
  "state": {
    "value": "example"
  },
  "country": {
    "value": "example"
  },
  "last_seen_ts": "2024-01-01T00:00:00Z"
}],
"profile": {
  "os_name": "example",
  "os_version": "example",
  "sys_model": "example",
  "manufacturer": "example",
  "hardware_type": "example",
  "hardware_serial_no": "example",
  "gpu": "example",
  "os_build": "example",
  "hostname": "example",
  "netbios_name": "example",
  "current_loggedin_user": "example",
  "zcc_version": "example",
  "zdx_version": "example",
  "tunnel_type": "example",
  "network_type": "example",
  "zia_state": "example",
  "zpa_state": "example",
  "public_ip": "example",
  "last_start_time": "2024-01-01T00:00:00Z",
  "last_wake_time": "2024-01-01T00:00:00Z",
  "last_sleep_time": "2024-01-01T00:00:00Z",
  "network_profile": [{
    "friendly_name": "example",
    "ipv4": "example",
    "ifname": "example",
    "mac_address": "example",
    "guid": "example",
    "dns_suffix": "example",
    "dns_servers": "example",
    "type": "example",
    "gateway_mac_address": "example",
    "vpn_interface_map": "example",
    "gateway": "example",
    "status": "example"
  }],
  "wifi_profile": [{
    "ifname": "example",
    "bssid": "example",
    "channel": 123,
    "guid": "example",
    "driverver": "example",
    "type": "example",
    "ssid": "example"
  }],
  "disk_profile": [{
    "size": "example",
    "model": "example",
    "type": "example"
  }],
  "cpu_profile": [{
    "logical_processors": 123,
    "num_of_cores": 123,
    "max_speed_ghz": "example",
    "model": "example",
    "manufacturer": "example"
  }]
},
"system_metrics": [{
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "cpu_total_pct": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "mem_used_pct": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "battery_level_pct": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  }
}],
"score_metrics": [{
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "device_health_score": 1.23,
  "cpu_usage_score": 1.23,
  "disk_usage_score": 1.23,
  "memory_usage_score": 1.23,
  "wifi_signal_quality_score": 1.23,
  "disk_queue_length_score": 1.23,
  "battery_score": 1.23,
  "software_issues_score": 1.23
}],
"disk_metrics": [{
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "disk_name": {
    "value": "example"
  },
  "used_pct": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "read_bps": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "write_bps": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  }
}],
"network_metrics": [{
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "interface_name": {
    "value": "example"
  },
  "bandwidth_mbps": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "receive_bps": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "send_bps": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  }
}],
"wifi_metrics": [{
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "interface_name": {
    "value": "example"
  },
  "mcs": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "rxmit_pct": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "signal_quality": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "snr": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  }
}],
"event_metrics": [{
  "name": "example",
  "severity": "example",
  "count": 123
}],
"app_metrics": [{
  "app_id": {
    "value": null
  },
  "app_name": {
    "value": "example"
  },
  "zdx_score": 123
}],
"web_app_metrics": [{
  "app_id": {
    "value": null
  },
  "app_name": {
    "value": "example"
  },
  "mon_id": {
    "value": null
  },
  "mon_name": {
    "value": "example"
  },
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "synthetic_probe_score": 123,
  "pft": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "dns_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "pac_parsing_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "ttlb": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "tcp_conn_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "http_conn_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "ssl_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "ttfb": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "pct_avail": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  }
}],
"network_app_metrics": [{
  "app_id": {
    "value": null
  },
  "app_name": {
    "value": "example"
  },
  "mon_id": {
    "value": null
  },
  "mon_name": {
    "value": "example"
  },
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "synthetic_probe_score": 123,
  "latency": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "packet_loss": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "total_hops": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "packets_count": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  }
}],
"network_app_leg_metrics": [{
  "app_id": {
    "value": null
  },
  "app_name": {
    "value": "example"
  },
  "mon_id": {
    "value": null
  },
  "mon_name": {
    "value": "example"
  },
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "metrics": [{
    "network_leg": {

    },
    "latency": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "packet_loss": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "total_hops": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    }
  }]
}],
"call_quality_app_metrics": [{
  "app_id": {
    "value": null
  },
  "app_name": {
    "value": "example"
  },
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "cqm_score": 123,
  "audio": {
    "mos_score_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "mos_score_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "latency_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "latency_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "jitter_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "jitter_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "loss_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "loss_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "max_loss_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "max_loss_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    }
  },
  "video": {
    "latency_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "latency_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "jitter_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "jitter_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "loss_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "loss_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "max_loss_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "max_loss_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    }
  },
  "sharing": {
    "latency_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "latency_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "jitter_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "jitter_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "loss_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "loss_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "max_loss_in": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    },
    "max_loss_out": {
      "avg": 1.23,
      "min": 1.23,
      "max": 1.23
    }
  }
}],
"rum_app_metrics": [{
  "app_id": {
    "value": null
  },
  "app_name": {
    "value": "example"
  },
  "ext_id": {
    "value": "example"
  },
  "ext_ver": {
    "value": "example"
  },
  "ext_type": {
    "value": "example"
  },
  "user_id": {
    "value": null
  },
  "user_name": {
    "value": "example"
  },
  "rum_score": 123,
  "page_views": 123,
  "route_changes": 123,
  "page_load_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "dns_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "tcp_conn_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "ssl_handshake_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "server_response_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "dom_processing_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "dom_content_load_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "time_to_last_byte": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "load_tm": {
    "avg": 1.23,
    "min": 1.23,
    "max": 1.23
  },
  "web_vitals": {
    "fcp": 123,
    "total_blocking_tm": 123,
    "total_long_tasks": 123,
    "longest_long_task_duration": 123,
    "total_long_task_duration": 123,
    "core_web_vitals": {
      "lcp": 123,
      "inp": 123,
      "cls": 123
    }
  }
}]
}