updated descriptions

application/src/main/resources/thingsboard.yml

@@ -777,9 +777,12 @@ audit-log:
 
 # Device state parameters
 state:
-  # Defines when the device state will be marked as "inactive" by server.
-  # We recommend this parameter to be in sync with transport.sessions.inactivity_timeout
-  # (transport timeout should be equal to or greater than current parameter; if not, you can get the situation when the session is closed for the active device).
+  # Device inactivity timeout is a global configuration parameter that defines when the device will be marked as "inactive" by the server.
+  # The parameter value is in seconds. A user can overwrite this parameter for an individual device by setting the “inactivityTimeout” server-side attribute (NOTE: expects value in milliseconds).
+  # We recommend this parameter to be in sync with session inactivity timeout ("transport.sessions.inactivity_timeout" or TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT) parameter
+  # which is responsible for detection of the stale device connection sessions.
+  # The value of the session inactivity timeout parameter should be greater or equal to the device inactivity timeout.
+  # Note that the session inactivity timeout is set in milliseconds while device inactivity timeout is in seconds.
   defaultInactivityTimeoutInSec: "${DEFAULT_INACTIVITY_TIMEOUT:600}"
   defaultStateCheckIntervalInSec: "${DEFAULT_STATE_CHECK_INTERVAL:60}" # Interval for checking the device state after a specified period. Time in seconds
   # Controls whether we store the device 'active' flag in attributes (default) or telemetry.
@@ -868,11 +871,14 @@ js:
 # Transport configuration parameters
 transport:
   sessions:
-    # Parameter defines how long the device transport session will be opened after the last activity time.
+    # Session inactivity timeout is a global configuration parameter that defines how long the device transport session will be opened after the last message arrives from the device.
+    # The parameter value is in milliseconds.
     # The last activity time of the device session is updated if the device sends any message, including keepalive messages
     # If there is no activity, the session will be closed, and all subscriptions will be deleted.
-    # We recommend this parameter to be in sync with state.defaultInactivityTimeoutInSec
-    # (current parameter should be equal to or greater than defaultInactivityTimeoutInSec; if not, you can get the situation when the session is closed for the active device).
+    # We recommend this parameter to be in sync with device inactivity timeout ("state.defaultInactivityTimeoutInSec" or DEFAULT_INACTIVITY_TIMEOUT) parameter
+    # which is responsible for detection of the device connectivity status in the core service of the platform.
+    # The value of the session inactivity timeout parameter should be greater or equal to the device inactivity timeout.
+    # Note that the session inactivity timeout is set in milliseconds while device inactivity timeout is in seconds.
     inactivity_timeout: "${TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT:600000}"
     # Interval of periodic check for expired sessions and report of the changes to session last activity time
     report_timeout: "${TB_TRANSPORT_SESSIONS_REPORT_TIMEOUT:3000}"

transport/coap/src/main/resources/tb-coap-transport.yml

@@ -175,11 +175,14 @@ transport:
         # Interval of periodic eviction of the timed-out DTLS sessions
         dtls_session_report_timeout: "${TB_COAP_X509_DTLS_SESSION_REPORT_TIMEOUT:1800000}"
   sessions:
-    # Parameter defines how long the device transport session will be opened after the last activity time.
+    # Session inactivity timeout is a global configuration parameter that defines how long the device transport session will be opened after the last message arrives from the device.
+    # The parameter value is in milliseconds.
     # The last activity time of the device session is updated if the device sends any message, including keepalive messages
     # If there is no activity, the session will be closed, and all subscriptions will be deleted.
-    # We recommend this parameter to be in sync with state.defaultInactivityTimeoutInSec
-    # (current parameter should be equal to or greater than defaultInactivityTimeoutInSec; if not, you can get the situation when the session is closed for the active device).
+    # We recommend this parameter to be in sync with device inactivity timeout ("state.defaultInactivityTimeoutInSec" or DEFAULT_INACTIVITY_TIMEOUT) parameter
+    # which is responsible for detection of the device connectivity status in the core service of the platform.
+    # The value of the session inactivity timeout parameter should be greater or equal to the device inactivity timeout.
+    # Note that the session inactivity timeout is set in milliseconds while device inactivity timeout is in seconds.
     inactivity_timeout: "${TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT:600000}"
     # Interval of periodic check for expired sessions and report of the changes to session last activity time
     report_timeout: "${TB_TRANSPORT_SESSIONS_REPORT_TIMEOUT:3000}"

transport/http/src/main/resources/tb-http-transport.yml

@@ -160,11 +160,14 @@ transport:
     # HTTP maximum request processing timeout in milliseconds
     max_request_timeout: "${HTTP_MAX_REQUEST_TIMEOUT:300000}"
   sessions:
-    # Parameter defines how long the device transport session will be opened after the last activity time.
+    # Session inactivity timeout is a global configuration parameter that defines how long the device transport session will be opened after the last message arrives from the device.
+    # The parameter value is in milliseconds.
     # The last activity time of the device session is updated if the device sends any message, including keepalive messages
     # If there is no activity, the session will be closed, and all subscriptions will be deleted.
-    # We recommend this parameter to be in sync with state.defaultInactivityTimeoutInSec
-    # (current parameter should be equal to or greater than defaultInactivityTimeoutInSec; if not, you can get the situation when the session is closed for the active device).
+    # We recommend this parameter to be in sync with device inactivity timeout ("state.defaultInactivityTimeoutInSec" or DEFAULT_INACTIVITY_TIMEOUT) parameter
+    # which is responsible for detection of the device connectivity status in the core service of the platform.
+    # The value of the session inactivity timeout parameter should be greater or equal to the device inactivity timeout.
+    # Note that the session inactivity timeout is set in milliseconds while device inactivity timeout is in seconds.
     inactivity_timeout: "${TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT:600000}"
     # Interval of periodic check for expired sessions and report of the changes to session last activity time
     report_timeout: "${TB_TRANSPORT_SESSIONS_REPORT_TIMEOUT:3000}"

transport/lwm2m/src/main/resources/tb-lwm2m-transport.yml

@@ -122,11 +122,14 @@ redis:
 # LWM2M server parameters
 transport:
   sessions:
-    # Parameter defines how long the device transport session will be opened after the last activity time.
+    # Session inactivity timeout is a global configuration parameter that defines how long the device transport session will be opened after the last message arrives from the device.
+    # The parameter value is in milliseconds.
     # The last activity time of the device session is updated if the device sends any message, including keepalive messages
     # If there is no activity, the session will be closed, and all subscriptions will be deleted.
-    # We recommend this parameter to be in sync with state.defaultInactivityTimeoutInSec
-    # (current parameter should be equal to or greater than defaultInactivityTimeoutInSec; if not, you can get the situation when the session is closed for the active device).
+    # We recommend this parameter to be in sync with device inactivity timeout ("state.defaultInactivityTimeoutInSec" or DEFAULT_INACTIVITY_TIMEOUT) parameter
+    # which is responsible for detection of the device connectivity status in the core service of the platform.
+    # The value of the session inactivity timeout parameter should be greater or equal to the device inactivity timeout.
+    # Note that the session inactivity timeout is set in milliseconds while device inactivity timeout is in seconds.
     inactivity_timeout: "${TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT:600000}"
     # Interval of periodic check for expired sessions and report of the changes to session last activity time
     report_timeout: "${TB_TRANSPORT_SESSIONS_REPORT_TIMEOUT:3000}"

transport/mqtt/src/main/resources/tb-mqtt-transport.yml

@@ -181,11 +181,14 @@ transport:
       # Skip certificate validity check for client certificates.
       skip_validity_check_for_client_cert: "${MQTT_SSL_SKIP_VALIDITY_CHECK_FOR_CLIENT_CERT:false}"
   sessions:
-    # Parameter defines how long the device transport session will be opened after the last activity time.
+    # Session inactivity timeout is a global configuration parameter that defines how long the device transport session will be opened after the last message arrives from the device.
+    # The parameter value is in milliseconds.
     # The last activity time of the device session is updated if the device sends any message, including keepalive messages
     # If there is no activity, the session will be closed, and all subscriptions will be deleted.
-    # We recommend this parameter to be in sync with state.defaultInactivityTimeoutInSec
-    # (current parameter should be equal to or greater than defaultInactivityTimeoutInSec; if not, you can get the situation when the session is closed for the active device).
+    # We recommend this parameter to be in sync with device inactivity timeout ("state.defaultInactivityTimeoutInSec" or DEFAULT_INACTIVITY_TIMEOUT) parameter
+    # which is responsible for detection of the device connectivity status in the core service of the platform.
+    # The value of the session inactivity timeout parameter should be greater or equal to the device inactivity timeout.
+    # Note that the session inactivity timeout is set in milliseconds while device inactivity timeout is in seconds.
     inactivity_timeout: "${TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT:600000}"
     # Interval of periodic check for expired sessions and report of the changes to session last activity time
     report_timeout: "${TB_TRANSPORT_SESSIONS_REPORT_TIMEOUT:3000}"

transport/snmp/src/main/resources/tb-snmp-transport.yml

@@ -137,11 +137,14 @@ transport:
       # To ignore SNMP response values that do not match the data type of the configured OID mapping (by default false - will throw an error if any value of the response not match configured data types)
       ignore_type_cast_errors: "${SNMP_RESPONSE_IGNORE_TYPE_CAST_ERRORS:false}"
   sessions:
-    # Parameter defines how long the device transport session will be opened after the last activity time.
+    # Session inactivity timeout is a global configuration parameter that defines how long the device transport session will be opened after the last message arrives from the device.
+    # The parameter value is in milliseconds.
     # The last activity time of the device session is updated if the device sends any message, including keepalive messages
     # If there is no activity, the session will be closed, and all subscriptions will be deleted.
-    # We recommend this parameter to be in sync with state.defaultInactivityTimeoutInSec
-    # (current parameter should be equal to or greater than defaultInactivityTimeoutInSec; if not, you can get the situation when the session is closed for the active device).
+    # We recommend this parameter to be in sync with device inactivity timeout ("state.defaultInactivityTimeoutInSec" or DEFAULT_INACTIVITY_TIMEOUT) parameter
+    # which is responsible for detection of the device connectivity status in the core service of the platform.
+    # The value of the session inactivity timeout parameter should be greater or equal to the device inactivity timeout.
+    # Note that the session inactivity timeout is set in milliseconds while device inactivity timeout is in seconds.
     inactivity_timeout: "${TB_TRANSPORT_SESSIONS_INACTIVITY_TIMEOUT:600000}"
     # Interval of periodic check for expired sessions and report of the changes to session last activity time
     report_timeout: "${TB_TRANSPORT_SESSIONS_REPORT_TIMEOUT:3000}"