Cisco Terminal Services (TS) Agent Guide, Version 1.4

View Information About the TS Agent

Updated: February 24, 2026

Want to summarize with AI?

Overview

How to view current user sessions, port assignments, and session details in the TS Agent, monitor session activity, and export troubleshooting data for user management and diagnostics.

Use the following procedure to view the current user sessions on the network and the port ranges assigned to each session. The data is read-only.

Procedure

On the server where you installed the TS Agent, start the TS Agent interface as described in Start the TS Agent Configuration Interface.

Click the Monitor tab. The following columns are displayed:

REST Server ID: Host name or IP address of the Firepower Management Center that is reporting the information. This information is useful if you have a high availability configuration.
Source IP: Displays the user's IP address value in IPv4 and/or IPv6 format. When both IPv4 and IPv6 addresses are configured and a new session is just created, both IPv4 and IPv6 addresses are displayed in separate rows.
Status: Displays the status of assigning ports to the user. For more information, see View Connection Status.
Session ID: Number that identifies the user's session. A user can have more than one session at a time.
Username: Username associated with the session.
Domain: Active Directory domain in which the user logged in.
Port Range: Port range assigned to the user. (A value of 0 indicates an issue assigning ports; for more information, see View Connection Status).
TCP Ports Usage and UDP Ports Usage: Displays the percentage of allocated ports per user. When the percentage exceeds 50%, the field background is yellow. When the percentage exceeds 80%, the field background is red.
Login Date: Date the user logged in.

The following table shows the actions you can perform:

Item	Description
Click column heading	Sort data in the table by that column.
	Enter a portion of a username or a complete username in the Filter by Username search field.
	Click to refresh sessions displayed on this tab page.
	Export the following troubleshooting information about the TS Agent as text files: XML file containing TS Agent configuration data Output from the netstat -a -n -o command Windows task list List of running drivers
	Check the box next to one or more sessions to restream those sessions to the Cloud-Delivered Firewall Management Center or On-Prem Firewall Management Center. You can use this in the event the user service fails on the Cloud-Delivered Firewall Management Center or On-Prem Firewall Management Center. For example, suppose a user logs in to the TS Agent server after the user service fails on the Cloud-Delivered Firewall Management Center or On-Prem Firewall Management Center. You can use this option to send the user session again after the user service is restored. This should cause Success to be displayed for that user in the Status column.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.