Global Access Server: Audit Messages
The Axeda and ThingWorx Global Access Servers periodically send status update messages. The GAS audit messages result in updates to the RemoteSession field, but they do not appear in the Audit Subsystem for Axeda GAS 6.9.2 through 6.9.x or ThingWorx GAS 7.0.0 and 7.0.1. The ThingWorx GAS 7.1.0 supports sending its status update messages and the eMessage Connector supports writing these messages to the Audit Subsystem of the ThingWorx Platform. If you require audit messages for GAS, upgrade to ThingWorx GAS 7.1.0 and to Axeda Compatibility Package (ACP) 2.2.0.
When you import the Remote Access Extension, the Remote Access Subsystem is created.. When a session is created using an instance of the ThingWorx GAS 7.1.0, the Remote Access Subsystem generates a ThingWorx audit message. Similarly, when a session is terminated (deleted), this subsystem generates an audit message. These audit messages fall into the RemoteAccess category of audit messages. For information on viewing audit messages, refer to the topic, Searching Audit Data (Queries, Direct Persistence) in the ThingWorx Platform Help Center. For complete details about the Audit Subsystem, refer to the subsection, Audit Subsystem in the ThingWorx Platform 9 help center.
The eMessage Connector processes the following SessionInfoType enumerations and then updates the associated RemoteSession fields:
Record Type Name (id)
Value/Base Type
Associated Remote Session Fields Updated
DEVICE_IP (9)
agent IP (STRING)
RemoteSession.agentIP
USER_IP (15)
user IP (STRING)
RemoteSession.userIP
REMOTE_END (17)
Time that the remote session ended (in milliseconds since 1970 (LONG)
RemoteSession.endTime
DATA_TRANSFERRED (19)
The number of bytes transferred during the remote session (LONG)
Remotesession.bytesTransferred
TERMINATION_CAUSE (23)
The integer that specifies the reason that the session ending (STRING)
RemoteSession.status, set to TERMINATED.
RemoteSession.terminationCause, set to the cause String mapped to termination cause integer
RemoteSession.lastActivityTime , set to the time that the SessionInfo element is received
When any Remote Session fields need to be updated, the UpdateSession service of the Remote Access Subsystem is called. This service persists any Remote Session fields that have changed. When fields change, the Remote Access Subsystem fires the SessionUpdated event to the Thing associated with the remote session.
* 
The RemoteSession.lastActivityTime property of a Thing is updated with each GAS status update and with status updates from the Remote Access Client (RAC). Any update from either GAS or RAC will result in the Remotesession.lastActivityTime property being updated and the session will not time out. "Inactivity" to the ThingWorx Platform means only that the platform has not received a status update from either RAC or GAS. Inactivity does not mean that there are no bytes being transferred.
Supported Termination CausesĀ 
Cause
Source
Description
USER_SHUTDOWN
GAS
Remote session terminated by user.
DEVICE_SHUTDOWN
GAS
Remote session terminated by Axeda agent.
ABANDONED
GAS
Remote session abandoned (client never sent data).
USER_INACTIVE
GAS
Remote session terminated due to client idle timeout.
DEVICE_INACTIVE
GAS
Remote session terminated due to device idle time.
NO_SERVERS
GAS
Remote Access Server (GAS) not found for session.
SESSION_DENIED
GAS
Remote session denied by agent.
NOT_STARTED
GAS
Remote session never fully started.
ERROR_CREATING_REMOTE_SESSION
StartSession workflow
General error creating a remote session on ThingWorx.
ERROR_CREATING_REMOTE_SESSION_INVALID_PARAMS
StartSession workflow
Invalid parameters provided for starting a remote session.
ERROR_UPDATING_REMOTE_SESSION
UpdateSession workflow
General error updating a remote session on ThingWorx.
ERROR_UPDATING_REMOTE_SESSION_INVALID_PARAMS
UpdateSession workflow
Invalid parameters provided for updating a remote session.
ERROR_BUILDING_REMOTE_SESSION_INVALID_PARAMS
StartSession workflow
Error creating the Remote Access Server (GAS) client on ThingWorx.
ERROR_BUILDING_REMOTE_ACCESS_SERVER_CLIENT
StartSession workflow
Error creating the Remote Access Server (GAS) client on ThingWorx Platform.
ERROR_LOADING_REMOTE_ACCESS_MODEL_OJBECT
StartSession workflow
UpdateSession workflow
EndSession workflow
Error loading the Remote Access model object on ThingWorx.
ERROR_STARTING_REMOTE_SESSION
StartSession workflow
Error starting remote session on Remote Access Server (GAS).
ERROR_BUILDING_AGENT_EGRESS
StartSession workflow
Failed to create connect information to send to Axeda agent.
ERROR_AGENT_CONNECT_SESSION
StartSession workflow
Error from Axeda agent attempting to connect to the Remote Access Server (GAS).
Was this helpful?