support

Troubleshooting Guide

Baseline runbook for connectivity, telemetry, and Unreal runtime issues.

Last Updated: 2026-02-26

Troubleshooting Guide

Use this runbook in order. It isolates where the pipeline is failing: device, cloud, or Unreal runtime.

Step 1: Confirm Device Health

Check:

  • Device has power and expected status LEDs
  • Network credentials are valid
  • Local network permits outbound TLS traffic

If device is not visible in registry, resolve provisioning/auth before continuing.

Step 2: Confirm Cloud Ingestion

From cloud logs/registry:

  • device_id is online
  • Last event timestamp is recent
  • Payloads are accepted (not schema-rejected)

If online but no telemetry:

  • Inspect firmware publish interval
  • Validate payload keys and value types
  • Check sensor hardware wiring/availability

Step 3: Confirm Unreal Connectivity

In Unreal project settings:

  • Endpoint URL is correct
  • API token is present and not expired
  • Plugin/module is enabled

At runtime:

  • Print latest received timestamp
  • Verify delegate/event is bound
  • Verify bound device_id matches exact case

Common Symptoms

Device Offline

Likely causes:

  • Firewall/proxy blocking outbound traffic
  • Invalid provisioning token
  • Wrong SSID/password

Actions:

  1. Reprovision credentials.
  2. Allow required outbound endpoints/ports.
  3. Reboot device and retry handshake.

Device Online, No Metrics

Likely causes:

  • Publish interval too high
  • Payload schema mismatch
  • Sensor read failure

Actions:

  1. Reduce publish interval for testing.
  2. Validate payload structure against schema page.
  3. Run local sensor diagnostics.

Cloud Good, Unreal Static

Likely causes:

  • Token missing/invalid in Unreal
  • No active binding to target actor
  • Value mapping/clamping hides visible changes

Actions:

  1. Validate token and endpoint.
  2. Log incoming payload values in runtime.
  3. Test with exaggerated metric-to-visual mapping.

Escalation Data To Capture

Before escalating, capture:

  • device_id
  • Timestamp range (UTC)
  • Last known firmware version
  • Unreal engine version and plugin version
  • One sample accepted payload

Related Pages