Imported from akashtalole/CC-Plugin-for-Thingsboard (
skills/tbce-troubleshoot/SKILL.md). Install upstream withnpx skills add akashtalole/CC-Plugin-for-Thingsboard --skill tbce-troubleshoot. Copyright stays with the author.
Invoke the tbce-troubleshoot agent to diagnose this issue: $ARGUMENTS
The agent follows a systematic diagnostic process:
- Verify environment — check
TB_URLandTB_API_KEY, test API connectivity - Locate the entity — find device/profile/dashboard by name via REST API
- Collect diagnostics — query relevant API endpoints for state information
- Identify root cause — match symptoms to known ThingsBoard issues
- Provide fix — specific steps or commands to resolve the issue
Issue categories and typical fixes:
| Symptom | Common Cause |
|---|---|
| Device inactive | Wrong MQTT credentials or topic |
| No telemetry | Rule chain missing Save Timeseries node |
| Alarm not firing | Telemetry key case mismatch; missing Device Profile node |
| Dashboard no data | entityAlias deviceType doesn't match profile name |
| Rule chain errors | Failure outputs unconnected; JS instead of TBEL |
| MQTT connect fails | Using username instead of access token as password |
MQTT connection checklist:
- Host:
demo.thingsboard.io - Port: 1883 (plain) or 8883 (TLS)
- Username:
""(empty) - Password: device access token from
GET /api/device/{id}/credentials - Topic:
v1/devices/me/telemetry