Performing Diagnostics¶
Each Anyware component creates and updates a log file which records its activity as the system is used. Most troubleshooting within a Anyware system begins by examining these log files and looking for error conditions or other indications that may explain why the system is not operating as expected.
Log files for the Graphics Agent for Linux and other Anyware components are saved to specific directories.
Note: Bundling log files for support
When investigating issues with HP support, you may need to provide a support file which includes system log files. Instructions are provided here.
Locating Agent Log Files¶
Log files for the Anyware agent are located in the following directories by default. If you changed your agent's location during installation, the log files will be in your custom location instead.
Component | Log file location |
---|---|
Agent | /var/log/pcoip-agent/agent.log |
Session Launcher | /var/log/pcoip-agent/session-launcher.log |
Server/User | /var/log/pcoip-agent/server.<user>.log |
Note: Bundling log files for support
When investigating issues with HP support, you may need to provide a support file which includes system log files. Instructions are provided here.
Setting Log Verbosity¶
Each Anyware component generates diagnostic log messages. The default log levels are recommended for use in a production deployment. When troubleshooting a particular problem, Teradici Support Services may recommend adjusting the event log verbosity level to obtain more information from certain parts of the system.
Note: This is a global setting
The pcoip.event_filter_mode
directive is a global setting, and affects the output levels of all Anyware components.
To change the log verbosity level, set the pcoip.event_filter_mode
directive in the pcoip-agent.conf file. See Configuring the Anyware agent for instructions.
Log rotation¶
Log files in Linux agents are managed by logrotate
. To manage how log files are rotated, edit the following files:
- /etc/logrotate.d/pcoip-*
- /usr/share/pcoip-agent/pcoip-server.logrotate
Session Log IDs¶
At the start of each PCoIP session, a unique session ID is generated by the Anyware client and passed to all connected Anyware components (including the Graphics Agent for Linux). Log messages generated by the agent are prefixed with this session ID, making it easy to identify. All log messages generated during a single session, by any Anyware component, will be prefixed with the same session log ID in RFC-4122 format:
yyyy-mm-ddThh:mm:ss.ffffffZ xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx > …
For example:
2015-11-06T08:01:18.688879Z 4208fb66-e22a-11d1-a7d7-00a0c982c00d > …
Log messages that do not pertain to a specific session will show a string of zeroes in place of the session log ID number.
If a Anyware component does not receive a session log ID from the PCoIP client, or receives an invalid value, it will generate a new session log ID and distribute it to the other components in the system.