Citrix Provisioning Services - How To Gather CDF Traces

book

Article ID: CTX341570

calendar_today

Updated On:

Description

The PVS Problem report is the recommended and default method for collecting CDF AOT traces, as the PVS Problem report gathers CDF AOT traces as well as additional contextual information about the PVS farm.
Other CDF tools and other steps should not be used, unless directed by the Citrix Escalation team.
Beginning with the 1912 LTSR CDF Always on Tracing (AOT) was introduced with the ability to natively maintain persistent rolling CDF trace logs on each PVS Server without the need for additional capture mechanisms. Provisioning services CDF AOT tracing relies on the Citrix Telemetry service, and the Citrix Telemetry service should be enabled and running.


Target Device CDF logging is also captured in PVS server side AOT CDF.
Target device logging can be enabled via the device properties in the console, it requires a target device reboot for logging level change to become effective.
It is recommended that logging is set to its default INFO level unless there is a need to reproduce an issue and capture data at which point DEBUG is ideal. This is because CDF output is still passed over the streamprocess to the server and can effectively increase the amount of traffic between PVS Server and endpoint Target Device.  All Target Device DEBUG output will be found within the CDF traces on the PVS Server to whom they were connected.


Instructions

Using the PVS Problem report:

  1. Ensure Citrix Telemetry service is in a running state on each PVS server.
  2. Reproduce a problem.
  3. In the PVS console right click on the PVS Site and Select Report A Problem
  4. Provide a UNC path which is accessible for all PVS servers.
  5. Provide a summary and click finish.
  6. The PVS problem report will then initiate data collection from each PVS server in the site.
  7. Once complete you can retrieve the problem report and upload it to your case.

 

Manual steps for CDF AOT trace retrieval.

Note: Customers should not use manual steps. The recommended method capture CDF AOT data is using the PVS Problem Report.
These steps should only be used if a PVS problem report is unavailable and the Citrix Escalation engineer has specifically requested data capture manually.

    1. On the PVS server in services.msc restart the Citrix Telemetry service to create a new trace file.
    2. Reproduce the issue.
    3. On the PVS server in services.msc restart the Citrix Telemetry service to flush out any remaining trace files.
    4. Browse to  C:\programdata\Citrix\Provisioning Services\Log\AOT
    5. Zip & upload your data to your case.

 

Issue/Introduction

A PVS Problem report should always be collected when reporting a PVS issue which requires CDF AOT collection.

Other CDF tools should not be used, unless requested by the Citrix Escalation team.

 

Additional Information

Please check the Citrix Provisioning Services product documentation for your version of PVS and for any changes to logging.  The current product documentation outlines some logging basics:

https://docs.citrix.com/en-us/provisioning/current-release/troubleshooting/logging