Skip to content

docs(device-state): document profile-level inactivity timeout#426

Open
zzzeebra wants to merge 1 commit into
mainfrom
docs/device-inactivity-timeout-profile
Open

docs(device-state): document profile-level inactivity timeout#426
zzzeebra wants to merge 1 commit into
mainfrom
docs/device-inactivity-timeout-profile

Conversation

@zzzeebra
Copy link
Copy Markdown

@zzzeebra zzzeebra commented May 26, 2026

Summary

Documents the new Device inactivity timeout field on the Device Profile Details page (introduced by thingsboard/thingsboard#15527) and updates existing inactivity timeout references to reflect the three-tier resolution.

Effective inactivity timeout per device, in priority order:

  1. Per-device inactivityTimeout server-side attribute (milliseconds)
  2. Device inactivity timeout field on the device profile (new)
  3. Global DEFAULT_INACTIVITY_TIMEOUT fallback (seconds, default 600)

Files changed

  • user-guide/device-profiles.mdx — new "Device inactivity timeout" section (unit selector, resolution order, profile-update propagation). Profile Details table row updated with anchor link.
  • user-guide/connectivity-status.mdx — Aside expanded from per-device-only override to the full three-tier hierarchy with link to the new profile section. "Inactivity Detection" paragraph rewritten to mention all three sources. Drive-by bug fix: TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT default 300000600000 to match thingsboard.yml.
  • recipes/device-inactivity-alarm.mdx — "Step 1. Set inactivity timeout" split into Option A (Device profile, recommended) and Option B (per-device override). Replaced state.defaultInactivityTimeoutInSec yml-property with DEFAULT_INACTIVITY_TIMEOUT env name per style guide.
  • edge/reference/configuration/rule-engine-config.mdx — tightened the description of state.defaultInactivityTimeoutInSec; mentions the three-tier resolution.

Test plan

  • `pnpm build:fast` — 3817 pages built, no errors or warnings on edited files
  • Reviewer to verify the new Device Profile section reads correctly at `/docs/user-guide/device-profiles/#device-inactivity-timeout` (CE) and `/docs/pe/user-guide/device-profiles/#device-inactivity-timeout` (PE)
  • Reviewer to confirm the anchor links from `connectivity-status` and `device-inactivity-alarm` resolve in both CE and PE

Pairing

Pair with thingsboard/thingsboard#15527. If the field name or UX changes during code review on that PR, this PR will need to follow.

Adds documentation for the new Device Profile "Device inactivity timeout"
field introduced by thingsboard/thingsboard#15527, and updates existing
inactivity timeout references to reflect the three-tier resolution:
per-device server attribute → device profile → global default.

- user-guide/device-profiles: new "Device inactivity timeout" section
  with unit selector, resolution order, and propagation behavior.
- user-guide/connectivity-status: expand Aside to the three-tier
  hierarchy; rewrite Inactivity Detection paragraph; fix
  TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT default 300000 -> 600000
  to match thingsboard.yml.
- recipes/device-inactivity-alarm: replace yml-property reference with
  env var; split Step 1 into Option A (device profile, recommended) and
  Option B (per-device override).
- edge/reference/configuration/rule-engine-config: tighten the
  defaultInactivityTimeoutInSec description and mention the new
  three-tier resolution.

Note: core-rule-engine-config.mdx (CE+PE) is auto-generated from
application/src/main/resources/thingsboard.yml comments by
scripts/generate_config_pages.py, so it is updated in the platform
yml as part of the matching CE PR rather than edited here.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant