IoT Platform User Guide

Device Details

Device header, charts, activity, properties, telemetry, connect, files, and alerts tabs.

The Device Details page combines device identity, quick actions, current alerts, and deep operational tabs. The top card provides the status pill and key metadata (serial, class, asset tag, manufacturer, model, tags). The action menu supports edit, delete, telemetry export, and enable/disable state control. Tabbed sections then break down charting, activity, properties, telemetry controls, integration endpoints, file transfer, and alert history.

Device Header and Action Menu

To use the device header and action menu, do the following:

  1. Open a device from the Devices table.
  2. In the top card, review:
    • Device name and Online/Offline status.
    • Core metadata fields.
    • Current alerts summary list.
  3. Open the three-dot action menu.
  4. Use available actions:
    • Edit
    • Delete
    • Export telemetry
    • Enabled toggle

Charts Tab

The Charts tab displays the latest telemetry values and trend charts when telemetry fields exist in the assigned device template. If telemetry definitions are missing, the UI provides clear guidance rather than blank visualizations. This helps distinguish between a data ingestion issue and a modeling/template issue.

To use the Charts tab, do the following:

  1. Open the Charts tab.
  2. Review cards/charts if telemetry exists.
  3. If you see Device Template Missing, assign a template with telemetry definitions to enable chart rendering.

Recent Activity Tab

To review recent activity, do the following:

  1. Open Recent Activity.
  2. Review incoming messages and timeline activity for the selected device.
  3. Use this view to correlate telemetry flow with operational events.

Properties Tab

The Properties tab presents static and template-driven attributes in a read-focused layout. It includes basic identity fields and, when available, additional template properties grouped by component. This is useful for verifying metadata quality and confirming that template properties are correctly resolved on the device.

To review and edit properties, do the following:

  1. Open Properties.
  2. Review key fields such as Name, Device Class, Serial Number, Asset Tag, Manufacturer, and Tags.
  3. If present, review Device Template Properties for component-level property values.

Telemetry Tab (Inactivity Controls)

Telemetry settings include inactivity handling that can generate disconnect behavior when data stops arriving for a configured timeout window. Depending on template configuration and account context, you may see toggles for trigger/override behavior or direct timeout fields. This lets operators tune sensitivity for telemetry silence without changing other fleet-level behavior.

To configure telemetry inactivity controls, do the following:

  1. Open Telemetry.
  2. In Device Telemetry Inactivity, configure timeout behavior.
  3. Set timeout value and unit (seconds, minutes, hours, or days) where available.
  4. Click Save when the save action is enabled.

Connect Tab (Webhooks and Endpoint Access)

The Connect tab provides direct webhook endpoints for sending logs, files, and alerts, plus endpoint patterns for alert deletion. This supports integrations and simulation workflows without requiring extra navigation. The endpoint section is useful for quick API hookup and validation during onboarding and troubleshooting.

To use webhook and endpoint access options, do the following:

  1. Open Connect.
  2. Copy and use the provided endpoints:
    • Send data using Webhook (POST)
    • Send files using Webhook (PUT)
    • Send alert using Webhook (POST)
    • Delete alert (DELETE)
  3. Use these URLs in your integration client or test tools.

Files Tab

The Files tab supports direct upload and visibility of files associated with the selected device. If no files have been uploaded, a placeholder message appears. Once files exist, the table shows metadata such as content type and timestamps to support verification and audit-like checks.

To upload and review files, do the following:

  1. Open Files.
  2. If no files exist, confirm the No files are uploaded... message.
  3. Click Choose file and select a local file.
  4. Click Upload.
  5. Confirm the uploaded file appears in the table.

Alerts Tab

The Alerts tab shows detailed alert history for the device, including severity and alert metadata. It is intended for issue review and traceability after observing current-alert indicators in the top card. Use this tab when you need full details beyond summarized alert chips.

To review device alert history, do the following:

  1. Open Alerts.
  2. Review rows for severity, code, alert type, description, metadata, account, and timestamps.
  3. Use this tab for deeper triage and event tracking.