> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insaion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Device details

> Deep dive into the Device Details page. Covers data sources, UI states, device metadata, and more.

## At a glance

When you open a device's details page you'll find:

* The device header with the device name, type (if any), Site (if any), a live status indicator (Online / Offline) and a description.
* Sources discovered automatically from the device (Host metrics and ROS2).
* Device Metadata for easy identification and search.

## Status indicator

The status badge on the device header shows whether the device is currently online or offline. This status refreshes automatically so you can see near-real-time connectivity without reloading the page.

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/devices/device-details-header.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=f904a64b4d3c6048641cf42bc75ad69d" alt="Device Header" width="718" height="251" data-path="assets/devices/device-details-header.png" />

If the device shows "Offline":

* Check the device's network and power.
* If problems persist, see the Troubleshooting section below or contact your administrator.

## Sources

The Sources section lists data sources that the agent has discovered on the device. This typically includes:

* Host metrics: CPU, memory, disk, and network usage from the device's operating system. This are always collected by the agent once it's running.
* ROS2: If the device is running ROS2 and the agent has detected it, it will show up here with details about the ROS2 topics being monitored.
  <img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/devices/device-details-sources.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=cbc663b235a0111b8b7cf2566df6189a" alt="Device Sources" width="1192" height="671" data-path="assets/devices/device-details-sources.png" />

To start monitoring new sources, check the corresponding box in the Sources section and click Save changes. The agent will begin collecting data from those sources and they will appear in the dashboard within a few minutes.
There is no need to restart the agent or the device.

## OpenTelemetry inventory and toggle

The Device Details page also includes an OpenTelemetry Inventory section.

* OTel ingestion is enabled by default.
* Use the OTel ingestion toggle to enable or disable OpenTelemetry collection for that device.
* The inventory lists discovered services and their emitted metrics, logs, and traces.

If no entries are shown yet, the device may not have emitted OTel data in the selected period.

To start sending data from your app, point your OpenTelemetry exporter to:

* Endpoint: [http://127.0.0.1:4317](http://127.0.0.1:4317)
* Protocol: OTLP/gRPC

For dashboard query setup with otel\_metrics, otel\_logs, and otel\_traces, see [OpenTelemetry in Monitoring](/monitoring/opentelemetry).

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/devices/device-details-otel.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=92df2df7a74822f466b9a796aba98cd3" alt="Device OTel" width="1197" height="709" data-path="assets/devices/device-details-otel.png" />

## Metadata

The Metadata section allows you to add custom key-value pairs to help identify and organize devices. Common metadata includes:

* Software versions
* Hardware serial numbers
* Firmware versions
* Hardware models
  <img src="https://mintcdn.com/insaion/dkLh615XOmGRTVSX/assets/devices/device-details-metadata.png?fit=max&auto=format&n=dkLh615XOmGRTVSX&q=85&s=d7bfe302b31e75e2ea4d7bb296b0312c" alt="Device Metadata" width="976" height="706" data-path="assets/devices/device-details-metadata.png" />

Metadata serves as tags for advanced filtering, grouping and to compare devices in dashboards and alerts. You can add, edit, or remove metadata entries at any time. Changes take effect immediately.

## Best practices

* Give devices meaningful names (ID + role, e.g. "AMR Sector 4B") so they are easy to find.
* Add a short description with installation notes (mounting location, contacts, or serial numbers).
* Complete the setup right after provisioning devices to avoid confusion in dashboards or alerts.

<div className="insaion-footer" role="contentinfo">
  <div className="insaion-footer__card">
    <div className="insaion-footer__content">
      <span className="insaion-footer__icon" aria-hidden="true">
        <svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" focusable="false" className="insaion-footer__svg" role="img">
          <path fill="currentColor" d="M21 6.5A3.5 3.5 0 0 0 17.5 3h-11A3.5 3.5 0 0 0 3 6.5v5A3.5 3.5 0 0 0 6.5 15H8v3l3-3h6.5A3.5 3.5 0 0 0 21 11.5v-5zM7 8.5a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm4 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm4 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z" />
        </svg>
      </span>

      <div>
        If something's unclear or you hit a blocker, contact us on

        <a href="https://discord.gg/ZJMPfMmu3S" target="_blank" rel="noopener">
          Discord
        </a>

        or <a href="mailto:contact@insaion.com">[contact@insaion.com](mailto:contact@insaion.com)</a>
      </div>
    </div>
  </div>
</div>
