History

CPAM History tracks detailed information for each session on the CPAM Server. This includes User connection history and the services accessed during each session. For FTP sessions, activities such as file transfers, deletions, and renaming actions are also recorded.

My Activity

The My Activity report lists the sessions you've been connected to. This is a filtered version of the All Activity report, showing only the sessions that involve your User.

NOTE:

For a complete view of all sessions, refer to the All Activity report.

All Activity

To access a full report of all sessions, click on All Activity. This shows the complete session history for all Gatekeepers in your User Group:

Here you can see the complete session list for all users over the last 100 sessions. To view more sessions beyond the last 100, click Next Page.

The following details are provided for each session:

  • Date Created: The date the session began.
  • Duration: The length of time the session was active. If a session is still active, it shows as Active.
  • Owner: The User ID of the person who created the session.
  • Customer Name: The name of the customer for the session.
  • Gatekeeper: The name of the Customer's Gatekeeper (if applicable).
  • Status: The final status of the session.

The table below shows the status values for sessions:

Session Status Description
Active The session is currently active.
Registration This session represents the initial registration of a Gatekeeper.
Idle Timeout The session was closed due to inactivity.
Ended by User The User manually ended the session.
Ended by Customer The Customer manually ended the session.
Forced The session was forcibly terminated, typically due to network issues.
Expired The session ended because the Gatekeeper's access expiration time was reached.
No Status No status could be determined (For example, after a server restart).

Customer and Gatekeeper Activity

  • To view the activity history for all Gatekeepers within a Customer, click View History in Customer View.

  • If you're looking to see the activity history for a specific Gatekeeper, click History in Gatekeeper View.

Session Details

To view session-specific information, including user connection history and service usage, click View. This opens the Session History Details window.

In the Session History Details window, you can see a list of each user who was connected to the session, along with detailed information such as connection time, duration, and status.

NOTE:

For detailed descriptions of each field, see All Activity.

Below is a description of the key fields in the Session Users list:

  • Name: Displays the name of the user connected to the session.
  • Start Time: Shows the date and time when the user connected to the session.
  • End Time: Shows the date and time when the user disconnected from the session.
  • Duration: Indicates how long the user was connected to the session.
  • Status: Indicates the user's connection status.

Status values:

User Status Description
Active User is currently connected to the session.
Disconnected The user manually disconnected from the session.
Session Terminated The session ended while the user was still connected.
Forced The user was forcibly disconnected, likely due to a network closure.
No Status No status could be determined (For example., server restart).

If your CPAM server is integrated with your CRM system, session-specific Connection Form field values are displayed below the Session Users list. These fields are also recorded in Gatekeeper audit reports.

Below the Session Users list, you can find a list of Session Services accessed during the session. For each service, detailed information is provided, including host and port details. Additionally, for FTP, Desktop Sharing, SSH, or Telnet services, more detailed Audit Logs may be available.

Audit Logs

The CPAM Server can be configured to store detailed audit information for certain services including FTP transfers, SSH sessions, Telnet sessions, and Desktop Sharing sessions. When detailed audit information is available for a service usage, a link appears in the Audit Logs column.

If the CPAM Server has been configured to store Desktop Sharing log data then you can convert this data to a playable movie by clicking on Audit Logs. Depending on the service used and server version at the time of the audit, the Movie Options or the RDP converter dialog displays.

  1. Select a file type and click Launch Java Web Start Converter. A file chooser dialog opens.

  2. Navigate to where you want to save the movie then click Save to begin the conversion process.

NOTE:

This client-side conversion can take several minutes for long sessions and is only supported on Windows systems.

If you want the video to play immediately after conversion completes, select Launch video after saving.

  1. Start both or one of the options that you would like to convert.

  2. The button changes to Converting while it converts on the server. This can take several minutes for long sessions.

  3. After completion, you are able to click Download.

  4. The user who launched the process is notified in their browser and by email.

Admin Logs

The Admin Logs section is available only to System Admins. It provides an overview of both system-level messages and higher-level user activity on the CPAM server. By default, messages are listed in descending order by date (most recent first), and have the following properties:

Admin Log Property Description
Time The timestamp when the event or message was generated.
User ID (User Activity only) The User responsible for generating the message (only in User Activity).
Method A noun (For example, DEBUG, INFO, ERROR) for system messages or a verb (For example, CREATE, UPDATE, DELETE) for user activity.
Object Type A tag indicating the type of object or event associated with the message (For example, User, Customer).
Object Key The system-wide unique identifier for the object related to the message.
Extra Info A human-readable note containing further details about the log message.

Above the Admin Log records, you can see a list of available methods to filter the logs.

Use the Methods options to quickly filter the Admin Log records. Click All to clear the filter.

NOTE:

Methods may differ depending on the type of records being displayed.

System messages are generated by the CPAM server itself and are not attributable to any specific user. Therefore, User ID is not present in System Messages. These messages include system logins, login failures, debug information, password resets, and Desktop Sharing video recording management information.

The User Activity section of the Admin Logs helps determine "who's doing what" within the system. While the Activity Reports show the actions taken by users when connected to a Gatekeeper, the User Activity section specifically tracks changes made to system objects like Customers and Gatekeepers.

Audit Reliability

CPAM is generally capable of capturing audit details for every session. However, please be aware that certain factors, such as security settings, service configurations, network issues, or other conditions beyond the control of CPAM, may restrict our ability to provide detailed audit logs for some services.

If you have any questions or concerns regarding audit reliability, please contact the CPAM team for assistance.